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

Редактировал(а) Ирина Сафонова 18.03.2024, 22:31
От версии 7.1
отредактировано Ирина Сафонова
на 01.05.2023, 00:59
Изменить комментарий: К данной версии нет комментариев
К версии 22.1
отредактировано Ирина Сафонова
на 01.05.2023, 16:58
Изменить комментарий: К данной версии нет комментариев

Сводка

Подробности

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