Установка и настройка Terraform для работы с Cloud.ru Advanced

Установка Terraform и создание конфигурационных файлов

1. Установите Terraform.

   Если не удается скачать Terraform с сайта Hashicorp, скачайте Terraform из публичного зеркала.

2. Войдите в консоль управления Advanced как IAM-пользователь и сгенерируйте ключи авторизации Access Key (AK) и Secret Key (SK).

   Примечание

   Убедитесь, что у IAM-пользователя, для которого вы создаете AK/SK, включен тип доступа Programmatic access. Проверить и активировать опцию можно в консоли управления на странице IAM-пользователя в поле Access Type.

3. Создайте на вашем устройстве каталог, в котором будут храниться конфигурационные файлы.

   Например, terraform-cloud.

4. Создайте конфигурационный файл с расширением .tf.

   Например, main.tf.

5. Чтобы подключить провайдер Terraform для Cloud.ru Advanced, добавьте в начало конфигурационного файла код инициализации провайдера и переменные:

   terraform {
     required_providers {
       sbercloud = {
         source  = "sbercloud-terraform/sbercloud" # Initialize Advanced provider
       }
     }
   }
   
   # Configure Advanced provider
   provider "sbercloud" {
     auth_url = "https://iam.ru-moscow-1.hc.sbercloud.ru/v3" # Authorization address
     region   = "ru-moscow-1" # The region where the cloud infrastructure will be deployed
   
     # Authorization keys
     access_key = var.access_key
     secret_key = var.secret_key
   }
   
   

   Где var.access_key и var.secret_key — это переменные, в которых хранятся AK/SK.

6. В каталоге с конфигурационным файлом .tf создайте файл variables.tf для хранения переменных.

7. Добавьте в файл variables.tf шаблон для использования переменных:

   variable "access_key" {
           default = "access-key-id"
   }
   
   variable "secret_key" {
           default = "secret-access-key"
   }
   
   

   Где access-key-id и secret-access-key замените на соответствующие значения из файла credentials.csv.

8. Создайте конфигурационный файл CLI:

   ---

   Windows

   Linux/macOS

   terraform.rc — название файла в Windows. Поместите его в каталог %APPDATA%, путь к которому зависит от версии Windows и конфигурации системы. Узнать путь к каталогу можно в PowerShell с помощью команды $env:APPDATA.

   Примечание

   С помощью переменной среды TF_CLI_CONFIG_FILE можно задать нестандартное расположение файла конфигурации CLI:

   

   В этом случае конфигурационный файл должен иметь расширение .tfrc.

9. Добавьте в конфигурационный файл CLI (.terraformrc или terraform.rc) блок:

   provider_installation {
      network_mirror {
         url = "https://terraform.cloud.ru/"
         include = ["registry.terraform.io/*/*"]
      }
      direct {
         exclude = ["registry.terraform.io/*/*"]
      }
   }
   
   

   Где https://terraform.cloud.ru/ — адрес публичного зеркала.