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

Редактировал(а) Ирина Сафонова 18.03.2024, 22:31
От версии 11.5
отредактировано Ирина Сафонова
на 01.05.2023, 01:04
Изменить комментарий: К данной версии нет комментариев
К версии 65.1
отредактировано Ирина Сафонова
на 28.11.2023, 16:14
Изменить комментарий: К данной версии нет комментариев

Сводка

Подробности

Свойства страницы
Родительский документ
... ... @@ -1,1 +1,1 @@
1 -Main.WebHome
1 +Инфраструктурные сервисы (IaaS).WebHome
Теги
... ... @@ -1,0 +1,1 @@
1 +Terraform
Содержимое
... ... @@ -1,16 +1,23 @@
1 -**Содержание**
2 -
1 +{{box cssClass="floatinginfobox" title="**Содержание**"}}
3 3  {{toc/}}
3 +{{/box}}
4 4  
5 -== Подготовка файла конфигурации ==
5 +(% data-xwiki-non-generated-content="java.util.List" %)
6 +(((
7 += Назначение Terraform =
8 +)))
6 6  
7 7  ----
8 8  
9 -Для подготовки:
12 +**Terraform** — программное обеспечение с открытым исходным кодом, используемое для управления внешними ресурсами (например, в рамках модели инфраструктуры как кода).
10 10  
11 -1. Создайте конфигурационный файл main.tf и файл с переменными{{code language="none"}}variables.tf{{/code}}.
12 -2. Перейдите по ссылкам ниже и скопируйте поддерживаемый provider в файл конфигурации {{code language="none"}}main.tf{{/code}}.
14 += Подготовка конфигурационного файла =
13 13  
16 +----
17 +
18 +~1. Создайте конфигурационный файл {{code language="none"}}main.tf{{/code}}и файл с переменными {{code language="none"}}variables.tf{{/code}}.
19 +2. Перейдите по ссылкам ниже и скопируйте поддерживаемый **provider** в файл конфигурации {{code language="none"}}main.tf{{/code}}.
20 +
14 14  {{info}}
15 15  Для Cloud Director 10.2 максимально поддерживаемая версия провайдера 3.7.0, для Cloud Director 10.3 максимальная поддерживаемая версия 3.9.0.
16 16  Провайдер 3.7.0 https://registry.terraform.io/providers/vmware/vcd/3.7.0/docs
... ... @@ -17,24 +17,25 @@
17 17  Провайдер 3.9.0 https://registry.terraform.io/providers/vmware/vcd/latest/docs
18 18  {{/info}}
19 19  
20 -[[image:__fileCreatedFromDataURI__.png]]
27 +[[image:Рисунок1.png]]
21 21  
22 -3. Инициализируйте Terraform в папке с конфигурационным файлом main.tf.
29 +3. Инициализируйте Terraform в папке с конфигурационным файлом {{code language="none"}}main.tf{{/code}}.
23 23  
24 24  {{info}}
25 25  Команда {{code language="none"}}terraform init{{/code}} используется для инициализации рабочего каталога Terraform. При введении команды она автоматически загрузит и установит все необходимые провайдеры и плагины Terraform.
26 26  {{/info}}
27 27  
28 -[[image:__fileCreatedFromDataURI__.png]]
35 +[[image:Рисунок2.png]]
29 29  
30 -4. Для обновления версии провайдера измените версию в файле main.tf и введите команду {{code language="none"}}terraform init -upgrade{{/code}}.
37 +4. Для обновления версии провайдера измените версию в файле {{code language="none"}}main.tf{{/code}} и введите команду {{code language="none"}}terraform init -upgrade{{/code}}.
31 31  
32 -[[image:__fileCreatedFromDataURI__.png]]
39 +[[image:Рисунок3.png]]
33 33  
34 34  5. Проверьте версию Terraform и установленного провайдера при помощи команды {{code language="none"}}terraform -version{{/code}}.
35 35  
43 +[[image:Рисунок5.png]]
36 36  
37 -== Подключение к Cloud Director ==
45 += Подключение к Cloud Director =
38 38  
39 39  ----
40 40  
... ... @@ -75,7 +75,7 @@
75 75  
76 76  {{/code}}
77 77  
78 -* Используется название Tenant Cloud Director
86 +* Используется название Tenant Cloud Director.
79 79  
80 80  {{code language="none"}}
81 81  variable "vcd_org" {
... ... @@ -112,12 +112,164 @@
112 112  
113 113  {{/code}}
114 114  
115 -=== Основные команды ===
123 +== Основные команды ==
116 116  
117 -* {{code language="none"}}terraform -help{{/code}} – вывод справок.
118 -* {{code language="none"}}terraform -version{{/code}} – вывод версии Terraform и установленных провайдеров.
119 -* {{code language="none"}}terraform init{{/code}} – инициализация каталога Terraform.
120 -* {{code language="none"}}terraform plan{{/code}} – генерация файла изменений и вывод изменений в инфраструктуре.
121 -* {{code language="none"}}terraform apply{{/code}} – применение изменений конфигурации, изначально выводит список изменений и/или добавлений в инфраструктуру.
122 -* {{code language="none"}}terraform destroy{{/code}} – удаление инфраструктуры.
123 -* {{code language="none"}}terraform refresh{{/code}} – обновление состояния с локальным файлом и состоянием реальных ресурсов.
125 +(% class="table-bordered" style="width:544.818px" %)
126 +(% style="background-color:#d3d3d3; text-align:center" %)|(% style="width:228px" %)**Команда**|(% style="width:315px" %)**Комментарий**
127 +|(% style="width:228px" %){{code language="none"}}terraform -help{{/code}}|(% style="width:315px" %)Вывод справок.
128 +|(% style="width:228px" %){{code language="none"}}terraform -version{{/code}}|(% style="width:315px" %)Вывод версии Terraform и установленных провайдеров.
129 +|(% style="width:228px" %){{code language="none"}}terraform init{{/code}}|(% style="width:315px" %)Инициализация каталога Terraform.
130 +|(% style="width:228px" %){{code language="none"}}terraform plan{{/code}}|(% style="width:315px" %)Генерация файла изменений и вывод изменений в инфраструктуре.
131 +|(% style="width:228px" %){{code language="none"}}terraform apply{{/code}}|(% style="width:315px" %)Применение изменений конфигурации, изначально выводит список изменений и/или добавлений в инфраструктуру.
132 +|(% style="width:228px" %){{code language="none"}}terraform destroy{{/code}}|(% style="width:315px" %)Удаление инфраструктуры.
133 +|(% style="width:228px" %){{code language="none"}}terraform refresh{{/code}}|(% style="width:315px" %)Обновление состояния с локальным файлом и состоянием реальных ресурсов.
134 +
135 += (% style="color:inherit; font-family:inherit; font-size:26px" %)Пример настройки(%%) =
136 +
137 +----
138 +
139 +В примере создается **vApp** (виртуальное приложение), в которое помещается [[виртуальная машина>>https://wiki.dfcloud.ru/bin/view/Glossary/%D0%92%D0%9C]] (ВМ) и подключается к существующей сети. В файле {{code language="none"}}main.tf{{/code}}:
140 +
141 +~1. Укажите провайдер поддерживаемой версии Cloud Director.
142 +
143 +{{code language="none"}}
144 +terraform {
145 + required_providers {
146 + vcd = {
147 + source = "vmware/vcd"
148 + version = "3.7.0"
149 + }
150 + }
151 +}
152 +
153 +{{/code}}
154 +
155 +2. Подключитесь к **Tenant**.
156 +
157 +{{code language="none"}}
158 +provider "vcd" {
159 + user = var.vcd_user
160 + password = var.vcd_pass
161 + auth_type = "integrated"
162 + org = var.vcd_org
163 + vdc = var.vcd_vdc
164 + url = var.vcd_url
165 + max_retry_timeout = var.vcd_max_retry_timeout
166 + allow_unverified_ssl = var.vcd_allow_unverified_ssl
167 +}
168 +
169 +{{/code}}
170 +
171 +3. Создайте **vApp**.
172 +
173 +{{code language="none"}}
174 +resource "vcd_vapp" "vapp1" {
175 + name = "my-first-vapp"
176 + vdc = var.vcd_vdc
177 + org = var.vcd_org
178 +}
179 +
180 +{{/code}}
181 +
182 +4. Подключитесь в ручную созданную сеть **network** к **vApp** **my-first-vapp**.
183 +
184 +{{code language="none"}}
185 +resource "vcd_vapp_org_network" "is-net" {
186 + vapp_name = "my-first-vapp"
187 + vdc = var.vcd_vdc
188 + org_network_name = "network"
189 + depends_on = [vcd_vapp.vapp1]
190 +}
191 +
192 +{{/code}}
193 +
194 +5. Создайте ВМ из шаблона в **vApp my-first-vapp** и включите ее кастомизацию ВМ с подключением сети **network**.
195 +
196 +{{code language="none"}}
197 +resource "vcd_vapp_vm" "vm1" {
198 + vapp_name = vcd_vapp.vapp1.name
199 + name = "my-first-vm"
200 + computer_name = "myvm"
201 + cpus = 4
202 + cpu_cores = 2
203 + memory = 4096
204 + org = var.vcd_org
205 + vdc = var.vcd_vdc
206 + storage_profile = var.storage_br
207 + os_type = "windows9Server64Guest"
208 + catalog_name = var.catalog_name_templates
209 + template_name = var.name_templates
210 + depends_on = [vcd_vapp.vapp1, vcd_vapp_org_network.is-net]
211 + customization {
212 + enabled = true
213 + force = true
214 + change_sid = true
215 + allow_local_admin_password = true
216 + auto_generate_password = false
217 + admin_password = "my-secure-password"
218 + }
219 +
220 + network {
221 + adapter_type = "VMXNET3"
222 + connected = true
223 + ip_allocation_mode = "POOL"
224 + is_primary = true
225 + name = "network"
226 + type = "org"
227 + }
228 +}
229 +
230 +{{/code}}
231 +
232 +Файл {{code language="none"}}variables.tf{{/code}}:
233 +
234 +{{code language="none"}}
235 +variable "vcd_user" {
236 + default = "my-terraform"
237 + description = "Cloud Director tenant user"
238 +}
239 +variable "vcd_pass" {
240 + default = "my-password"
241 + description = "Cloud Director tenant password"
242 +}
243 +variable "vcd_org" {
244 + default = "DataFort"
245 + description = "Tenant name"
246 +}
247 +variable "vcd_vdc" {
248 + default = "MY-VDC"
249 + description = "Name VDC"
250 +}
251 +variable "vcd_url" {
252 + default = "https://cloud3.datafort.ru/api"
253 + description = "URL Cloud Director API"
254 +}
255 +variable "vcd_max_retry_timeout" {
256 + default = "60"
257 +}
258 +variable "vcd_allow_unverified_ssl" {
259 + default = "true"
260 + description = "Disable SSL certificate"
261 +}
262 +variable "storage_br" {
263 + default = "HP3.1-VCD-Templates-Bronze-6"
264 +}
265 +variable "catalog_name_templates" {
266 + default = "Windows"
267 + description = "Name catalog templates"
268 +}
269 +variable "name_templates" {
270 + default = "Win2016_DE_RUS DC3 vCD_tmp"
271 + description = "Name templates"
272 +}
273 +
274 +{{/code}}
275 +
276 += Ссылки на документацию =
277 +
278 +----
279 +
280 +* [[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]]  — конфигурация ВМ и список используемых типов операционных систем.
281 +* [[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.
282 +* [[https:~~/~~/developer.hashicorp.com/terraform/downloads>>url:https://developer.hashicorp.com/terraform/downloads]] — ссылка на скачивание Terraform.
283 +* [[Репозиторий в Github>>https://github.com/hashicorp/terraform]].
__fileCreatedFromDataURI__.png
Размер
... ... @@ -1,1 +1,1 @@
1 -244.1 KB
1 +57.3 KB
Содержимое
Desktop 2023-05-06 01.22.31.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ISafonova
Размер
... ... @@ -1,0 +1,1 @@
1 +87.5 KB
Содержимое
Installing Database Drivers _ Superset - Google Ch.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ISafonova
Размер
... ... @@ -1,0 +1,1 @@
1 +64.4 KB
Содержимое
image-20230506013811-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ISafonova
Размер
... ... @@ -1,0 +1,1 @@
1 +87.5 KB
Содержимое
image-20230506013955-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ISafonova
Размер
... ... @@ -1,0 +1,1 @@
1 +88.4 KB
Содержимое
image-20230506021501-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ISafonova
Размер
... ... @@ -1,0 +1,1 @@
1 +74.1 KB
Содержимое
Рисунок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
Содержимое
Снимок.PNG
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ISafonova
Размер
... ... @@ -1,0 +1,1 @@
1 +74.1 KB
Содержимое
Цвета HTML. Таблица из 147 имён цветов для HTML и .jpg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ISafonova
Размер
... ... @@ -1,0 +1,1 @@
1 +272.4 KB
Содержимое
скрин_2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ISafonova
Размер
... ... @@ -1,0 +1,1 @@
1 +272.5 KB
Содержимое