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

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

Сводка

Подробности

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