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

Редактировал(а) Ирина Сафонова 18.03.2024, 22:31

От версии 11.4
отредактировано Ирина Сафонова
на 01.05.2023, 01:03
Изменить комментарий: К данной версии нет комментариев
К версии 69.1
отредактировано Ирина Сафонова
на 15.01.2024, 17:01
Изменить комментарий: К данной версии нет комментариев

Сводка

Подробности

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