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

Редактировал(а) Ирина Сафонова 18.03.2024, 22:31
От версии 1.2
отредактировано Ирина Сафонова
на 01.05.2023, 00:44
Изменить комментарий: К данной версии нет комментариев
К версии 20.1
отредактировано Ирина Сафонова
на 01.05.2023, 15:36
Изменить комментарий: К данной версии нет комментариев

Сводка

Подробности

Свойства страницы
Теги
... ... @@ -1,0 +1,1 @@
1 +Terraform
Содержимое
... ... @@ -1,14 +1,15 @@
1 -*
2 -** Содержание
1 +**Содержание**
3 3  
3 +{{toc/}}
4 +
4 4  == Подготовка файла конфигурации ==
5 5  
6 6  ----
7 7  
8 -Для подготовки:
9 +Для подготовки конфигурационного файла:
9 9  
10 -1. Создайте конфигурационный файл main.tf и файл с переменными{{code language="none"}}variables.tf{{/code}}.
11 -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}}.
12 12  
13 13  {{info}}
14 14  Для Cloud Director 10.2 максимально поддерживаемая версия провайдера 3.7.0, для Cloud Director 10.3 максимальная поддерживаемая версия 3.9.0.
... ... @@ -16,14 +16,259 @@
16 16  Провайдер 3.9.0 https://registry.terraform.io/providers/vmware/vcd/latest/docs
17 17  {{/info}}
18 18  
19 -3. Инициализируйте Terraform в папке с конфигурационным файлом main.tf.
20 +[[image:Рисунок1.png]]
20 20  
22 +3. Инициализируйте Terraform в папке с конфигурационным файлом {{code language="none"}}main.tf{{/code}}.
23 +
21 21  {{info}}
22 22  Команда {{code language="none"}}terraform init{{/code}} используется для инициализации рабочего каталога Terraform. При введении команды она автоматически загрузит и установит все необходимые провайдеры и плагины Terraform.
23 23  {{/info}}
24 24  
25 -[[image:__fileCreatedFromDataURI__.png]]
28 +[[image:Рисунок2.png]]
26 26  
27 -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}}.
28 28  
29 -
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 +Для подключения:
43 +
44 +~1. Заполните файл {{code language="none"}}main.tf{{/code}} данными.
45 +
46 +{{code language="none"}}
47 +provider "vcd" {
48 + user = var.vcd_user
49 + password = var.vcd_pass
50 + auth_type = "integrated"
51 + org = var.vcd_org
52 + url = var.vcd_url
53 + max_retry_timeout = var.vcd_max_retry_timeout
54 + allow_unverified_ssl = var.vcd_allow_unverified_ssl
55 +}
56 +
57 +{{/code}}
58 +
59 +2. Заполните {{code language="none"}}variables.tf{{/code}} данными:
60 +
61 +* Используется логин для авторизации в Cloud Director.
62 +
63 +{{code language="none"}}
64 +variable "vcd_user" {
65 + default = "my-terraform"
66 + description = "Cloud Director tenant user"
67 +}
68 +
69 +{{/code}}
70 +
71 +* Используется пароль для авторизации в Cloud Director.
72 +
73 +{{code language="none"}}
74 +variable "vcd_pass" {
75 + default = "my-password"
76 + description = " Cloud Director tenant password"
77 +}
78 +
79 +{{/code}}
80 +
81 +* Используется название Tenant Cloud Director
82 +
83 +{{code language="none"}}
84 +variable "vcd_org" {
85 + default = "DataFort "
86 + description = "Name tenant"
87 +}
88 +
89 +{{/code}}
90 +
91 +* Используется название Virtual Data Center.
92 +
93 +{{code language="none"}}
94 +variable "vcd_vdc" {
95 + default = "MY-VDC "
96 + description = "Name Virtual Data Center"
97 +}
98 +
99 +{{/code}}
100 +
101 +* Используется ссылка на подключение.
102 +
103 +{{code language="none"}}
104 +variable "vcd_url" {
105 + default = " https://cloud3.datafort.ru/api"
106 + description = "Cloud Director URL API"
107 +}
108 +variable "vcd_max_retry_timeout" {
109 + default = "60"
110 +}
111 +variable "vcd_allow_unverified_ssl" {
112 + default = "true"
113 + description = "Disable SSL certificate"
114 +}
115 +
116 +{{/code}}
117 +
118 +=== Основные команды ===
119 +
120 +* {{code language="none"}}terraform -help{{/code}} – вывод справок.
121 +* {{code language="none"}}terraform -version{{/code}} – вывод версии Terraform и установленных провайдеров.
122 +* {{code language="none"}}terraform init{{/code}} – инициализация каталога Terraform.
123 +* {{code language="none"}}terraform plan{{/code}} – генерация файла изменений и вывод изменений в инфраструктуре.
124 +* {{code language="none"}}terraform apply{{/code}} – применение изменений конфигурации, изначально выводит список изменений и/или добавлений в инфраструктуру.
125 +* {{code language="none"}}terraform destroy{{/code}} – удаление инфраструктуры.
126 +* {{code language="none"}}terraform refresh{{/code}} – обновление состояния с локальным файлом и состоянием реальных ресурсов.
127 +
128 +== Пример настройки ==
129 +
130 +----
131 +
132 +В примере создается **vApp**, в него помещается виртуальная машина и подключается к существующей сети. В файле {{code language="none"}}main.tf{{/code}}:
133 +
134 +1. Укажите провайдер поддерживаемой версии Cloud Director.
135 +
136 +{{code language="none"}}
137 +terraform {
138 + required_providers {
139 + vcd = {
140 + source = "vmware/vcd"
141 + version = "3.7.0"
142 + }
143 + }
144 +}
145 +
146 +{{/code}}
147 +
148 +2. Подключитесь к **Tenant**.
149 +
150 +{{code language="none"}}
151 +provider "vcd" {
152 + user = var.vcd_user
153 + password = var.vcd_pass
154 + auth_type = "integrated"
155 + org = var.vcd_org
156 + vdc = var.vcd_vdc
157 + url = var.vcd_url
158 + max_retry_timeout = var.vcd_max_retry_timeout
159 + allow_unverified_ssl = var.vcd_allow_unverified_ssl
160 +}
161 +
162 +{{/code}}
163 +
164 +3. Создайте **vApp**.
165 +
166 +{{code language="none"}}
167 +resource "vcd_vapp" "vapp1" {
168 + name = "my-first-vapp"
169 + vdc = var.vcd_vdc
170 + org = var.vcd_org
171 +}
172 +
173 +{{/code}}
174 +
175 +4. Подключитесь в ручную созданную сеть **network** к **vApp** **my-first-vapp**.
176 +
177 +{{code language="none"}}
178 +resource "vcd_vapp_org_network" "is-net" {
179 + vapp_name = "my-first-vapp"
180 + vdc = var.vcd_vdc
181 + org_network_name = "network"
182 + depends_on = [vcd_vapp.vapp1]
183 +}
184 +
185 +{{/code}}
186 +
187 +5. Создайте виртуальную машину (ВМ) из шаблона в **vApp my-first-vapp** и включите кастомизацию ВМ с подключением сети **network**.
188 +
189 +{{code language="none"}}
190 +resource "vcd_vapp_vm" "vm1" {
191 + vapp_name = vcd_vapp.vapp1.name
192 + name = "my-first-vm"
193 + computer_name = "myvm"
194 + cpus = 4
195 + cpu_cores = 2
196 + memory = 4096
197 + org = var.vcd_org
198 + vdc = var.vcd_vdc
199 + storage_profile = var.storage_br
200 + os_type = "windows9Server64Guest"
201 + catalog_name = var.catalog_name_templates
202 + template_name = var.name_templates
203 + depends_on = [vcd_vapp.vapp1, vcd_vapp_org_network.is-net]
204 + customization {
205 + enabled = true
206 + force = true
207 + change_sid = true
208 + allow_local_admin_password = true
209 + auto_generate_password = false
210 + admin_password = "my-secure-password"
211 + }
212 +
213 + network {
214 + adapter_type = "VMXNET3"
215 + connected = true
216 + ip_allocation_mode = "POOL"
217 + is_primary = true
218 + name = "network"
219 + type = "org"
220 + }
221 +}
222 +
223 +{{/code}}
224 +
225 +Файл {{code language="none"}}variables.tf{{/code}}.
226 +
227 +{{code language="none"}}
228 +variable "vcd_user" {
229 + default = "my-terraform"
230 + description = "Cloud Director tenant user"
231 +}
232 +variable "vcd_pass" {
233 + default = "my-password"
234 + description = "Cloud Director tenant password"
235 +}
236 +variable "vcd_org" {
237 + default = "DataFort"
238 + description = "Tenant name"
239 +}
240 +variable "vcd_vdc" {
241 + default = "MY-VDC"
242 + description = "Name VDC"
243 +}
244 +variable "vcd_url" {
245 + default = "https://cloud3.datafort.ru/api"
246 + description = "URL Cloud Director API"
247 +}
248 +variable "vcd_max_retry_timeout" {
249 + default = "60"
250 +}
251 +variable "vcd_allow_unverified_ssl" {
252 + default = "true"
253 + description = "Disable SSL certificate"
254 +}
255 +variable "storage_br" {
256 + default = "HP3.1-VCD-Templates-Bronze-6"
257 +}
258 +variable "catalog_name_templates" {
259 + default = "Windows"
260 + description = "Name catalog templates"
261 +}
262 +variable "name_templates" {
263 + default = "Win2016_DE_RUS DC3 vCD_tmp"
264 + description = "Name templates"
265 +}
266 +
267 +{{/code}}
268 +
269 +== Ссылки на документацию ==
270 +
271 +----
272 +
273 +* [[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]]  — конфигурация виртуальных машин и список типов операционных систем.
274 +* [[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.
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
Содержимое