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

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

Сводка

Подробности

Свойства страницы
Теги
... ... @@ -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.
... ... @@ -17,27 +17,30 @@
17 17  Провайдер 3.9.0 https://registry.terraform.io/providers/vmware/vcd/latest/docs
18 18  {{/info}}
19 19  
20 -[[image:__fileCreatedFromDataURI__.png]]
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.
26 26  {{/info}}
27 27  
28 -[[image:__fileCreatedFromDataURI__.png]]
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 -[[image:__fileCreatedFromDataURI__.png]]
32 +[[image:Рисунок3.png]]
33 33  
34 -5. Проверьте версию Terraform и установленного провайдера при помощи команды {{code language="none"}}terraform -version{{/code}}//.//
35 -[[image:__fileCreatedFromDataURI__.png]]
34 +5. Проверьте версию Terraform и установленного провайдера при помощи команды {{code language="none"}}terraform -version{{/code}}.
36 36  
36 +[[image:Рисунок5.png]]
37 +
37 37  == Подключение к Cloud Director ==
38 38  
39 39  ----
40 40  
42 +Для подключения:
43 +
41 41  ~1. Заполните файл {{code language="none"}}main.tf{{/code}} данными.
42 42  
43 43  {{code language="none"}}
... ... @@ -114,6 +114,18 @@
114 114  
115 115  === Основные команды ===
116 116  
120 +
121 +
122 +(% style="width:544.818px" %)
123 +|(% style="width:228px" %)Команда|(% style="width:315px" %)Комментарий
124 +|(% style="width:228px" %) |(% style="width:315px" %)
125 +|(% style="width:228px" %) |(% style="width:315px" %)
126 +|(% style="width:228px" %) |(% style="width:315px" %)
127 +|(% style="width:228px" %) |(% style="width:315px" %)
128 +|(% style="width:228px" %) |(% style="width:315px" %)
129 +|(% style="width:228px" %) |(% style="width:315px" %)
130 +|(% style="width:228px" %) |(% style="width:315px" %)
131 +
117 117  * {{code language="none"}}terraform -help{{/code}} – вывод справок.
118 118  * {{code language="none"}}terraform -version{{/code}} – вывод версии Terraform и установленных провайдеров.
119 119  * {{code language="none"}}terraform init{{/code}} – инициализация каталога Terraform.
... ... @@ -121,3 +121,152 @@
121 121  * {{code language="none"}}terraform apply{{/code}} – применение изменений конфигурации, изначально выводит список изменений и/или добавлений в инфраструктуру.
122 122  * {{code language="none"}}terraform destroy{{/code}} – удаление инфраструктуры.
123 123  * {{code language="none"}}terraform refresh{{/code}} – обновление состояния с локальным файлом и состоянием реальных ресурсов.
139 +
140 +== Пример настройки ==
141 +
142 +----
143 +
144 +В примере создается **vApp**, в него помещается виртуальная машина и подключается к существующей сети. В файле {{code language="none"}}main.tf{{/code}}:
145 +
146 +1. Укажите провайдер поддерживаемой версии Cloud Director.
147 +
148 +{{code language="none"}}
149 +terraform {
150 + required_providers {
151 + vcd = {
152 + source = "vmware/vcd"
153 + version = "3.7.0"
154 + }
155 + }
156 +}
157 +
158 +{{/code}}
159 +
160 +2. Подключитесь к **Tenant**.
161 +
162 +{{code language="none"}}
163 +provider "vcd" {
164 + user = var.vcd_user
165 + password = var.vcd_pass
166 + auth_type = "integrated"
167 + org = var.vcd_org
168 + vdc = var.vcd_vdc
169 + url = var.vcd_url
170 + max_retry_timeout = var.vcd_max_retry_timeout
171 + allow_unverified_ssl = var.vcd_allow_unverified_ssl
172 +}
173 +
174 +{{/code}}
175 +
176 +3. Создайте **vApp**.
177 +
178 +{{code language="none"}}
179 +resource "vcd_vapp" "vapp1" {
180 + name = "my-first-vapp"
181 + vdc = var.vcd_vdc
182 + org = var.vcd_org
183 +}
184 +
185 +{{/code}}
186 +
187 +4. Подключитесь в ручную созданную сеть **network** к **vApp** **my-first-vapp**.
188 +
189 +{{code language="none"}}
190 +resource "vcd_vapp_org_network" "is-net" {
191 + vapp_name = "my-first-vapp"
192 + vdc = var.vcd_vdc
193 + org_network_name = "network"
194 + depends_on = [vcd_vapp.vapp1]
195 +}
196 +
197 +{{/code}}
198 +
199 +5. Создайте виртуальную машину (ВМ) из шаблона в **vApp my-first-vapp** и включите кастомизацию ВМ с подключением сети **network**.
200 +
201 +{{code language="none"}}
202 +resource "vcd_vapp_vm" "vm1" {
203 + vapp_name = vcd_vapp.vapp1.name
204 + name = "my-first-vm"
205 + computer_name = "myvm"
206 + cpus = 4
207 + cpu_cores = 2
208 + memory = 4096
209 + org = var.vcd_org
210 + vdc = var.vcd_vdc
211 + storage_profile = var.storage_br
212 + os_type = "windows9Server64Guest"
213 + catalog_name = var.catalog_name_templates
214 + template_name = var.name_templates
215 + depends_on = [vcd_vapp.vapp1, vcd_vapp_org_network.is-net]
216 + customization {
217 + enabled = true
218 + force = true
219 + change_sid = true
220 + allow_local_admin_password = true
221 + auto_generate_password = false
222 + admin_password = "my-secure-password"
223 + }
224 +
225 + network {
226 + adapter_type = "VMXNET3"
227 + connected = true
228 + ip_allocation_mode = "POOL"
229 + is_primary = true
230 + name = "network"
231 + type = "org"
232 + }
233 +}
234 +
235 +{{/code}}
236 +
237 +Файл {{code language="none"}}variables.tf{{/code}}.
238 +
239 +{{code language="none"}}
240 +variable "vcd_user" {
241 + default = "my-terraform"
242 + description = "Cloud Director tenant user"
243 +}
244 +variable "vcd_pass" {
245 + default = "my-password"
246 + description = "Cloud Director tenant password"
247 +}
248 +variable "vcd_org" {
249 + default = "DataFort"
250 + description = "Tenant name"
251 +}
252 +variable "vcd_vdc" {
253 + default = "MY-VDC"
254 + description = "Name VDC"
255 +}
256 +variable "vcd_url" {
257 + default = "https://cloud3.datafort.ru/api"
258 + description = "URL Cloud Director API"
259 +}
260 +variable "vcd_max_retry_timeout" {
261 + default = "60"
262 +}
263 +variable "vcd_allow_unverified_ssl" {
264 + default = "true"
265 + description = "Disable SSL certificate"
266 +}
267 +variable "storage_br" {
268 + default = "HP3.1-VCD-Templates-Bronze-6"
269 +}
270 +variable "catalog_name_templates" {
271 + default = "Windows"
272 + description = "Name catalog templates"
273 +}
274 +variable "name_templates" {
275 + default = "Win2016_DE_RUS DC3 vCD_tmp"
276 + description = "Name templates"
277 +}
278 +
279 +{{/code}}
280 +
281 +== Ссылки на документацию ==
282 +
283 +----
284 +
285 +* [[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]]  — конфигурация виртуальных машин и список используемых типов операционных систем.
286 +* [[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]].
287 +* [[https:~~/~~/developer.hashicorp.com/terraform/downloads>>url:https://developer.hashicorp.com/terraform/downloads]] — ссылка на скачивание Terraform.
__fileCreatedFromDataURI__.png
Размер
... ... @@ -1,1 +1,1 @@
1 -110.9 KB
1 +57.3 KB
Содержимое
Рисунок1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ISafonova
Размер
... ... @@ -1,0 +1,1 @@
1 +54.7 KB
Содержимое
Рисунок2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ISafonova
Размер
... ... @@ -1,0 +1,1 @@
1 +123.7 KB
Содержимое
Рисунок3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ISafonova
Размер
... ... @@ -1,0 +1,1 @@
1 +119.1 KB
Содержимое
Рисунок5.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ISafonova
Размер
... ... @@ -1,0 +1,1 @@
1 +14.2 KB
Содержимое