Изменения документа 08. Подключение Terraform к VCD

Редактировал(а) Ирина Сафонова 18.03.2024, 22:31
От версии 13.1
отредактировано Ирина Сафонова
на 01.05.2023, 01:08
Изменить комментарий: К данной версии нет комментариев
К версии 29.1
отредактировано Ирина Сафонова
на 01.05.2023, 17:11
Изменить комментарий: К данной версии нет комментариев

Сводка

Подробности

Свойства страницы
Теги
... ... @@ -1,0 +1,1 @@
1 +Terraform
Содержимое
... ... @@ -6,10 +6,10 @@
6 6  
7 7  ----
8 8  
9 -Для подготовки:
9 +Для подготовки конфигурационного файла:
10 10  
11 -1. Создайте конфигурационный файл main.tf и файл с переменными{{code language="none"}}variables.tf{{/code}}.
12 -2. Перейдите по ссылкам ниже и скопируйте поддерживаемый provider в файл конфигурации {{code language="none"}}main.tf{{/code}}.
11 +~1. Создайте конфигурационный файл {{code language="none"}}main.tf{{/code}}и файл с переменными{{code language="none"}}variables.tf{{/code}}.
12 +2. Перейдите по ссылкам ниже и скопируйте поддерживаемый **provider** в файл конфигурации {{code language="none"}}main.tf{{/code}}.
13 13  
14 14  {{info}}
15 15  Для Cloud Director 10.2 максимально поддерживаемая версия провайдера 3.7.0, для Cloud Director 10.3 максимальная поддерживаемая версия 3.9.0.
... ... @@ -19,7 +19,7 @@
19 19  
20 20  [[image:Рисунок1.png]]
21 21  
22 -3. Инициализируйте Terraform в папке с конфигурационным файлом main.tf.
22 +3. Инициализируйте Terraform в папке с конфигурационным файлом {{code language="none"}}main.tf{{/code}}.
23 23  
24 24  {{info}}
25 25  Команда {{code language="none"}}terraform init{{/code}} используется для инициализации рабочего каталога Terraform. При введении команды она автоматически загрузит и установит все необходимые провайдеры и плагины Terraform.
... ... @@ -27,7 +27,7 @@
27 27  
28 28  [[image:Рисунок2.png]]
29 29  
30 -4. Для обновления версии провайдера измените версию в файле main.tf и введите команду {{code language="none"}}terraform init -upgrade{{/code}}.
30 +4. Для обновления версии провайдера измените версию в файле {{code language="none"}}main.tf{{/code}} и введите команду {{code language="none"}}terraform init -upgrade{{/code}}.
31 31  
32 32  [[image:Рисунок3.png]]
33 33  
... ... @@ -39,6 +39,8 @@
39 39  
40 40  ----
41 41  
42 +Для подключения:
43 +
42 42  ~1. Заполните файл {{code language="none"}}main.tf{{/code}} данными.
43 43  
44 44  {{code language="none"}}
... ... @@ -115,10 +115,161 @@
115 115  
116 116  === Основные команды ===
117 117  
118 -* {{code language="none"}}terraform -help{{/code}} – вывод справок.
119 -* {{code language="none"}}terraform -version{{/code}} – вывод версии Terraform и установленных провайдеров.
120 -* {{code language="none"}}terraform init{{/code}} – инициализация каталога Terraform.
121 -* {{code language="none"}}terraform plan{{/code}} – генерация файла изменений и вывод изменений в инфраструктуре.
122 -* {{code language="none"}}terraform apply{{/code}} – применение изменений конфигурации, изначально выводит список изменений и/или добавлений в инфраструктуру.
123 -* {{code language="none"}}terraform destroy{{/code}} – удаление инфраструктуры.
124 -* {{code language="none"}}terraform refresh{{/code}} – обновление состояния с локальным файлом и состоянием реальных ресурсов.
120 +(% class="table-bordered" style="width:544.818px" %)
121 +(% style="background-color:#d3d3d3; text-align:center" %)|(% style="width:228px" %)**Команда**|(% style="width:315px" %)**Комментарий**
122 +|(% style="width:228px" %){{code language="none"}}terraform -help{{/code}}|(% style="width:315px" %)Вывод справок.
123 +|(% style="width:228px" %){{code language="none"}}terraform -version{{/code}}|(% style="width:315px" %)Вывод версии Terraform и установленных провайдеров.
124 +|(% style="width:228px" %){{code language="none"}}terraform init{{/code}}|(% style="width:315px" %)Инициализация каталога Terraform.
125 +|(% style="width:228px" %){{code language="none"}}terraform plan{{/code}}|(% style="width:315px" %)Генерация файла изменений и вывод изменений в инфраструктуре.
126 +|(% style="width:228px" %){{code language="none"}}terraform apply{{/code}}|(% style="width:315px" %)Применение изменений конфигурации, изначально выводит список изменений и/или добавлений в инфраструктуру.
127 +|(% style="width:228px" %){{code language="none"}}terraform destroy{{/code}}|(% style="width:315px" %)Удаление инфраструктуры.
128 +|(% style="width:228px" %){{code language="none"}}terraform refresh{{/code}}|(% style="width:315px" %)Обновление состояния с локальным файлом и состоянием реальных ресурсов.
129 +
130 +(% style="color:inherit; font-family:inherit; font-size:26px" %)Пример настройки
131 +
132 +----
133 +
134 +В примере создается **vApp**, в него помещается виртуальная машина и подключается к существующей сети. В файле {{code language="none"}}main.tf{{/code}}:
135 +
136 +1. Укажите провайдер поддерживаемой версии Cloud Director.
137 +
138 +{{code language="none"}}
139 +terraform {
140 + required_providers {
141 + vcd = {
142 + source = "vmware/vcd"
143 + version = "3.7.0"
144 + }
145 + }
146 +}
147 +
148 +{{/code}}
149 +
150 +2. Подключитесь к **Tenant**.
151 +
152 +{{code language="none"}}
153 +provider "vcd" {
154 + user = var.vcd_user
155 + password = var.vcd_pass
156 + auth_type = "integrated"
157 + org = var.vcd_org
158 + vdc = var.vcd_vdc
159 + url = var.vcd_url
160 + max_retry_timeout = var.vcd_max_retry_timeout
161 + allow_unverified_ssl = var.vcd_allow_unverified_ssl
162 +}
163 +
164 +{{/code}}
165 +
166 +3. Создайте **vApp**.
167 +
168 +{{code language="none"}}
169 +resource "vcd_vapp" "vapp1" {
170 + name = "my-first-vapp"
171 + vdc = var.vcd_vdc
172 + org = var.vcd_org
173 +}
174 +
175 +{{/code}}
176 +
177 +4. Подключитесь в ручную созданную сеть **network** к **vApp** **my-first-vapp**.
178 +
179 +{{code language="none"}}
180 +resource "vcd_vapp_org_network" "is-net" {
181 + vapp_name = "my-first-vapp"
182 + vdc = var.vcd_vdc
183 + org_network_name = "network"
184 + depends_on = [vcd_vapp.vapp1]
185 +}
186 +
187 +{{/code}}
188 +
189 +5. Создайте виртуальную машину (ВМ) из шаблона в **vApp my-first-vapp** и включите кастомизацию ВМ с подключением сети **network**.
190 +
191 +{{code language="none"}}
192 +resource "vcd_vapp_vm" "vm1" {
193 + vapp_name = vcd_vapp.vapp1.name
194 + name = "my-first-vm"
195 + computer_name = "myvm"
196 + cpus = 4
197 + cpu_cores = 2
198 + memory = 4096
199 + org = var.vcd_org
200 + vdc = var.vcd_vdc
201 + storage_profile = var.storage_br
202 + os_type = "windows9Server64Guest"
203 + catalog_name = var.catalog_name_templates
204 + template_name = var.name_templates
205 + depends_on = [vcd_vapp.vapp1, vcd_vapp_org_network.is-net]
206 + customization {
207 + enabled = true
208 + force = true
209 + change_sid = true
210 + allow_local_admin_password = true
211 + auto_generate_password = false
212 + admin_password = "my-secure-password"
213 + }
214 +
215 + network {
216 + adapter_type = "VMXNET3"
217 + connected = true
218 + ip_allocation_mode = "POOL"
219 + is_primary = true
220 + name = "network"
221 + type = "org"
222 + }
223 +}
224 +
225 +{{/code}}
226 +
227 +Файл {{code language="none"}}variables.tf{{/code}}.
228 +
229 +{{code language="none"}}
230 +variable "vcd_user" {
231 + default = "my-terraform"
232 + description = "Cloud Director tenant user"
233 +}
234 +variable "vcd_pass" {
235 + default = "my-password"
236 + description = "Cloud Director tenant password"
237 +}
238 +variable "vcd_org" {
239 + default = "DataFort"
240 + description = "Tenant name"
241 +}
242 +variable "vcd_vdc" {
243 + default = "MY-VDC"
244 + description = "Name VDC"
245 +}
246 +variable "vcd_url" {
247 + default = "https://cloud3.datafort.ru/api"
248 + description = "URL Cloud Director API"
249 +}
250 +variable "vcd_max_retry_timeout" {
251 + default = "60"
252 +}
253 +variable "vcd_allow_unverified_ssl" {
254 + default = "true"
255 + description = "Disable SSL certificate"
256 +}
257 +variable "storage_br" {
258 + default = "HP3.1-VCD-Templates-Bronze-6"
259 +}
260 +variable "catalog_name_templates" {
261 + default = "Windows"
262 + description = "Name catalog templates"
263 +}
264 +variable "name_templates" {
265 + default = "Win2016_DE_RUS DC3 vCD_tmp"
266 + description = "Name templates"
267 +}
268 +
269 +{{/code}}
270 +
271 +== Ссылки на документацию ==
272 +
273 +----
274 +
275 +* [[https:~~/~~/registry.terraform.io/providers/vmware/vcd/latest/docs/resources/vapp_vm>>url:https://registry.terraform.io/providers/vmware/vcd/latest/docs/resources/vapp_vm]]  — конфигурация виртуальных машин и список используемых типов операционных систем.
276 +* [[https:~~/~~/registry.terraform.io/providers/vmware/vcd/3.7.0/docs>>url:https://registry.terraform.io/providers/vmware/vcd/3.7.0/docs]] — перечисленные ресурсы для [[Cloud Director>>https://wiki.dfcloud.ru/bin/view/%D0%9F%D0%BE%D0%B4%D0%BA%D0%BB%D1%8E%D1%87%D0%B5%D0%BD%D0%B8%D0%B5%20Terraform%20%D0%BA%20vCD/#H41F43E43443A43B44E44743543D43843543ACloudDirector]].
277 +* [[https:~~/~~/developer.hashicorp.com/terraform/downloads>>url:https://developer.hashicorp.com/terraform/downloads]] — ссылка на скачивание Terraform.