В разделе про облако ты собрал машину руками за двадцать минут кликов. Сейчас опишешь то же самое текстом, создашь одной командой и одной же удалишь. Имена ресурсов с приставкой tf-, чтобы не путать их с ручными.
Работаем на стенде, где уже стоят Terraform, yc и файл ~/.terraformrc с зеркалом. Полный пример описания машины есть в документации Yandex Cloud — открой его рядом, если строка из шага не сходится.
Шаг 1. Роли сервисному аккаунту
Сервисному аккаунту provision-sa нужны права на машины и сети в каталоге provision.
- В консоли открой каталог
provision, вкладку «Права доступа». - Нажми «Назначить роли» и выбери
provision-sa. - Добавь роли
compute.editorиvpc.admin. Нажми «Сохранить».
yc resource-manager folder list-access-bindings provision+----------------+----------------+-----------+ | ROLE ID | SUBJECT TYPE | SUBJECT ID | +----------------+----------------+-----------+ | storage.editor | serviceAccount | ajeq3n… | | compute.editor | serviceAccount | ajeq3n… | | vpc.admin | serviceAccount | ajeq3n… | +----------------+----------------+-----------+
Три роли у одного сервисного аккаунта, и ни одной общей вроде editor.
Шаг 2. Авторизованный ключ
- В IAM открой
provision-sa, нажми «Создать новый ключ», затем «Создать авторизованный ключ». - Нажми «Создать», потом «Скачать файл с ключами».
- Файл скачался на твою машину, а нужен на стенде. Перенеси его через
scpиз раздела 03: сначала в каталог загрузок.
cd ~/Downloadsscp authorized_key.json stand:devops-lab/secrets/tf-key.jsonЕсли файл называется иначе, подставь своё имя. Путь после двоеточия считается от домашнего каталога на стенде. Дальше снова на стенде: как и со статическим ключом, закрой файл от чужих глаз.
chmod 600 ~/devops-lab/secrets/tf-key.jsonШаг 3. Каталог и провайдер
Описание облака держим отдельно от учебного Docker, в своём каталоге.
mkdir -p ~/infra/terraform-yc cd ~/infra/terraform-yc
Файл versions.tf — блок terraform с провайдером yandex-cloud/yandex версии ~> 0.233 и блок provider "yandex" с ключом, каталогом и зоной. Оба куска — из прошлого урока, перепиши их в файл.
Шаг 4. Переменная каталога
Идентификатор каталога возьми из yc config list, строка folder-id.
variable "folder_id" { type = string }
folder_id = "b1g4p7…"Без default переменная обязательна, и значение придёт из terraform.tfvars. Этот файл под правилом *.tfvars в .gitignore.
Шаг 5. Сеть — и сразу в облако
Начнём с одного ресурса: сети. От неё зависят все остальные, и на ней проще всего проверить, что ключ, роли и провайдер работают.
resource "yandex_vpc_network" "main" { name = "tf-net" }
Скачай провайдер и проверь описание:
terraform init- Installing yandex-cloud/yandex v0.233.0... Terraform has been successfully initialized!
terraform fmt terraform validate
Success! The configuration is valid.fmt выравнивает отступы по канону и печатает имена исправленных файлов. validate ловит опечатки и незакрытые скобки; если он ругается, в ошибке будет имя файла и номер строки. Теперь Terraform впервые спросит облако, что в нём есть:
terraform plan+ resource "yandex_vpc_network" "main" { + name = "tf-net" } Plan: 1 to add, 0 to change, 0 to destroy.
Если вместо плана пришло PermissionDenied, у сервисного аккаунта не хватает роли — вернись к шагу 1. Применяй:
terraform applyyandex_vpc_network.main: Creation complete after 3s Apply complete! Resources: 1 added, 0 changed, 0 destroyed.
apply ещё раз показывает план и ждёт yes. Сеть tf-net появилась в консоли — цепочка «описание → облако» работает.
Шаг 6. Подсеть
Ниже в network.tf — подсеть yandex_vpc_subnet.main из прошлого урока: имя tf-subnet, зона ru-central1-d, диапазон 10.10.1.0/24 и ссылка на сеть.
terraform applyyandex_vpc_network.main: Refreshing state... [id=enp1…] yandex_vpc_subnet.main: Creation complete after 1s Apply complete! Resources: 1 added, 0 changed, 0 destroyed.
Refreshing state — Terraform сверил сеть с облаком и не тронул её: она уже такая, как в описании. Добавилась только подсеть.
Шаг 7. Группа безопасности: только вход по SSH
Как в разделе про облако, начинаем с минимума — порт 22 для входа и исходящее, чтобы машина могла скачивать пакеты. Шапка ресурса:
resource "yandex_vpc_security_group" "web" { name = "tf-sg" network_id = yandex_vpc_network.main.id
Внутрь — правило ingress на TCP 22 из прошлого урока и исходящее:
egress { protocol = "ANY" v4_cidr_blocks = ["0.0.0.0/0"] } }
Последняя скобка закрывает ресурс группы. Примени — добавится один ресурс.
terraform applyyandex_vpc_security_group.web: Creation complete after 2s Apply complete! Resources: 1 added, 0 changed, 0 destroyed.
Шаг 8. Минимальная машина
В vm.tf сначала data-блок образа ubuntu-2404-lts из прошлого урока. Потом шапка машины.
resource "yandex_compute_instance" "web" { name = "tf-vm" platform_id = "standard-v3" zone = "ru-central1-d"
platform_id — поколение процессоров, на котором облако запустит машину. В консоли это поле «Платформа», и по умолчанию там стоит Intel Ice Lake — это и есть standard-v3. Без этой строки провайдер возьмёт старую standard-v1 (Intel Broadwell, медленнее). Пишем её сразу: сменить платформу у созданной машины можно только с её остановкой, а без разрешения allow_stopping_for_update = true провайдер такое изменение не применит.
Дальше внутрь — блоки resources и scheduling_policy из прошлого урока и загрузочный диск:
boot_disk { initialize_params { image_id = data.yandex_compute_image.ubuntu.id size = 10 } }
Потом блок network_interface из прошлого урока — с подсетью, группой tf-sg и nat = true для публичного адреса — и вход по ключу:
metadata = { ssh-keys = "devops:${file(pathexpand("~/.ssh/id_ed25519.pub"))}" } }
file читает файл и подставляет его содержимое. Получится та же строка devops:ssh-ed25519 AAAA…, что ты вставлял в консоль. Последняя скобка закрывает ресурс.
Кто превращает эту строку в пользователя? На каждом облачном образе Ubuntu стоит cloud-init — программа, которая при первой загрузке машины читает метаданные из облака. Из ssh-keys она создаёт пользователя devops, кладёт ему ключ в ~/.ssh/authorized_keys и разрешает sudo — ровно то, что консоль делала по полям «Логин» и «SSH-ключ». Для большего, например списка пакетов или нескольких пользователей, в метаданные кладут ключ user-data с настройкой cloud-init; это описано в документации Yandex Cloud.
terraform applyyandex_compute_instance.web: Still creating... [30s elapsed] yandex_compute_instance.web: Creation complete after 41s Apply complete! Resources: 1 added, 0 changed, 0 destroyed.
Машина создаётся дольше всего, около минуты. Её адрес Terraform пока не печатает — найди его в таблице:
yc compute instance list+--------+-------+---------------+---------+---------------+-------------+ | ID | NAME | ZONE ID | STATUS | EXTERNAL IP | INTERNAL IP | +--------+-------+---------------+---------+---------------+-------------+ | fv4q… | tf-vm | ru-central1-d | RUNNING | 158.160.40.11 | 10.10.1.21 | +--------+-------+---------------+---------+---------------+-------------+
ssh devops@158.160.40.11devops@tf-vm:~$Вход по ключу работает так же, как с ручной машиной. Если пришёл Permission denied (publickey) в первую минуту после создания, подожди: cloud-init ещё создаёт пользователя. Выйди командой exit.
Шаг 9. Адрес — выходным значением
Искать адрес в таблице после каждого создания неудобно. Пусть Terraform отдаёт его сам.
output "public_ip" { value = yandex_compute_instance.web.network_interface[0].nat_ip_address }
network_interface[0] — первая сетевая карта машины, nat_ip_address — её публичный адрес.
terraform applyChanges to Outputs: + public_ip = "158.160.40.11" Apply complete! Resources: 0 added, 0 changed, 0 destroyed. Outputs: public_ip = "158.160.40.11"
Ресурсы не менялись, добавилось только выходное значение. Повторить его можно в любой момент командой terraform output public_ip.
Шаг 10. Порт 80
Проверь, что видно снаружи на порту сайта:
curl -I --max-time 5 http://158.160.40.11curl: (28) Connection timed out after 5001 millisecondsТаймаут — пакеты отбросила группа безопасности, как в разделе про облако. Допиши в группу tf-sg второй ingress — такой же, как на 22, только port = 80 — и примени.
terraform apply~ resource "yandex_vpc_security_group" "web" { name = "tf-sg" + ingress { … port = 80 … } } Plan: 0 to add, 1 to change, 0 to destroy. yandex_vpc_security_group.web: Modifications complete after 2s
Знак ~ — изменение на месте: группа та же, правило добавилось, машину никто не трогал. Повтори запрос:
curl -I --max-time 5 http://158.160.40.11curl: (7) Failed to connect to 158.160.40.11 port 80: Connection refusedConnection refused, а не таймаут: группа безопасности пропустила запрос, но nginx на машине нет. Это ровно то, что мы описали, — Terraform создаёт машину, а ставить на неё программы будет Ansible в миссии.
Шаг 11. Защита от нового образа
Data-блок каждый раз берёт последний образ семейства ubuntu-2404-lts. Когда Yandex выпустит новый, plan покажет, что машину надо пересоздать: идентификатор образа в диске изменился, а он задаётся только при создании. Пересоздание — это новая пустая машина и новый адрес. Чтобы этого не случилось, в конец ресурса машины, перед последней скобкой, добавь блок lifecycle из прошлого урока.
terraform planNo changes. Your infrastructure matches the configuration.lifecycle ничего не меняет в облаке — он меняет поведение самого Terraform, поэтому план пустой. Другой путь — закрепить конкретный image_id вместо data-блока и обновлять его осознанно; так делают, когда образ собирают сами.
Шаг 12. Удалить всё
Учебная машина стоит денег, поэтому сразу после проверки удаляем всё.
terraform destroyPlan: 0 to add, 0 to change, 4 to destroy. Enter a value: yes yandex_compute_instance.web: Destruction complete after 32s yandex_vpc_security_group.web: Destruction complete after 1s yandex_vpc_subnet.main: Destruction complete after 4s yandex_vpc_network.main: Destruction complete after 1s Destroy complete! Resources: 4 destroyed.
Обратный порядок: машина первой, сеть последней — тот самый, который ты соблюдал руками в уроке про уборку. Проверь yc compute instance list: таблица пустая.
Шаг 13. План с нуля
Описание осталось — а значит, всё можно поднять заново одной командой. Посмотри, что Terraform собрался бы создать сейчас:
terraform planPlan: 4 to add, 0 to change, 0 to destroy. Changes to Outputs: + public_ip = (known after apply)
Четыре ресурса — ровно четыре страницы консоли из прошлого раздела, которые ты собирал по одной. Образ в план не попадает: data-блок только читает. Скопируй строку Plan: в отчёт. Применять не нужно.
Шаг 14. Отчёт
Запиши итоги плана, применения и удаления — их проверит команда сдачи.
Машина в облаке из описания — 01.10.2026 Plan: 4 to add, 0 to change, 0 to destroy. apply по одному ресурсу: сеть -> подсеть -> группа -> машина curl на 80: таймаут без правила curl на 80: Connection refused — сеть пропустила, nginx нет Destroy complete! Resources: 4 destroyed. Руками в консоли было 20 минут, повторить описанием — минута
Сдай задание командой из блока проверки.
Что дальше
Состояние пока лежит файлом в каталоге, и вдвоём так не поработать. Дальше — где хранить состояние в команде, что делать с ресурсами, созданными руками, и как Terraform живёт в конвейере.