Change content

04.01-Установка-Terraform-провайдера-DECORT.md

@@ -31,22 +31,14 @@ terraform plan
 terraform apply
 ```
 
-## Сборка из исходных кодов
-
-1. Скачайте и установите Go по ссылке: [https://go.dev/dl/](https://go.dev/dl/)
-2. Скачайте и установите terraform по ссылке: [https://learn.hashicorp.com/tutorials/terraform/install-cli?in=terraform/aws-get-started](https://learn.hashicorp.com/tutorials/terraform/install-cli?in=terraform/aws-get-started)
-3. Склонируйте репозиторий с провайдером, выполнив команду:
-```bash
-git clone https://github.com/rudecs/terraform-provider-decort.git
-```
-4. Перейдите в скачанную папку с провайдером и выполните команду
-```bash
-go build -o terraform-provider-decort
-```
-Если вы знаете как устроен _makefile_, то можно изменить в файле `Makefile` параметры под вашу ОС и выполнить команду
-```bash
-make build
-```
+## Установка из релизов
+Terraform провайдер DECORT имеет скомпилированные релизные версии, которые расположены по адресу: [Релизы](https://github.com/rudecs/terraform-provider-decort/releases).  
+Установка из релизов позволяет вместо скачивания провайдера из хранилища HashiCorp Terraform, скачать провайдер со страницы, указанной выше и установить его в ручном режиме.  
+Чтобы выполнить установку из релиза, необходимо:
+1. Перейти по адресу: https://github.com/rudecs/terraform-provider-decort/releases
+2. Выбрать необходимую версию провайдера подходящую под операционную систему.
+3. Скачать архив.
+4. Распаковать архив.
 5. Полученный файл необходимо поместить:  
 Linux:
 ```bash
@@ -54,7 +46,7 @@ Linux:
 ```
 Windows:
 ```powershell
-%APPDATA%\terraform.d\plugins\${host_name}/${namespace}/${type}/${version}/${target}
+%APPDATA%\terraform.d\plugins\${host_name}\${namespace}\${type}\${version}\${target}
 ```
 ВНИМАНИЕ: для ОС Windows `%APP_DATA%` является каталогом, в котором будут помещены будущие файлы terraform.
 Где:
@@ -105,4 +97,80 @@ terraform init
 
 10. Если все прошло хорошо - ошибок не будет.  
 
-Более подробно о сборке провайдера можно найти по ссылке: [https://learn.hashicorp.com/tutorials/terraform/provider-use?in=terraform/providers](https://learn.hashicorp.com/tutorials/terraform/provider-use?in=terraform/providers)
+
+## Сборка из исходных кодов
+
+1. Скачайте и установите Go по ссылке: [https://go.dev/dl/](https://go.dev/dl/)
+2. Скачайте и установите terraform по ссылке: [https://learn.hashicorp.com/tutorials/terraform/install-cli?in=terraform/aws-get-started](https://learn.hashicorp.com/tutorials/terraform/install-cli?in=terraform/aws-get-started)
+3. Склонируйте репозиторий с провайдером, выполнив команду:
+```bash
+git clone https://github.com/rudecs/terraform-provider-decort.git
+```
+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. Добавьте в файл блок с инициализацией провайдера.
+```terraform
+provider "decort" {
+  authenticator = "oauth2"
+  #controller_url = <DECORT_CONTROLLER_URL>
+  controller_url = "https://mr4.digitalenergy.online"
+  #oauth2_url = <DECORT_SSO_URL>
+  oauth2_url           = "https://sso.digitalenergy.online"
+  allow_unverified_ssl = true
+}
+```
+
+9. В консоле выполнить команду 
+```bash
+terraform init
+```
+
+10. Если все прошло хорошо - ошибок не будет.  
+
+Более подробно о сборке провайдера можно найти по ссылке: [https://learn.hashicorp.com/tutorials/terraform/provider-use?in=terraform/providers](https://learn.hashicorp.com/tutorials/terraform/provider-use?in=terraform/providers)
+