VK Cloud logo

JupyterHub инстансын жасау

Мақалада Terraform көмегімен JupyterHub инстансын жасау мысалдары келтірілген.

Инстансты жасау кезінде мыналар пайдаланылады:

Параметрлердің толық сипаттамасы Terraform провайдерінің құжаттамасында берілген.

Инстансты жасамас бұрын

  1. Квоталарды тексеріңіз. Таңдалған аймақта инстансты жасау үшін ресурстар жеткілікті екеніне көз жеткізіңіз. Әртүрлі аймақтар үшін әртүрлі квоталар бапталуы мүмкін.

    Қажет болса, квоталарды арттырыңыз.

  2. Егер бұл әлі жасалмаған болса, Terraform орнатып, ортаны баптаңыз.

  3. vkcs_provider.tf файлында провайдердің 0.6.0 немесе одан жоғары нұсқасы көрсетілгеніне көз жеткізіңіз. Егер провайдер нұсқасы төмен болса, провайдерді жаңартыңыз.

1. JupyterHub инстансының сипаттамасы бар файлды жасаңыз

Төмендегі мысалда инстанс келесі конфигурацияда жасалады:

  • әдепкі аймақ, GZ1 қолжетімділік аймағы;
  • SSD диск түрі;
  • пайдаланушы аты — admin, құпиясөз — Password!;
  • деректер дискісінің түрі SSD, көлемі — 60 және 70 ГБ.

Келесі мазмұндағы main.tf Terraform конфигурация файлын жасаңыз:

resource "vkcs_mlplatform_jupyterhub" "jupyterhub" {  name              = "tf-example"  admin_name        = "admin"  admin_password    = "Password!"  flavor_id         = data.vkcs_compute_flavor.basic.id  availability_zone = "GZ1"  boot_volume = {    volume_type = "ceph-ssd"  }  data_volumes = [    {      size        = 60      volume_type = "ceph-ssd"    },    {      size        = 70      volume_type = "ceph-ssd"    }  ]  networks = [    {      network_id = data.vkcs_networking_network.default.id    },  ]}

Мұнда:

  • admin_password — JupyterHub инстансы әкімшісінің құпиясөзі.

  • flavor_id — ВМ түрінің идентификаторы. Идентификаторды манифесте көрсетуге немесе оны деректер көзінен алуға болады.

  • network_id — инстанс орналастырылатын желінің идентификаторы. Инстансты бар желіде де, жаңа желіде де орналастыруға болады. Идентификаторды манифесте көрсетуге, деректер көзінен немесе ресурстан алуға болады.

2. (Опционалды) ВМ түріне арналған деректер көзінің сипаттамасы бар файлды жасаңыз

Қажетті ВМ түрінің сипаттамасы бар flavor.tf Terraform конфигурация файлын жасаңыз:

data "vkcs_compute_flavor" "basic" {  name = "STD2-4-4"}

Файлда көрсетілген ВМ түрі сіздің Terraform жобаңызда JupyterHub инстансын жасау үшін пайдаланылады.

3. (Опционалды) Инстансқа арналған желілік инфрақұрылымның сипаттамасы бар файлды жасаңыз

Инстансқа арналған желілік инфрақұрылым сипаттамасы бар network.tf Terraform конфигурация файлын жасаңыз:

Жобада бар желіге арналған деректер көзі сипаттамасының мысалы:

data "vkcs_networking_network" "default" {  name = "default"  sdn = "neutron"}

4. Terraform көмегімен қажетті ресурстарды жасаңыз

  1. Terraform конфигурация файлдарын бір директорияға орналастырыңыз:

    • vkcs_provider.tf;
    • main.tf;
    • flavor.tf (егер жасалған болса);
    • network.tf(егер жасалған болса).
  2. Осы директорияға өтіңіз.

  3. Конфигурация файлдарының дұрыс екенін және қажетті өзгерістерді қамтитынын тексеріңіз:

    terraform validate && terraform plan
  4. Өзгерістерді қолданыңыз:

    terraform apply

    Растауды сұрағанда yes енгізіңіз.

  5. Операцияның аяқталуын күтіңіз.

5. Конфигурацияның қолданылуын тексеріңіз

JupyterHub инстансының сәтті жасалғанына көз жеткізіңіз:

  1. VK Cloud жеке кабинетіне өтіңіз.
  2. ML PlatformИнстансы бөліміне өтіңіз. JupyterHub инстансының жасалғанына және белсенді екеніне көз жеткізіңіз.

Пайдаланылмайтын ресурстарды жойыңыз

Егер Terraform көмегімен жасалған ресурстар енді қажет болмаса, оларды жойыңыз:

  1. Конфигурация файлдары бар директорияға өтіңіз.

  2. Келесі команданы орындаңыз:

    terraform destroy

    Растауды сұрағанда yes енгізіңіз.

  3. Операцияның аяқталуын күтіңіз.