BASIS
/
terraform-provider-dynamix
6
0
Fork 0
Code Issues Pull Requests Packages Projects Releases 5 Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'main'
${ noResults }
terraform-provider-dynamix/wiki/1.1.0/04.01-Установка-Terraform-п...

7.5 KiB
Raw Permalink Blame History Escape

Системные требования

Для запуска провайдера вам потребуется машина, на которой установлен Terraform.

Кроме того, в связи с тем, что начиная с версии 0.12 Terraform изменил алгоритм поиска и инициализации локальных провайдеров, настройка данного провайдера для работы с Terraform 0.12 или более новыми версиями потребует выполнения ряда дополнительных действий. Подробнее см. 8.3 Настройка локального провайдера для работы с новыми версиями Terraform.

Установка

В релизном архиве находятся скрипты-инсталляторы. Чтобы выполнить установку, необходимо:

  1. Перейти по адресу: https://repository.basistech.ru/BASIS/terraform-provider-dynamix/releases
  2. Выбрать необходимую версию провайдера подходящую под операционную систему.
  3. Скачать архив.
  4. Распаковать архив.
  5. Выполнить скрипт установщика, install.sh или install.bat для Windows.
    Для запуска install.sh не забудьте изменить права доступа к файлу
chmod u+x install.sh
  1. Дождаться сообщения об успешной установке. Установщик выведет актуальный блок конфигурации провайдера, скопируйте его
terraform {
  required_providers {
    dynamix = {
      version = "1.1.0"
      source  = "basistech.ru/tf/dynamix"
    }
  }
}
  1. После этого, создайте файл main.tf в рабочей директории, которая может находится в любом удобном для пользователя месте. В данном примере, рабочая директория с файлом main.tf находится по пути:
~/work/tfdir/main.tf
  1. Вставьте в main.tf блок конфигурации провайдера, который был выведен на экран установщиком:
terraform {
  required_providers {
    dynamix = {
      version = "1.1.0"
      source  = "basistech.ru/tf/dynamix"
    }
  }
}
  1. Добавьте в файл блок с инициализацией провайдера.
provider "dynamix" {
  authenticator        = "decs3o"
  controller_url       = "https://mr4.digitalenergy.online"
  oauth2_url           = "https://sso.digitalenergy.online"
  allow_unverified_ssl = true
}
  1. В консоли выполните команду
terraform init
  1. В случае успешной установки, Terraform инициализирует провайдер и будет готов к дальнейшей работе.

Установка из релизов

Terraform провайдер DYNAMIX имеет скомпилированные релизные версии, которые расположены по адресу: Релизы.
Чтобы выполнить установку из релиза, необходимо:

  1. Перейти по адресу: https://repository.basistech.ru/BASIS/terraform-provider-dynamix/releases
  2. Выбрать необходимую версию провайдера подходящую под операционную систему.
  3. Скачать архив.
  4. Распаковать архив.
  5. Полученный файл (в директории bin/) необходимо поместить:
    Linux:
~/.terraform.d/plugins/${host_name}/${namespace}/${type}/${version}/${target}

Windows:

%APPDATA%\terraform.d\plugins\${host_name}\${namespace}\${type}\${version}\${target}

Где:

  • host_name - имя хоста, держателя провайдера, например, basis
  • namespace - пространство имен хоста, например decort
  • type - тип провайдера, может совпадать с пространством имен, например, decort
  • version - версия провайдера, например 4.3.0
  • target - архитектура операционной системы, например windows_amd64

В примере ниже используется путь до провайдера на машине с ОС Linux:

~/.terraform.d/plugins/basis/basistech.ru/tf/dynamix/1.1.0/linux_amd64/tf-provider
                        ^     ^      ^     ^       ^          ^
              host_name |     |      |     |       |          |
                              |      |     |       |          |
                    namespace |      |     |       |          |
                                     |     |       |          |
                               type  |     |       |          |
                                           |       |          |
                                   version |       |          | 
                                                   |          |
                                            target |          |
                                                              |
                                             исполняемый файл |
  1. После этого, создайте файл main.tf в рабочей директории, которая может находится в любом удобном для пользователя месте. В данном примере, рабочая директория с файлом main.tf находится по пути:
~/work/tfdir/main.tf
  1. Добавьте в main.tf следующий блок
terraform {
  required_providers {
    dynamix = {
      source  = "basistech.ru/tf/dynamix"
      version = "1.1.0"
    }
  }
}

В поле version указывается версия провайдера.
ВНИМАНИЕ: Версии в блоке и в пути к исполняемому файлу провайдера должны совпадать!

В поле source помещается путь до репозитория с версией вида:

${host_name}/${namespace}/${type}

ВНИМАНИЕ: Версии в блоке и в пути к исполняемому файлу провайдера должны совпадать!

  1. Добавьте в файл блок с инициализацией провайдера.
provider "dynamix" {
  authenticator        = "decs3o"
  controller_url       = "https://mr4.digitalenergy.online"
  oauth2_url           = "https://sso.digitalenergy.online"
  allow_unverified_ssl = true
}
  1. В консоли выполните команду
terraform init
  1. В случае успешной установки, Terraform инициализирует провайдер и будет готов к дальнейшей работе.