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

Версия 22.1 от Ирина Сафонова на 01.05.2023, 16:58
Скрыть последних авторов
Ирина Сафонова 9.1 1 **Содержание**
Ирина Сафонова 8.1 2
Ирина Сафонова 7.1 3 {{toc/}}
Ирина Сафонова 1.1 4
5 == Подготовка файла конфигурации ==
6
7 ----
8
Ирина Сафонова 15.1 9 Для подготовки конфигурационного файла:
Ирина Сафонова 1.1 10
Ирина Сафонова 15.1 11 1. Создайте конфигурационный файл {{code language="none"}}main.tf{{/code}}и файл с переменными{{code language="none"}}variables.tf{{/code}}.
Ирина Сафонова 16.1 12 2. Перейдите по ссылкам ниже и скопируйте поддерживаемый **provider** в файл конфигурации {{code language="none"}}main.tf{{/code}}.
Ирина Сафонова 1.1 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
Ирина Сафонова 13.1 20 [[image:Рисунок1.png]]
Ирина Сафонова 11.2 21
Ирина Сафонова 15.1 22 3. Инициализируйте Terraform в папке с конфигурационным файлом {{code language="none"}}main.tf{{/code}}.
Ирина Сафонова 1.1 23
Ирина Сафонова 21.1 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
Ирина Сафонова 1.1 29 {{info}}
30 Команда {{code language="none"}}terraform init{{/code}} используется для инициализации рабочего каталога Terraform. При введении команды она автоматически загрузит и установит все необходимые провайдеры и плагины Terraform.
31 {{/info}}
32
Ирина Сафонова 13.1 33 [[image:Рисунок2.png]]
Ирина Сафонова 1.1 34
Ирина Сафонова 15.1 35 4. Для обновления версии провайдера измените версию в файле {{code language="none"}}main.tf{{/code}} и введите команду {{code language="none"}}terraform init -upgrade{{/code}}.
Ирина Сафонова 1.2 36
Ирина Сафонова 13.1 37 [[image:Рисунок3.png]]
Ирина Сафонова 1.3 38
Ирина Сафонова 11.5 39 5. Проверьте версию Terraform и установленного провайдера при помощи команды {{code language="none"}}terraform -version{{/code}}.
Ирина Сафонова 2.1 40
Ирина Сафонова 13.1 41 [[image:Рисунок5.png]]
Ирина Сафонова 11.5 42
Ирина Сафонова 2.1 43 == Подключение к Cloud Director ==
44
45 ----
46
Ирина Сафонова 19.1 47 Для подключения:
48
Ирина Сафонова 2.1 49 ~1. Заполните файл {{code language="none"}}main.tf{{/code}} данными.
Ирина Сафонова 3.1 50
51 {{code language="none"}}
52 provider "vcd" {
Ирина Сафонова 2.1 53 user = var.vcd_user
54 password = var.vcd_pass
55 auth_type = "integrated"
56 org = var.vcd_org
57 url = var.vcd_url
58 max_retry_timeout = var.vcd_max_retry_timeout
59 allow_unverified_ssl = var.vcd_allow_unverified_ssl
60 }
Ирина Сафонова 3.1 61
Ирина Сафонова 2.1 62 {{/code}}
63
Ирина Сафонова 3.1 64 2. Заполните {{code language="none"}}variables.tf{{/code}} данными:
65
Ирина Сафонова 4.1 66 * Используется логин для авторизации в Cloud Director.
Ирина Сафонова 3.1 67
68 {{code language="none"}}
69 variable "vcd_user" {
70 default = "my-terraform"
71 description = "Cloud Director tenant user"
72 }
73
74 {{/code}}
75
Ирина Сафонова 4.1 76 * Используется пароль для авторизации в Cloud Director.
Ирина Сафонова 3.1 77
78 {{code language="none"}}
79 variable "vcd_pass" {
80 default = "my-password"
81 description = " Cloud Director tenant password"
82 }
83
84 {{/code}}
85
86 * Используется название Tenant Cloud Director
87
88 {{code language="none"}}
89 variable "vcd_org" {
90 default = "DataFort "
91 description = "Name tenant"
92 }
93
94 {{/code}}
95
Ирина Сафонова 4.1 96 * Используется название Virtual Data Center.
Ирина Сафонова 3.1 97
98 {{code language="none"}}
99 variable "vcd_vdc" {
100 default = "MY-VDC "
101 description = "Name Virtual Data Center"
102 }
103
104 {{/code}}
105
Ирина Сафонова 4.1 106 * Используется ссылка на подключение.
Ирина Сафонова 3.1 107
108 {{code language="none"}}
109 variable "vcd_url" {
110 default = " https://cloud3.datafort.ru/api"
111 description = "Cloud Director URL API"
112 }
113 variable "vcd_max_retry_timeout" {
114 default = "60"
115 }
116 variable "vcd_allow_unverified_ssl" {
117 default = "true"
118 description = "Disable SSL certificate"
119 }
120
121 {{/code}}
Ирина Сафонова 5.1 122
123 === Основные команды ===
124
Ирина Сафонова 6.1 125 * {{code language="none"}}terraform -help{{/code}} – вывод справок.
126 * {{code language="none"}}terraform -version{{/code}} – вывод версии Terraform и установленных провайдеров.
127 * {{code language="none"}}terraform init{{/code}} – инициализация каталога Terraform.
128 * {{code language="none"}}terraform plan{{/code}} – генерация файла изменений и вывод изменений в инфраструктуре.
129 * {{code language="none"}}terraform apply{{/code}} – применение изменений конфигурации, изначально выводит список изменений и/или добавлений в инфраструктуру.
130 * {{code language="none"}}terraform destroy{{/code}} – удаление инфраструктуры.
131 * {{code language="none"}}terraform refresh{{/code}} – обновление состояния с локальным файлом и состоянием реальных ресурсов.
Ирина Сафонова 14.1 132
133 == Пример настройки ==
134
135 ----
136
Ирина Сафонова 15.1 137 В примере создается **vApp**, в него помещается виртуальная машина и подключается к существующей сети. В файле {{code language="none"}}main.tf{{/code}}:
Ирина Сафонова 14.1 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
Ирина Сафонова 20.1 192 5. Создайте виртуальную машину (ВМ) из шаблона в **vApp my-first-vapp** и включите кастомизацию ВМ с подключением сети **network**.
Ирина Сафонова 14.1 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}}
Ирина Сафонова 17.1 273
Ирина Сафонова 19.1 274 == Ссылки на документацию ==
Ирина Сафонова 17.1 275
276 ----
277
Ирина Сафонова 18.1 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.