|
|
# terraform-provider-decort
|
|
|
|
|
|
Terraform provider для платформы Digital Energy Cloud Orchestration Technology (DECORT)
|
|
|
|
|
|
## Соответсвие версий платформы версиям провайдера
|
|
|
|
|
|
| Версия DECORT API | Версия провайдера Terraform |
|
|
|
| ------ | ------ |
|
|
|
| 3.8.5 | 3.4.x |
|
|
|
| 3.8.0 - 3.8.4 | 3.3.1 |
|
|
|
| 3.7.x | rc-1.25 |
|
|
|
| 3.6.x | rc-1.10 |
|
|
|
| до 3.6.0 | [terraform-provider-decs](https://github.com/rudecs/terraform-provider-decs) |
|
|
|
|
|
|
## Режимы работы
|
|
|
|
|
|
Провайдер позволяет работать в двух режимах:
|
|
|
|
|
|
- Режим пользователя,
|
|
|
- Режим администратора.
|
|
|
Для переключения между режимами используйте флаг DECORT_ADMIN_MODE.
|
|
|
Вики проекта: https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki
|
|
|
|
|
|
## Возможности провайдера
|
|
|
|
|
|
- Работа с Compute instances,
|
|
|
- Работа с disks,
|
|
|
- Работа с k8s,
|
|
|
- Работа с image,
|
|
|
- Работа с reource groups,
|
|
|
- Работа с VINS,
|
|
|
- Работа с pfw,
|
|
|
- Работа с accounts,
|
|
|
- Работа с snapshots,
|
|
|
- Работа с pcidevice,
|
|
|
- Работа с sep,
|
|
|
- Работа с vgpu,
|
|
|
- Работа с bservice,
|
|
|
- Работа с extnets,
|
|
|
- Работа с locations,
|
|
|
- Работа с load balancer.
|
|
|
|
|
|
Вики проекта: https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki
|
|
|
|
|
|
## Начало
|
|
|
|
|
|
Старт возможен по двум путям:
|
|
|
|
|
|
1. Установка через собранные пакеты.
|
|
|
2. Ручная установка.
|
|
|
|
|
|
### Установка через собранные пакеты.
|
|
|
|
|
|
1. Скачайте и установите terraform по ссылке: https://learn.hashicorp.com/tutorials/terraform/install-cli?in=terraform/aws-get-started
|
|
|
2. Создайте файл `main.tf` и добавьте в него следующий блок.
|
|
|
|
|
|
```terraform
|
|
|
provider "decort" {
|
|
|
authenticator = "oauth2"
|
|
|
#controller_url = <DECORT_CONTROLLER_URL>
|
|
|
controller_url = "https://ds1.digitalenergy.online"
|
|
|
#oauth2_url = <DECORT_SSO_URL>
|
|
|
oauth2_url = "https://sso.digitalenergy.online"
|
|
|
allow_unverified_ssl = true
|
|
|
}
|
|
|
```
|
|
|
|
|
|
3. Выполните команду
|
|
|
|
|
|
```
|
|
|
terraform init
|
|
|
```
|
|
|
|
|
|
Провайдер автоматически будет установлен на ваш компьютер из terraform registry.
|
|
|
|
|
|
### Ручная установка
|
|
|
|
|
|
1. Скачайте и установите Go по ссылке: https://go.dev/dl/
|
|
|
2. Скачайте и установите terraform по ссылке: https://learn.hashicorp.com/tutorials/terraform/install-cli?in=terraform/aws-get-started
|
|
|
3. Склонируйте репозиторий с провайдером, выполнив команду:
|
|
|
|
|
|
```bash
|
|
|
git clone https://repository.basistech.ru/BASIS/terraform-provider-decort
|
|
|
```
|
|
|
|
|
|
4. Перейдите в скачанную папку с провайдером и выполните команду
|
|
|
|
|
|
```bash
|
|
|
go build -o terraform-provider-decort
|
|
|
```
|
|
|
|
|
|
Если вы знаете как устроен _makefile_, то можно изменить в файле `Makefile` параметры под вашу ОС и выполнить команду
|
|
|
|
|
|
```bash
|
|
|
make build
|
|
|
```
|
|
|
|
|
|
5. Полученный файл необходимо поместить:
|
|
|
Linux:
|
|
|
|
|
|
```bash
|
|
|
~/.terraform.d/plugins/${host_name}/${namespace}/${type}/${version}/${target}
|
|
|
```
|
|
|
|
|
|
Windows:
|
|
|
|
|
|
```powershell
|
|
|
%APPDATA%\terraform.d\plugins\${host_name}\${namespace}\${type}\${version}\${target}
|
|
|
```
|
|
|
|
|
|
ВНИМАНИЕ: для ОС Windows `%APP_DATA%` является каталогом, в котором будут помещены будущие файлы terraform.
|
|
|
Где:
|
|
|
|
|
|
- host_name - имя хоста, держателя провайдера, например, digitalenergy.online
|
|
|
- namespace - пространство имен хоста, например decort
|
|
|
- type - тип провайдера, может совпадать с пространством имен, например, decort
|
|
|
- version - версия провайдера, например 1.2
|
|
|
- target - версия ОС, например windows_amd64
|
|
|
|
|
|
6. После этого, создайте файл `main.tf`.
|
|
|
7. Добавьте в него следующий блок
|
|
|
|
|
|
```terraform
|
|
|
terraform {
|
|
|
required_providers {
|
|
|
decort = {
|
|
|
version = "1.2"
|
|
|
source = "digitalenergy.online/decort/decort"
|
|
|
}
|
|
|
}
|
|
|
}
|
|
|
```
|
|
|
|
|
|
В поле `version` указывается версия провайдера.
|
|
|
Обязательный параметр
|
|
|
Тип поля - строка
|
|
|
ВНИМАНИЕ: Версии в блоке и в репозитории, в который был помещен провайдер должны совпадать!
|
|
|
|
|
|
В поле `source` помещается путь до репозитория с версией вида:
|
|
|
|
|
|
```bash
|
|
|
${host_name}/${namespace}/${type}
|
|
|
```
|
|
|
|
|
|
ВНИМАНИЕ: все параметры должны совпадать с путем репозитория, в котором помещен провайдер.
|
|
|
|
|
|
8. В консоле выполнить команду
|
|
|
|
|
|
```bash
|
|
|
terraform init
|
|
|
```
|
|
|
|
|
|
9. Если все прошло хорошо - ошибок не будет.
|
|
|
|
|
|
Более подробно о сборке провайдера можно найти по ссылке: https://learn.hashicorp.com/tutorials/terraform/provider-use?in=terraform/providers
|
|
|
|
|
|
## Примеры работы
|
|
|
|
|
|
Примеры работы можно найти:
|
|
|
|
|
|
- На вики проекта: https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki
|
|
|
- В папке `samples`
|
|
|
|
|
|
Схемы к terraform'у доступны:
|
|
|
|
|
|
- В папке `docs`
|
|
|
|
|
|
Хорошей работы!
|
