Исходный код вики Подключение Terraform к vCD

Версия 18.1 от Ирина Сафонова на 01.05.2023, 01:27
Последние авторы
1 **Содержание**
2
3 {{toc/}}
4
5 == Подготовка файла конфигурации ==
6
7 ----
8
9 Для подготовки конфигурационного файла:
10
11 1. Создайте конфигурационный файл {{code language="none"}}main.tf{{/code}}и файл с переменными{{code language="none"}}variables.tf{{/code}}.
12 2. Перейдите по ссылкам ниже и скопируйте поддерживаемый **provider** в файл конфигурации {{code language="none"}}main.tf{{/code}}.
13
14 {{info}}
15 Для Cloud Director 10.2 максимально поддерживаемая версия провайдера 3.7.0, для Cloud Director 10.3 максимальная поддерживаемая версия 3.9.0.
16 Провайдер 3.7.0 https://registry.terraform.io/providers/vmware/vcd/3.7.0/docs
17 Провайдер 3.9.0 https://registry.terraform.io/providers/vmware/vcd/latest/docs
18 {{/info}}
19
20 [[image:Рисунок1.png]]
21
22 3. Инициализируйте Terraform в папке с конфигурационным файлом {{code language="none"}}main.tf{{/code}}.
23
24 {{info}}
25 Команда {{code language="none"}}terraform init{{/code}} используется для инициализации рабочего каталога Terraform. При введении команды она автоматически загрузит и установит все необходимые провайдеры и плагины Terraform.
26 {{/info}}
27
28 [[image:Рисунок2.png]]
29
30 4. Для обновления версии провайдера измените версию в файле {{code language="none"}}main.tf{{/code}} и введите команду {{code language="none"}}terraform init -upgrade{{/code}}.
31
32 [[image:Рисунок3.png]]
33
34 5. Проверьте версию Terraform и установленного провайдера при помощи команды {{code language="none"}}terraform -version{{/code}}.
35
36 [[image:Рисунок5.png]]
37
38 == Подключение к Cloud Director ==
39
40 ----
41
42 ~1. Заполните файл {{code language="none"}}main.tf{{/code}} данными.
43
44 {{code language="none"}}
45 provider "vcd" {
46 user = var.vcd_user
47 password = var.vcd_pass
48 auth_type = "integrated"
49 org = var.vcd_org
50 url = var.vcd_url
51 max_retry_timeout = var.vcd_max_retry_timeout
52 allow_unverified_ssl = var.vcd_allow_unverified_ssl
53 }
54
55 {{/code}}
56
57 2. Заполните {{code language="none"}}variables.tf{{/code}} данными:
58
59 * Используется логин для авторизации в Cloud Director.
60
61 {{code language="none"}}
62 variable "vcd_user" {
63 default = "my-terraform"
64 description = "Cloud Director tenant user"
65 }
66
67 {{/code}}
68
69 * Используется пароль для авторизации в Cloud Director.
70
71 {{code language="none"}}
72 variable "vcd_pass" {
73 default = "my-password"
74 description = " Cloud Director tenant password"
75 }
76
77 {{/code}}
78
79 * Используется название Tenant Cloud Director
80
81 {{code language="none"}}
82 variable "vcd_org" {
83 default = "DataFort "
84 description = "Name tenant"
85 }
86
87 {{/code}}
88
89 * Используется название Virtual Data Center.
90
91 {{code language="none"}}
92 variable "vcd_vdc" {
93 default = "MY-VDC "
94 description = "Name Virtual Data Center"
95 }
96
97 {{/code}}
98
99 * Используется ссылка на подключение.
100
101 {{code language="none"}}
102 variable "vcd_url" {
103 default = " https://cloud3.datafort.ru/api"
104 description = "Cloud Director URL API"
105 }
106 variable "vcd_max_retry_timeout" {
107 default = "60"
108 }
109 variable "vcd_allow_unverified_ssl" {
110 default = "true"
111 description = "Disable SSL certificate"
112 }
113
114 {{/code}}
115
116 === Основные команды ===
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}} – обновление состояния с локальным файлом и состоянием реальных ресурсов.
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 * [[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.
273 * [[https:~~/~~/developer.hashicorp.com/terraform/downloads>>url:https://developer.hashicorp.com/terraform/downloads]] — ссылка на скачивание Terraform.