Terraform-манифестін жергілікті тестілеуBeta
Image-based қосымшаңыз үшін бұлттық инфрақұрылымды сипаттайтын Terraform манифесін және оның орналастыру ретін жергілікті түрде тексеру үшін:
-
Желі мен подсетті дайындаңыз: бар желілердің подсеттерін пайдаланыңыз немесе жаңа желі жасап, оның подсетін пайдаланыңыз.
-
Terraform-ды жергілікті түрде орнатыңыз:
- Terraform-ды VK Cloud ресми зеркаласынан жүктеңіз.
- Архивті тарқатып,
Pathорта айнымалысында тарқатылған файлға жолды көрсетіңіз. - Terraform сәтті орнатылғанын тексеру үшін
terraform -helpкомандасын орындаңыз.
-
API арқылы қолжетімділікті қосыңыз.
-
Terraform үшін CLI конфигурациясы файлын өңдеңіз: Windows үшін —
terraform.rc, басқа ОС үшін —.terraformrc.-
Terraform-дың зеркалалармен және жергілікті провайдерлермен бір мезгілде жұмыс істеуі үшін келесі ақпаратты қосыңыз:
provider_installation {filesystem_mirror {# Полный путь до директории pluginspath = "/home/user_name/.terraform.d/plugins"include = ["vk-cs.local/*/*", "ivk-cs.local/*/*"]}network_mirror {url = "https://terraform-mirror.mcs.mail.ru"include = ["registry.terraform.io/*/*"]}direct {exclude = ["registry.terraform.io/*/*", "vk-cs.local/*/*", "ivk-cs.local/*/*"]}} -
Terraform-дың зеркалалармен және жергілікті провайдерлермен бір мезгілде жұмыс істеуі қажет болмаса, файлдың мазмұнын тазалаңыз.
-
Егер мұндай файл жергілікті компьютер жоқ болса, бұл қадамды өткізіп жіберіңіз.
Толығырақ — Terraform ресми құжаттамасында.
-
-
VK CS провайдер плагинін GitHub сайтынан жүктеңіз.
-
iVK CS провайдер плагинін алу үшін marketplace@cloud.vk.com мекенжайына хат жіберіңіз. Хатта манифесті жергілікті түрде тестілейтін компьютердің ОС-ын және ОС архитектурасын көрсетіңіз. Мысал: amd64 архитектурасындағы Linux.
-
Егер Terraform үшін CLI конфигурациясы файлы жергілікті компьютерде жоқ болса немесе ол тазартылған болса, Null провайдер плагинін Terraform ресми сайтынан жүктеңіз.
-
terraform.dдиректориясындаpluginsдиректориясын жасаңыз.terraform.dдиректориясы Terraform орнатылғаннан кейін компьютерде автоматты түрде жасалады, оның жолы ОС-қа байланысты. Толығырақ — Terraform ресми құжаттамасында. -
pluginsдиректориясында келесі директориялар құрылымын жасаңыз:├── ivk-cs.local│ └── ivk-cs│ └── ivkcs│ └── <ВЕРСИЯ_ПЛАГИНА>│ └── <ОС>├── registry.terraform.io│ └── hashicorp│ └── null│ └── <ВЕРСИЯ_ПЛАГИНА>│ └── <ОС>└── vk-cs.local└── vk-cs└── vkcs└── <ВЕРСИЯ_ПЛАГИНА>└── <ОС>Мұнда:
-
<ВЕРСИЯ_ПЛАГИНА>— провайдер плагиннің нұсқасы. Мән плагин файлының атынан анықталады. Мысалы,terraform-provider-vkcs_0.4.2плагині үшін нұсқа0.4.2тең,terraform-provider-null_v3.2.1_x5плагині үшін —3.2.1. -
<ОС>— компьютер ОС-ы. Мәнді анықтау үшінterraform --versionкомандасын орындаңыз. Команда шығысында Terraform-дың ағымдағы нұсқасы және архитектурасы бар ОС атауы көрсетіледі.Команда жауабының мысалы:
Terraform v1.5.4on linux_amd64Осы мысалда
<ОС>мәніlinux_amd64тең.
-
-
Жүктелген провайдер плагиндерін сәйкес
<ОС>директорияларына орналастырыңыз.amd64 архитектурасындағы Linux ОС үшін
/home/user_name/.terraform.d/pluginsдиректориясының құрылымының мысалы:/home/user_name/.terraform.d│└── plugins├── ivk-cs.local│ └── ivk-cs│ └── ivkcs│ └── 0.0.4│ └── linux_amd64│ └── terraform-provider-ivkcs_0.0.4├── registry.terraform.io│ └── hashicorp│ └── null│ └── 3.2.1│ └── linux_amd64│ └── terraform-provider-null_v3.2.1└── vk-cs.local└── vk-cs└── vkcs└── 0.4.2└── linux_amd64└── terraform-provider-vkcs_0.4.2 -
Манифесті тестілеу үшін жұмыс директориясын жасаңыз.
-
Жұмыс директориясында
auth.tfфайлын жасаңыз. -
auth.tfфайлында пайдаланылатын провайдерлерді сипаттаңыз.-
VK CS және iVK CS провайдерлерін көрсетіңіз. Егер Terraform үшін CLI конфигурациясы файлы жергілікті компьютерде жоқ болса немесе ол тазартылған болса, қосымша Null провайдерін көрсетіңіз.
terraform {required_providers {vkcs = {# Путь к локальному плагину провайдера. Указывается часть пути после terraform.d/pluginssource = "vk-cs.local/vk-cs/vkcs"# Версия провайдераversion = "0.2.2"}ivkcs = {source = "ivk-cs.local/ivk-cs/ivkcs"version = "0.1.15"}null = {source = "registry.terraform.io/hashicorp/null"version = "3.2.1"}}} -
VK CS және iVK CS провайдерлері үшін манифесті тестілейтін VK Cloud аккаунты мен жобасы туралы ақпаратты көрсетіңіз:
provider "vkcs" {# User Domain IDuser_domain_name = "users"username = "<ИМЯ_ПОЛЬЗОВАТЕЛЯ>"password = "<ПАРОЛЬ>"project_id = "<ИДЕНТИФИКАТОР_ПРОЕКТА>"# Region Nameregion = "RegionOne"}provider "ivkcs" {# URL компонента Keystone платформы VK Cloudauth_url = "https://cloud.vk.ru/infra/identity/v3/"user_domain_name = "users"username = "<ИМЯ_ПОЛЬЗОВАТЕЛЯ>"password = "<ПАРОЛЬ>"project_id = "<ИДЕНТИФИКАТОР_ПРОЕКТА>"region = "RegionOne"# URL сервиса Infra APIinfra_url = "https://cloud.vk.ru/marketplace/api/infra-api/api/v1/"}Мұнда:
<ИДЕНТИФИКАТОР_ПРОЕКТА>— дайындық кезеңінде хатта көрсеткен жоба идентификаторы (Project ID).<ИМЯ_ПОЛЬЗОВАТЕЛЯ>— осы VK Cloud жобасының пайдаланушы аты.<ПАРОЛЬ>— пайдаланушы құпиясөзі.
-
-
plans/<ИМЯ_ПЛАНА>/deployment/deploy.tfфайлын жұмыс директориясына көшіріңіз. -
Егер жергілікті тестілеу үшін
deploy.tfманифесінде сипатталмаған қосымша нысандар жасау қажет болса (мысалы, сыртқы IP бар ВМ):- Жұмыс директориясында
extended.tfфайлын жасаңыз. extended.tfфайлында провайдерлердің ресурстары мен деректер көздерін пайдалана отырып, қосымша нысандарды сипаттаңыз.
- Жұмыс директориясында
-
Провайдерлерді инициализациялау үшін жұмыс директориясында
terraform initкомандасын орындаңыз. -
deploy.tfжәнеextended.tfфайлдарында сипатталған ресурстарды жасауды бастау үшін жұмыс директориясындаterraform applyкомандасын орындаңыз. -
Ресурстарды жасауды растау үшін
yesенгізіңіз. -
Манифестердің орындалуы аяқталғаннан кейін VK Cloud жеке кабинетіне кіріп, ресурстар жасалғанына көз жеткізіңіз.