Provision
—— XP

Практика: машина в Yandex Cloud из описания

практика~50 минут+600 XP

В разделе про облако ты собрал машину руками за двадцать минут кликов. Сейчас опишешь то же самое текстом, создашь одной командой и одной же удалишь. Имена ресурсов с приставкой tf-, чтобы не путать их с ручными.

Работаем на стенде, где уже стоят Terraform, yc и файл ~/.terraformrc с зеркалом. Полный пример описания машины есть в документации Yandex Cloud — открой его рядом, если строка из шага не сходится.

Шаг 1. Роли сервисному аккаунту

Сервисному аккаунту provision-sa нужны права на машины и сети в каталоге provision.

  1. В консоли открой каталог provision, вкладку «Права доступа».
  2. Нажми «Назначить роли» и выбери provision-sa.
  3. Добавь роли compute.editor и vpc.admin. Нажми «Сохранить».
ubuntu@stand:~$
yc resource-manager folder list-access-bindings provision
ubuntu@stand:~$
+----------------+----------------+-----------+
|    ROLE ID     |  SUBJECT TYPE  | SUBJECT ID |
+----------------+----------------+-----------+
| storage.editor | serviceAccount | ajeq3n…    |
| compute.editor | serviceAccount | ajeq3n…    |
| vpc.admin      | serviceAccount | ajeq3n…    |
+----------------+----------------+-----------+

Три роли у одного сервисного аккаунта, и ни одной общей вроде editor.

Шаг 2. Авторизованный ключ

  1. В IAM открой provision-sa, нажми «Создать новый ключ», затем «Создать авторизованный ключ».
  2. Нажми «Создать», потом «Скачать файл с ключами».
  3. Файл скачался на твою машину, а нужен на стенде. Перенеси его через scp из раздела 03: сначала в каталог загрузок.
своя машина
cd ~/Downloads
своя машина
scp authorized_key.json stand:devops-lab/secrets/tf-key.json

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

ubuntu@stand:~$
chmod 600 ~/devops-lab/secrets/tf-key.json

Шаг 3. Каталог и провайдер

Описание облака держим отдельно от учебного Docker, в своём каталоге.

ubuntu@stand:~$
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.

nano ~/infra/terraform-yc/variables.tf
variable "folder_id" {
  type = string
}
nano ~/infra/terraform-yc/terraform.tfvars
folder_id = "b1g4p7…"

Без default переменная обязательна, и значение придёт из terraform.tfvars. Этот файл под правилом *.tfvars в .gitignore.

Шаг 5. Сеть — и сразу в облако

Начнём с одного ресурса: сети. От неё зависят все остальные, и на ней проще всего проверить, что ключ, роли и провайдер работают.

nano ~/infra/terraform-yc/network.tf
resource "yandex_vpc_network" "main" {
  name = "tf-net"
}

Скачай провайдер и проверь описание:

ubuntu@stand:~$
terraform init
ubuntu@stand:~$
- Installing yandex-cloud/yandex v0.233.0...
Terraform has been successfully initialized!
ubuntu@stand:~$
terraform fmt
terraform validate
ubuntu@stand:~$
Success! The configuration is valid.

fmt выравнивает отступы по канону и печатает имена исправленных файлов. validate ловит опечатки и незакрытые скобки; если он ругается, в ошибке будет имя файла и номер строки. Теперь Terraform впервые спросит облако, что в нём есть:

ubuntu@stand:~$
terraform plan
ubuntu@stand:~$
  + resource "yandex_vpc_network" "main" {
      + name = "tf-net"
    }

Plan: 1 to add, 0 to change, 0 to destroy.

Если вместо плана пришло PermissionDenied, у сервисного аккаунта не хватает роли — вернись к шагу 1. Применяй:

ubuntu@stand:~$
terraform apply
ubuntu@stand:~$
yandex_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 и ссылка на сеть.

ubuntu@stand:~$
terraform apply
ubuntu@stand:~$
yandex_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 для входа и исходящее, чтобы машина могла скачивать пакеты. Шапка ресурса:

~/infra/terraform-yc/network.tf, в конец
resource "yandex_vpc_security_group" "web" {
  name       = "tf-sg"
  network_id = yandex_vpc_network.main.id

Внутрь — правило ingress на TCP 22 из прошлого урока и исходящее:

network.tf, последнее правило группы
  egress {
    protocol       = "ANY"
    v4_cidr_blocks = ["0.0.0.0/0"]
  }
}

Последняя скобка закрывает ресурс группы. Примени — добавится один ресурс.

ubuntu@stand:~$
terraform apply
ubuntu@stand:~$
yandex_vpc_security_group.web: Creation complete after 2s

Apply complete! Resources: 1 added, 0 changed, 0 destroyed.

Шаг 8. Минимальная машина

В vm.tf сначала data-блок образа ubuntu-2404-lts из прошлого урока. Потом шапка машины.

nano ~/infra/terraform-yc/vm.tf, после data-блока
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 из прошлого урока и загрузочный диск:

vm.tf, загрузочный диск
  boot_disk {
    initialize_params {
      image_id = data.yandex_compute_image.ubuntu.id
      size     = 10
    }
  }

Потом блок network_interface из прошлого урока — с подсетью, группой tf-sg и nat = true для публичного адреса — и вход по ключу:

vm.tf, доступ
  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.

ubuntu@stand:~$
terraform apply
ubuntu@stand:~$
yandex_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 пока не печатает — найди его в таблице:

ubuntu@stand:~$
yc compute instance list
ubuntu@stand:~$
+--------+-------+---------------+---------+---------------+-------------+
|   ID   | NAME  |    ZONE ID    | STATUS  |  EXTERNAL IP  | INTERNAL IP |
+--------+-------+---------------+---------+---------------+-------------+
| fv4q…  | tf-vm | ru-central1-d | RUNNING | 158.160.40.11 | 10.10.1.21  |
+--------+-------+---------------+---------+---------------+-------------+
ubuntu@stand:~$
ssh devops@158.160.40.11
ubuntu@stand:~$
devops@tf-vm:~$

Вход по ключу работает так же, как с ручной машиной. Если пришёл Permission denied (publickey) в первую минуту после создания, подожди: cloud-init ещё создаёт пользователя. Выйди командой exit.

Шаг 9. Адрес — выходным значением

Искать адрес в таблице после каждого создания неудобно. Пусть Terraform отдаёт его сам.

nano ~/infra/terraform-yc/outputs.tf
output "public_ip" {
  value = yandex_compute_instance.web.network_interface[0].nat_ip_address
}

network_interface[0] — первая сетевая карта машины, nat_ip_address — её публичный адрес.

ubuntu@stand:~$
terraform apply
ubuntu@stand:~$
Changes 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

Проверь, что видно снаружи на порту сайта:

ubuntu@stand:~$
curl -I --max-time 5 http://158.160.40.11
ubuntu@stand:~$
curl: (28) Connection timed out after 5001 milliseconds

Таймаут — пакеты отбросила группа безопасности, как в разделе про облако. Допиши в группу tf-sg второй ingress — такой же, как на 22, только port = 80 — и примени.

ubuntu@stand:~$
terraform apply
ubuntu@stand:~$
  ~ 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

Знак ~ — изменение на месте: группа та же, правило добавилось, машину никто не трогал. Повтори запрос:

ubuntu@stand:~$
curl -I --max-time 5 http://158.160.40.11
ubuntu@stand:~$
curl: (7) Failed to connect to 158.160.40.11 port 80: Connection refused

Connection refused, а не таймаут: группа безопасности пропустила запрос, но nginx на машине нет. Это ровно то, что мы описали, — Terraform создаёт машину, а ставить на неё программы будет Ansible в миссии.

Шаг 11. Защита от нового образа

Data-блок каждый раз берёт последний образ семейства ubuntu-2404-lts. Когда Yandex выпустит новый, plan покажет, что машину надо пересоздать: идентификатор образа в диске изменился, а он задаётся только при создании. Пересоздание — это новая пустая машина и новый адрес. Чтобы этого не случилось, в конец ресурса машины, перед последней скобкой, добавь блок lifecycle из прошлого урока.

ubuntu@stand:~$
terraform plan
ubuntu@stand:~$
No changes. Your infrastructure matches the configuration.

lifecycle ничего не меняет в облаке — он меняет поведение самого Terraform, поэтому план пустой. Другой путь — закрепить конкретный image_id вместо data-блока и обновлять его осознанно; так делают, когда образ собирают сами.

Шаг 12. Удалить всё

Учебная машина стоит денег, поэтому сразу после проверки удаляем всё.

ubuntu@stand:~$
terraform destroy
ubuntu@stand:~$
Plan: 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 собрался бы создать сейчас:

ubuntu@stand:~$
terraform plan
ubuntu@stand:~$
Plan: 4 to add, 0 to change, 0 to destroy.

Changes to Outputs:
  + public_ip = (known after apply)

Четыре ресурса — ровно четыре страницы консоли из прошлого раздела, которые ты собирал по одной. Образ в план не попадает: data-блок только читает. Скопируй строку Plan: в отчёт. Применять не нужно.

Шаг 14. Отчёт

Запиши итоги плана, применения и удаления — их проверит команда сдачи.

nano ~/devops-lab/reports/terraform-yc.txt
Машина в облаке из описания — 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 живёт в конвейере.

Практика 03+600 XP

Перевести ручную работу в консоли в описание Terraform и пройти полный круг с настоящим облаком: план, применение, проверка, удаление.

  • Провайдер Yandex Cloud зафиксирован
  • У сервисного аккаунта узкие роли
  • Описание применялось
  • Всё удалено командой
  • Машины нет
Команда сдачи — выполни на своей машине
команда
cd ~/infra/terraform-yc 2>/dev/null || echo NODIR; grep 'provider "registry' .terraform.lock.hcl; echo "STATE=$(terraform state list | wc -l)"; yc compute instance list; yc resource-manager folder list-access-bindings provision; echo ---; cat ~/devops-lab/reports/terraform-yc.txt

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