From f6e255e7968c153d570cdd70146ddb8e62b0f8fa Mon Sep 17 00:00:00 2001
From: stSolo <st.solp@gmail.com>
Date: Fri, 25 Mar 2022 17:54:47 +0300
Subject: [PATCH] Add a manual terraform provider installing guide

---
 04.-Обзор-Terraform-провайдера-DECORT..md | 62 ++++++++++++++++++++++-
 1 file changed, 61 insertions(+), 1 deletion(-)

diff --git a/04.-Обзор-Terraform-провайдера-DECORT..md b/04.-Обзор-Terraform-провайдера-DECORT..md
index 5e861f5..b29df22 100644
--- a/04.-Обзор-Terraform-провайдера-DECORT..md
+++ b/04.-Обзор-Terraform-провайдера-DECORT..md
@@ -38,4 +38,64 @@ terraform apply
 
 ## Сборка из исходных кодов
 
-THIS PAGE IS UNDER DEVELOPMENT AT THE MOMENT. INFORMATION CONTAINED HEREIN MAY BE INCOMPLETE OR INCORRECT UNTIL THIS NOTICE IS REMOVED.
\ No newline at end of file
+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. В консоле выполнить команду 
+```bash
+terraform init
+```
+
+9. Если все прошло хорошо - ошибок не будет.  
+
+Более подробно о сборке провайдера можно найти по ссылке: [https://learn.hashicorp.com/tutorials/terraform/provider-use?in=terraform/providers](https://learn.hashicorp.com/tutorials/terraform/provider-use?in=terraform/providers)
\ No newline at end of file