Add samples repo, rename README.md to README_EN.md, add README.md (RU Version), update README files

README.md

@@ -1,55 +1,114 @@
 # terraform-provider-decort
-Terraform provider for Digital Energy Cloud Orchestration Technology (DECORT) platform
+Terraform provider для платформы Digital Energy Cloud Orchestration Technology (DECORT)
 
-NOTE: provider rc-1.25 is designed for DECORT API 3.7.x. For older API versions please use:
+Внимание: провайдер версии rc-1.25 разработан для DECORT API 3.7.x.  
-- DECORT API 3.6.x versions - provider version rc-1.10
+Для более старых версий можно использовать:
-- DECORT API versions prior to 3.6.0 - Terraform DECS provider (https://github.com/rudecs/terraform-provider-decs)
+- DECORT API 3.6.x - версия провайдера rc-1.10
+- DECORT API до 3.6.0 - terraform DECS provider (https://github.com/rudecs/terraform-provider-decs)
 
-With this provider you can manage Compute instances, disks, virtual network segments and resource 
+## Возможности провайдера
-groups in DECORT platform, as well as query the platform for information about existing resources. 
+- Работа с Compute instances, 
-This provider supports Import operations on pre-existing resources.
+- Работа с disks, 
+- Работа с k8s,
+- Работа с virtual network segments,
+- Работа с image,
+- Работа с reource groups,
+- Работа с VINS,
+- Работа с pfw,
+- Работа с accounts.
 
-See user guide at https://github.com/rudecs/terraform-provider-decort/wiki
+Вики проекта: https://github.com/rudecs/terraform-provider-decort/wiki
 
-For a quick start follow these steps (assuming that your build host is running Linux; this provider builds on Windows as well, however, some paths may differ from what is mentioned below).
+## Начало
+Старт возможен по двум путям:  
+1. Установка через собранные пакеты.
+2. Ручная установка.
 
-1. Obtain the latest GO compiler. As of beginning 2021 it is recommended to use v.1.16.3 but as new Terraform versions are released newer Go compiler may be required, so check official Terraform repository regularly for more information.
+### Установка через собранные пакеты.
+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
+}
 ```
-    cd /tmp
+3. Выполните команду
-    wget https://golang.org/dl/go1.16.3.linux-amd64.tar.gz
-    tar xvf ./go1.16.3.linux-amd64.tar.gz
-    sudo mv go /usr/local
 ```
+terraform init
+```
+Провайдер автоматически будет установлен на ваш компьютер из terraform registry.
 
-2. Add the following environment variables' declarations to shell startup script:
+### Ручная установка
-```
+1. Скачайте и установите Go по ссылке: https://go.dev/dl/
-    export GOPATH=/opt/gopkg:~/
+2. Скачайте и установите terraform по ссылке: https://learn.hashicorp.com/tutorials/terraform/install-cli?in=terraform/aws-get-started
-    export GOROOT=/usr/local/go
+3. Склонируйте репозиторий с провайдером, выполнив команду:
-    export PATH=$PATH:$GOROOT/bin
+```bash
-```
-
-3. Clone Terraform Plugin SDK framework repository to $GOPKG/src/github.com/hashicorp
-```
-    mkdir -p $GOPKG/src/github.com/hashicorp
-    cd $GOPKG/src/github.com/hashicorp
-    git clone https://github.com/hashicorp/terraform-plugin-sdk.git
-```
-
-4. Clone jwt-go package repository to $GOPKG/src/github.com/dgrijalva/jwt-go:
-```
-    mkdir -p $GOPKG/src/github.com/dgrijalva
-    cd $GOPKG/src/github.com/dgrijalva
-    git clone https://github.com/dgrijalva/jwt-go.git
-```
-
-5. Clone Terraform DECORT provider repository to $GOPKG/src/github.com/terraform-provider-decort
-```
-    cd $GOPKG/src/github.com
 git clone https://github.com/rudecs/terraform-provider-decort.git
 ```
-
+4. Перейдите в скачанную папку с провайдером и выполните команду
-6. Build Terraform DECORT provider:
+```bash
-```
-    cd $GOPKG/src/github.com/terraform-provider-decort
 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://github.com/rudecs/terraform-provider-decort/wiki
+- В папке `samples`
+
+Хорошей работы!

README_EN.md

@@ -0,0 +1,115 @@
+# terraform-provider-decort
+Terraform provider for Digital Energy Cloud Orchestration Technology (DECORT) platform
+
+NOTE: provider rc-1.25 is designed for DECORT API 3.7.x. For older API versions please use:
+- DECORT API 3.6.x versions - provider version rc-1.10
+- DECORT API versions prior to 3.6.0 - Terraform DECS provider (https://github.com/rudecs/terraform-provider-decs)
+
+## Features
+- Work with Compute instances, 
+- Work with disks, 
+- Work with k8s,
+- Work with virtual network segments,
+- Work with image,
+- Work with reource groups,
+- Work with VINS,
+- Work with pfw,
+- Work with accounts.
+
+This provider supports Import operations on pre-existing resources.
+
+See user guide at https://github.com/rudecs/terraform-provider-decort/wiki
+
+
+## Get Started
+Two ways for starting:  
+1. Installing via binary packages
+2. Manual installing
+
+### Installing via binary packages
+1. Download and install terraform: https://learn.hashicorp.com/tutorials/terraform/install-cli?in=terraform/aws-get-started
+2. Create a file `main.tf` and add to it next section.
+```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. Execute next command
+```
+terraform init
+```
+The Provider will automatically install on your computer from the terrafrom registry.
+
+### Manual installing
+1. Download and install Go Programming Language: https://go.dev/dl/
+2. Download and install terraform: https://learn.hashicorp.com/tutorials/terraform/install-cli?in=terraform/aws-get-started
+3. Clone provider's repo:
+```bash
+git clone https://github.com/rudecs/terraform-provider-decort.git
+```
+4. Change directory to clone provider's and execute next command
+```bash
+go build -o terraform-provider-decort
+```
+If you have experience with _makefile_, you can change `Makefile`'s paramters and execute next command
+```bash
+make build
+```
+5. Now move compilled file to:  
+Linux:
+```bash
+~/.terraform.d/plugins/${host_name}/${namespace}/${type}/${version}/${target}
+```
+Windows:
+```powershell
+%APPDATA%\terraform.d\plugins\${host_name}/${namespace}/${type}/${version}/${target}
+```
+NOTE: for Windows OS `%APP_DATA%` is a cataloge, where will place terraform files.
+Example:
+- host_name - digitalenergy.online
+- namespace - decort 
+- type - decort
+- version - 1.2
+- target - windows_amd64
+6. After all, create a file `main.tf`.
+7. Add to the file next code section
+```terraform
+terraform {
+  required_providers {
+    decort = {
+      version = "1.2"
+      source  = "digitalenergy.online/decort/decort"
+    }
+  }
+}
+```
+`version`- field for provider's version
+Required
+String
+Note: Versions in code section and in a repository must be equal!
+
+`source` - path to repository with provider's version
+```bash
+${host_name}/${namespace}/${type}
+```
+NOTE: all paramters must be equal to the repository path!
+
+8. Execute command in your terminal 
+```bash
+terraform init
+```
+
+9. If everything all right - you got green message in your terminal!
+
+More details about the provider's building process: https://learn.hashicorp.com/tutorials/terraform/provider-use?in=terraform/providers
+
+## Examples and Samples
+- Examples: https://github.com/rudecs/terraform-provider-decort/wiki
+- Samples: in repository `samples`
+
+Good work!