Исходный код вики Подключение Terraform к vCD
Версия 67.2 от Ирина Сафонова на 02.01.2024, 23:02
Скрыть последних авторов
| author | version | line-number | content |
|---|---|---|---|
 |
63.1 | 1 | {{box cssClass="floatinginfobox" title="**Содержание**"}} |
| |
7.1 | 2 | {{toc/}} |
| |
63.1 | 3 | {{/box}} |
| |
1.1 | 4 | |
| |
63.1 | 5 | (% data-xwiki-non-generated-content="java.util.List" %) |
| 6 | ((( | ||
| |
67.2 | 7 | = Что такое Terraform? = |
| |
63.1 | 8 | ))) |
| |
50.1 | 9 | |
| 10 | ---- | ||
| 11 | |||
| |
54.1 | 12 | **Terraform** — программное обеспечение с открытым исходным кодом, используемое для управления внешними ресурсами (например, в рамках модели инфраструктуры как кода). |
| |
50.1 | 13 | |
| |
64.1 | 14 | = Подготовка конфигурационного файла = |
| |
1.1 | 15 | |
| 16 | ---- | ||
| 17 | |||
| |
45.1 | 18 | ~1. Создайте конфигурационный файл {{code language="none"}}main.tf{{/code}}и файл с переменными {{code language="none"}}variables.tf{{/code}}. |
| |
16.1 | 19 | 2. Перейдите по ссылкам ниже и скопируйте поддерживаемый **provider** в файл конфигурации {{code language="none"}}main.tf{{/code}}. |
| |
1.1 | 20 | |
| 21 | {{info}} | ||
| 22 | Для Cloud Director 10.2 максимально поддерживаемая версия провайдера 3.7.0, для Cloud Director 10.3 максимальная поддерживаемая версия 3.9.0. | ||
| |
67.2 | 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 | ||
| |
1.1 | 26 | {{/info}} |
| 27 | |||
| |
67.2 | 28 | [[image:Рисунок1.png||data-xwiki-image-style-border="true"]] |
| |
11.2 | 29 | |
| |
15.1 | 30 | 3. Инициализируйте Terraform в папке с конфигурационным файлом {{code language="none"}}main.tf{{/code}}. |
| |
1.1 | 31 | |
| 32 | {{info}} | ||
| 33 | Команда {{code language="none"}}terraform init{{/code}} используется для инициализации рабочего каталога Terraform. При введении команды она автоматически загрузит и установит все необходимые провайдеры и плагины Terraform. | ||
| 34 | {{/info}} | ||
| 35 | |||
| |
13.1 | 36 | [[image:Рисунок2.png]] |
| |
1.1 | 37 | |
| |
15.1 | 38 | 4. Для обновления версии провайдера измените версию в файле {{code language="none"}}main.tf{{/code}} и введите команду {{code language="none"}}terraform init -upgrade{{/code}}. |
| |
1.2 | 39 | |
| |
13.1 | 40 | [[image:Рисунок3.png]] |
| |
1.3 | 41 | |
| |
11.5 | 42 | 5. Проверьте версию Terraform и установленного провайдера при помощи команды {{code language="none"}}terraform -version{{/code}}. |
| |
2.1 | 43 | |
| |
13.1 | 44 | [[image:Рисунок5.png]] |
| |
11.5 | 45 | |
| |
64.1 | 46 | = Подключение к Cloud Director = |
| |
2.1 | 47 | |
| 48 | ---- | ||
| 49 | |||
| |
67.2 | 50 | ~1. Заполните файл {{code language="none"}}main.tf{{/code}} данными: |
| |
3.1 | 51 | |
| 52 | {{code language="none"}} | ||
| 53 | provider "vcd" { | ||
| |
2.1 | 54 | user = var.vcd_user |
| 55 | password = var.vcd_pass | ||
| 56 | auth_type = "integrated" | ||
| 57 | org = var.vcd_org | ||
| 58 | url = var.vcd_url | ||
| 59 | max_retry_timeout = var.vcd_max_retry_timeout | ||
| 60 | allow_unverified_ssl = var.vcd_allow_unverified_ssl | ||
| 61 | } | ||
| |
3.1 | 62 | |
| |
2.1 | 63 | {{/code}} |
| 64 | |||
| |
3.1 | 65 | 2. Заполните {{code language="none"}}variables.tf{{/code}} данными: |
| 66 | |||
| |
4.1 | 67 | * Используется логин для авторизации в Cloud Director. |
| |
3.1 | 68 | |
| 69 | {{code language="none"}} | ||
| 70 | variable "vcd_user" { | ||
| 71 | default = "my-terraform" | ||
| 72 | description = "Cloud Director tenant user" | ||
| 73 | } | ||
| 74 | |||
| 75 | {{/code}} | ||
| 76 | |||
| |
4.1 | 77 | * Используется пароль для авторизации в Cloud Director. |
| |
3.1 | 78 | |
| 79 | {{code language="none"}} | ||
| 80 | variable "vcd_pass" { | ||
| 81 | default = "my-password" | ||
| 82 | description = " Cloud Director tenant password" | ||
| 83 | } | ||
| 84 | |||
| 85 | {{/code}} | ||
| 86 | |||
| |
51.1 | 87 | * Используется название Tenant Cloud Director. |
| |
3.1 | 88 | |
| 89 | {{code language="none"}} | ||
| 90 | variable "vcd_org" { | ||
| 91 | default = "DataFort " | ||
| 92 | description = "Name tenant" | ||
| 93 | } | ||
| 94 | |||
| 95 | {{/code}} | ||
| 96 | |||
| |
4.1 | 97 | * Используется название Virtual Data Center. |
| |
3.1 | 98 | |
| 99 | {{code language="none"}} | ||
| 100 | variable "vcd_vdc" { | ||
| 101 | default = "MY-VDC " | ||
| 102 | description = "Name Virtual Data Center" | ||
| 103 | } | ||
| 104 | |||
| 105 | {{/code}} | ||
| 106 | |||
| |
4.1 | 107 | * Используется ссылка на подключение. |
| |
3.1 | 108 | |
| 109 | {{code language="none"}} | ||
| 110 | variable "vcd_url" { | ||
| 111 | default = " https://cloud3.datafort.ru/api" | ||
| 112 | description = "Cloud Director URL API" | ||
| 113 | } | ||
| 114 | variable "vcd_max_retry_timeout" { | ||
| 115 | default = "60" | ||
| 116 | } | ||
| 117 | variable "vcd_allow_unverified_ssl" { | ||
| 118 | default = "true" | ||
| 119 | description = "Disable SSL certificate" | ||
| 120 | } | ||
| 121 | |||
| 122 | {{/code}} | ||
| |
5.1 | 123 | |
| |
64.1 | 124 | == Основные команды == |
| |
5.1 | 125 | |
| |
27.2 | 126 | (% class="table-bordered" style="width:544.818px" %) |
| |
67.2 | 127 | (% class="active" style="background-color:#d3d3d3; text-align:center" %)|=(% style="width: 200px;" %)**Команда**|=(% style="width: 200px;" %)**Комментарий** |
| |
26.3 | 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 и установленных провайдеров. | ||
| |
27.1 | 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" %)Обновление состояния с локальным файлом и состоянием реальных ресурсов. | ||
| |
26.2 | 135 | |
| |
64.1 | 136 | = (% style="color:inherit; font-family:inherit; font-size:26px" %)Пример настройки(%%) = |
| |
14.1 | 137 | |
| 138 | ---- | ||
| 139 | |||
| |
51.1 | 140 | В примере создается **vApp** (виртуальное приложение), в которое помещается [[виртуальная машина>>https://wiki.dfcloud.ru/bin/view/Glossary/%D0%92%D0%9C]] (ВМ) и подключается к существующей сети. В файле {{code language="none"}}main.tf{{/code}}: |
| |
14.1 | 141 | |
| |
31.1 | 142 | ~1. Укажите провайдер поддерживаемой версии Cloud Director. |
| |
14.1 | 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 | |||
| |
51.1 | 172 | 3. Создайте **vApp**. |
| |
14.1 | 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 | |||
| |
51.1 | 195 | 5. Создайте ВМ из шаблона в **vApp my-first-vapp** и включите ее кастомизацию ВМ с подключением сети **network**. |
| |
14.1 | 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 | |||
| |
30.1 | 233 | Файл {{code language="none"}}variables.tf{{/code}}: |
| |
14.1 | 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}} | ||
| |
17.1 | 276 | |
| |
64.1 | 277 | = Ссылки на документацию = |
| |
17.1 | 278 | |
| 279 | ---- | ||
| 280 | |||
| |
53.1 | 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]] — конфигурация ВМ и список используемых типов операционных систем. |
| |
52.1 | 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. |
| |
18.1 | 283 | * [[https:~~/~~/developer.hashicorp.com/terraform/downloads>>url:https://developer.hashicorp.com/terraform/downloads]] — ссылка на скачивание Terraform. |
| |
61.1 | 284 | * [[Репозиторий в Github>>https://github.com/hashicorp/terraform]]. |