Provision
—— XP

Провайдер Yandex Cloud

теория~6 минут+240 XP

Каждой странице консоли, которую ты заполнял в прошлом разделе, соответствует тип ресурса в Terraform, а каждому полю — строка в блоке. Перевести одно в другое — почти механическая работа, и в этом уроке ты её проделаешь: сеть, подсеть, группа безопасности и машина, только теперь текстом. Пять минут кликов при каждом новом стенде превратятся в apply и destroy за минуту.

Переводит описание в запросы к облаку провайдер Yandex Cloud — плагин yandex-cloud/yandex. Его делает сама команда облака, выпуски выходят почти каждую неделю, а в начале октября 2026 года свежая версия — 0.233. Ставится он с того же зеркала, которое ты настроил в первой практике.

С провайдером Docker всё было на твоей машине. Здесь добавится то, чего у Docker не было: провайдеру нужен доступ к облаку от имени сервисного аккаунта.

Подключить провайдер

Как и с Docker, провайдер объявляют в блоке required_providers.

versions.tf
terraform {
  required_providers {
    yandex = {
      source  = "yandex-cloud/yandex"
      version = "~> 0.233"
    }
  }
}

У версий 0.x запись ~> 0.233 разрешает обновления внутри 0.x, начиная с 0.233. Файл .terraform.lock.hcl после init закрепит конкретную версию, как в практике с Docker.

Подключить провайдер мало: ему нужен доступ к облаку.

Доступ через сервисный аккаунт

Terraform будет действовать от имени сервисного аккаунта provision-sa из прошлого раздела. Ему понадобятся две роли на каталог provision: compute.editor для машин и дисков и vpc.admin для сетей, групп безопасности и публичных адресов. Документация облака в примерах даёт роль editor — это проще, но шире, чем нужно.

Для входа сервисному аккаунту создают авторизованный ключ — файл JSON. Провайдер читает его и сам получает короткоживущий токен.

versions.tf, продолжение
provider "yandex" {
  service_account_key_file = pathexpand("~/devops-lab/secrets/tf-key.json")
  folder_id                = var.folder_id
  zone                     = "ru-central1-d"
}

pathexpand превращает ~ в путь к домашнему каталогу. folder_id — идентификатор каталога provision, его показывает yc config list; держим его в переменной. zone — зона по умолчанию для ресурсов, где зона не указана.

Сам файл ключа — это пароль от каталога. Он лежит в ~/devops-lab/secrets рядом со статическим ключом и в репозиторий не попадает.

Сеть и подсеть

Дальше — ресурсы. Сопоставим их со страницами консоли из прошлого раздела.

В консолиРесурс Terraform
VPC → Создать сетьyandex_vpc_network
Сеть → Создать подсетьyandex_vpc_subnet
Группы безопасности → Создатьyandex_vpc_security_group
Compute Cloud → Создать ВМyandex_compute_instance

Подсеть ссылается на сеть, и в ней те же три поля, что ты заполнял руками: зона, диапазон и сеть.

network.tf
resource "yandex_vpc_subnet" "main" {
  name           = "tf-subnet"
  zone           = "ru-central1-d"
  v4_cidr_blocks = ["10.10.1.0/24"]
  network_id     = yandex_vpc_network.main.id
}

Сама сеть описывается тремя строками, как в первом уроке раздела. Но машина в такой сети получит группу безопасности по умолчанию, а та, как ты помнишь, пускает весь трафик.

Группа безопасности

Каждое правило из таблицы прошлого раздела становится блоком ingress для входящего трафика или egress для исходящего.

network.tf, продолжение
  ingress {
    protocol       = "TCP"
    port           = 22
    v4_cidr_blocks = ["0.0.0.0/0"]
  }

Читается как строка таблицы: входящий TCP на порт 22 от всего интернета. Правило на порт 80 — такой же блок с другим числом, а исходящее — блок egress с protocol = "ANY". Сам ресурс группы ещё ссылается на сеть полем network_id.

Сеть и правила готовы, но пустые: всё это было ради одной машины, и в её описании больше всего подвохов.

Машина

Описание машины — самое длинное, поэтому разберём его по кусочкам. Сначала образ: его идентификатор меняется с каждым обновлением Ubuntu, поэтому его не вписывают, а ищут data-блоком — блоком, который только читает из облака и ничего не создаёт.

vm.tf
data "yandex_compute_image" "ubuntu" {
  family = "ubuntu-2404-lts"
}

Дальше внутри resource "yandex_compute_instance" — ресурсы машины, ровно поля из консоли.

vm.tf, блоки машины
  resources {
    cores         = 2
    memory        = 2
    core_fraction = 20
  }
  scheduling_policy {
    preemptible = true
  }

core_fraction — гарантированная доля vCPU, preemptible — прерываемая машина. Ниже — сеть и вход.

vm.tf, сеть и доступ
  network_interface {
    subnet_id          = yandex_vpc_subnet.main.id
    nat                = true
    security_group_ids = [yandex_vpc_security_group.web.id]
  }

nat = true — та самая галочка «Публичный адрес: автоматически». Загрузочный диск задаётся блоком boot_disk со ссылкой на образ, а SSH-ключ — строкой ssh-keys в metadata в виде логин:открытый_ключ. Полное описание со всеми полями — в документации ресурса и в практике следом.

Этого хватает, чтобы машина создалась. Одну вещь добавляют сверху, когда машина уже работает. У data-блока с образом есть обратная сторона: вышел новый образ — data-блок вернёт новый идентификатор, а смена образа у загрузочного диска — это forces replacement. Следующий plan покажет у работающей машины -/+: новая машина с пустым диском и новым адресом. Чтобы так не случилось, в ресурс машины добавляют блок lifecycle, который велит не замечать смену образа после создания.

vm.tf, внутри resource машины
  lifecycle {
    ignore_changes = [boot_disk[0].initialize_params[0].image_id]
  }

ignore_changes — список полей, на изменение которых Terraform не реагирует. Новые машины всё равно создаются из свежего образа, а старые не пересоздаются. Другой путь — вписать идентификатор образа строкой и менять его вручную, когда решишь обновиться.

Словарь урока

yandex-cloud/yandex
Провайдер Terraform для Yandex Cloud, ставится с зеркала terraform-mirror.yandexcloud.net.
Авторизованный ключ
Файл JSON сервисного аккаунта, по которому провайдер получает доступ к облаку. ↩ к тексту
Data-блок
Блок, который только читает данные из облака, например идентификатор образа, и ничего не создаёт. ↩ к тексту
ingress и egress
Входящие и исходящие правила группы безопасности.
ignore_changes
Список полей в блоке lifecycle, изменения которых Terraform не замечает после создания ресурса.

Что спросят на собеседовании

  • Как ты дашь Terraform доступ к облаку?
    Заведу сервисный аккаунт с ролями только на нужный каталог, создам ему ключ, положу ключ вне репозитория и укажу путь к нему в настройке провайдера или в переменной окружения. В конвейере ключ будет в защищённой переменной CI.
  • Почему идентификатор образа не вписывают в описание машины?
    Он меняется с каждым обновлением образа. Его находят data-блоком по семейству, а чтобы новый образ не пересоздал работающую машину, добавляют lifecycle с ignore_changes на image_id. Либо закрепляют идентификатор строкой и обновляют осознанно.

Что дальше

Дальше — практика: описываем ту же сеть, группу и машину, что ты создал руками, применяем, проверяем вход и удаляем всё одной командой.

Проверь себя+240 XPдве попытки
1
Доступ
От чьего имени Terraform лучше создавать ресурсы в облаке?
2
Образ
Зачем в описании машины data-блок yandex_compute_image с family?
3
Машина
Какая строка в описании машины даёт ей публичный адрес?
ответь на все вопросы, чтобы проверить

Нашёл ошибку или непонятное место? Наведи на абзац — слева появится «+», нажми и напиши, что не так. Замечание увидит автор курса.Нашёл ошибку или непонятное место? Нажми «+» справа от заголовка раздела и напиши, что не так. Замечание увидит автор курса.