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

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

Сводка

Подробности

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