Каждой странице консоли, которую ты заполнял в прошлом разделе, соответствует тип ресурса в Terraform, а каждому полю — строка в блоке. Перевести одно в другое — почти механическая работа, и в этом уроке ты её проделаешь: сеть, подсеть, группа безопасности и машина, только теперь текстом. Пять минут кликов при каждом новом стенде превратятся в apply и destroy за минуту.
Переводит описание в запросы к облаку провайдер Yandex Cloud — плагин yandex-cloud/yandex. Его делает сама команда облака, выпуски выходят почти каждую неделю, а в начале октября 2026 года свежая версия — 0.233. Ставится он с того же зеркала, которое ты настроил в первой практике.
С провайдером Docker всё было на твоей машине. Здесь добавится то, чего у Docker не было: провайдеру нужен доступ к облаку от имени сервисного аккаунта.
Подключить провайдер
Как и с Docker, провайдер объявляют в блоке required_providers.
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. Провайдер читает его и сам получает короткоживущий токен.
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 |
Подсеть ссылается на сеть, и в ней те же три поля, что ты заполнял руками: зона, диапазон и сеть.
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 для исходящего.
ingress { protocol = "TCP" port = 22 v4_cidr_blocks = ["0.0.0.0/0"] }
Читается как строка таблицы: входящий TCP на порт 22 от всего интернета. Правило на порт 80 — такой же блок с другим числом, а исходящее — блок egress с protocol = "ANY". Сам ресурс группы ещё ссылается на сеть полем network_id.
Сеть и правила готовы, но пустые: всё это было ради одной машины, и в её описании больше всего подвохов.
Машина
Описание машины — самое длинное, поэтому разберём его по кусочкам. Сначала образ: его идентификатор меняется с каждым обновлением Ubuntu, поэтому его не вписывают, а ищут data-блоком — блоком, который только читает из облака и ничего не создаёт.
data "yandex_compute_image" "ubuntu" { family = "ubuntu-2404-lts" }
Дальше внутри resource "yandex_compute_instance" — ресурсы машины, ровно поля из консоли.
resources { cores = 2 memory = 2 core_fraction = 20 } scheduling_policy { preemptible = true }
core_fraction — гарантированная доля vCPU, preemptible — прерываемая машина. Ниже — сеть и вход.
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, который велит не замечать смену образа после создания.
lifecycle { ignore_changes = [boot_disk[0].initialize_params[0].image_id] }
ignore_changes — список полей, на изменение которых Terraform не реагирует. Новые машины всё равно создаются из свежего образа, а старые не пересоздаются. Другой путь — вписать идентификатор образа строкой и менять его вручную, когда решишь обновиться.
Словарь урока
Что спросят на собеседовании
- Как ты дашь Terraform доступ к облаку?Заведу сервисный аккаунт с ролями только на нужный каталог, создам ему ключ, положу ключ вне репозитория и укажу путь к нему в настройке провайдера или в переменной окружения. В конвейере ключ будет в защищённой переменной CI.
- Почему идентификатор образа не вписывают в описание машины?Он меняется с каждым обновлением образа. Его находят data-блоком по семейству, а чтобы новый образ не пересоздал работающую машину, добавляют lifecycle с ignore_changes на image_id. Либо закрепляют идентификатор строкой и обновляют осознанно.
Что дальше
Дальше — практика: описываем ту же сеть, группу и машину, что ты создал руками, применяем, проверяем вход и удаляем всё одной командой.