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

Редактировал(а) Ирина Сафонова 18.03.2024, 22:31
От версии 21.1
отредактировано Ирина Сафонова
на 01.05.2023, 16:58
Изменить комментарий: К данной версии нет комментариев
К версии 2.1
отредактировано Ирина Сафонова
на 01.05.2023, 00:49
Изменить комментарий: К данной версии нет комментариев

Сводка

Подробности

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