Начало работы с Terraform

Terraform позволяет управлять облачной инфраструктурой Рег.облака как кодом. Вместо того чтобы работать с ресурсами через панель управления, вы описываете желаемую инфраструктуру в конфигурационных файлах. Эти файлы используют HCL (HashiCorp Configuration Language) — простой язык, который по структуре похож на JSON или YAML. Terraform анализирует файлы и выполняет нужные действия (создает, обновляет или удаляет ресурсы), чтобы привести инфраструктуру к тому виду, который вы описали.

Terraform делает инфраструктуру прозрачной, повторяемой и контролируемой. Конфигурации можно хранить в репозитории, версионировать и использовать повторно, например, для развертывания одинаковой инфраструктуры в различных средах. Кроме того, вы всегда точно сможете узнать, что и где развернуто. Terraform работает по одному и тому же принципу на разных платформах, но у каждого облака есть свой провайдер. Описания ресурсов у разных провайдеров могут отличаться, но подходы и инструменты будут одинаковыми независимо от того, на какой платформе строите решения. Это снижает риск ошибок, ускоряет развертывание и делает инфраструктуру предсказуемой.

Какими ресурсами можно управлять с помощью Terraform в Рег.облаке

На данный момент в Рег.облаке с помощью Terraform можно управлять:

Подготовка к работе с Terraform

Установка Terraform

Из бинарного файла

Скачайте дистрибутив Terraform и установите его по инструкции.

Через менеджер пакетов

sudo snap install terraform --classic

brew install terraform

choco install terraform

Аутентификация в Terraform

В Terraform все операции выполняются от имени вашего аккаунта. Для аутентификации в Terraform используется токен для API. Получить или изменить токен вы можете в панели управления в разделе Настройки.

Чтобы настроить аутентификацию:

export TF_VAR_token=“your-token”

$env:TF_VAR_token=“your-token”

Настройка провайдера

В Terraform провайдер — это плагин, который обеспечивает взаимодействие Terraform с внешними сервисами через их API. Он отвечает за создание, изменение и удаление ресурсов конкретного сервиса. Без провайдера Terraform не сможет управлять инфраструктурой.

Чтобы настроить провайдера:

Подготовка плана инфраструктуры

В примере ниже мы добавим в файл main.tf конфигурацию, с помощью которой будут созданы следующие ресурсы:

terraform {
   required_providers {
     regcloud = {
       source = "tf.reg.cloud/regru/regcloud"
     }
   }
 }


provider "regcloud" {
  token   = var.token
  api_url = var.api_url
}

resource "regcloud_ssh_key" "test" {
  name       = "example_key"
  public_key = file("./assets/id_rsa_example.pub")
}

output "ssh_key_fingerprint" {
  value = regcloud_ssh_key.test.fingerprint
}

output "ssh_key_name" {
  value = regcloud_ssh_key.test.name
}

resource "regcloud_server" "example_server" {
  name        = "example_server_001"
  size        = "c1-m1-d10-hp"
  image       = "ubuntu-24-04-amd64-docker"
  region_slug = "openstack-msk1"
  ssh_keys    = [regcloud_ssh_key.test.fingerprint]
  isp_license_size = null
  backups     = false
}

output "server_id" {
  value = regcloud_server.example_server.server_id
}

output "created_at" {
  value = regcloud_server.example_server.created_at
}

output "size" {
  value = regcloud_server.example_server.size
}

output "snapshot_created_at" {
  value = regcloud_server_snapshot.example.created_at
}

output "distribution" {
  value = regcloud_server_snapshot.example.distribution
}

output "min_disk_size" {
  value = regcloud_server_snapshot.example.min_disk_size
}

output "size_gigabytes" {
  value = regcloud_server_snapshot.example.size_gigabytes
}

Проверка конфигурации

Для проверки файла main.tf на наличие синтаксических ошибок введите команду:

terraform validate

Если ошибок нет, вы увидите следующее сообщение:

Success! The configuration is valid.

Создание ресурсов

Удаление ресурсов

Для удаления всех ресурсов введите команду:

terraform destroy

Чтобы подтвердить операцию, введите yes и нажмите Enter.