Начнём с провайдера Docker: он бесплатный и работает прямо на стенде, а план, состояние и пересоздание у него ровно такие же, как у облака. Всё, что ты здесь увидишь, через две практики повторится с машиной в Yandex Cloud.
Работаем на стенде, где в разделе про Docker уже стоит Docker. Каталог описаний — ~/infra/terraform внутри репозитория ~/infra.
Шаг 1. Скачать Terraform
Terraform — одна программа без зависимостей. Сайт HashiCorp из России может не открываться, поэтому берём архив с зеркала Yandex Cloud. Номер версии и начало адреса положим в переменные, чтобы команды были короткими.
V=1.16.4 BASE=https://hashicorp-releases.yandexcloud.net/terraform
Архив у каждого типа процессора свой. Спросим систему, какой у стенда.
dpkg --print-architectureamd64amd64 — обычный процессор Intel или AMD. На Mac с чипом M1–M4 и на Raspberry Pi будет arm64. Положи ответ в переменную: дальше он подставится в имя архива.
A=amd64wget $BASE/$V/terraform_${V}_linux_${A}.zipФигурные скобки в ${V} отделяют имя переменной от следующих букв: без них шелл искал бы переменную V_linux_. Если скачать архив не той архитектуры, программа не запустится с ошибкой cannot execute binary file: Exec format error. Свежий номер версии смотри на странице зеркала, открыв адрес из BASE в браузере.
Шаг 2. Установить
Распакуем архив и положим программу туда, где шелл ищет команды.
unzip terraform_${V}_linux_${A}.zip sudo mv terraform /usr/local/bin/
terraform versionTerraform v1.16.4 on linux_amd64
Во второй строке — та же архитектура, что ответил dpkg.
Если unzip не найден, поставь его: sudo apt install unzip.
Шаг 3. Зеркало провайдеров
Провайдеры Terraform скачивает из реестра HashiCorp, который тоже бывает недоступен. Yandex Cloud советует направить Terraform на своё зеркало файлом ~/.terraformrc. Конфиг взят из документации Yandex Cloud.
provider_installation { network_mirror { url = "https://terraform-mirror.yandexcloud.net/" include = ["registry.terraform.io/*/*"] } direct { exclude = ["registry.terraform.io/*/*"] } }
Блок network_mirror говорит: все провайдеры из реестра бери с зеркала. Блок direct с exclude запрещает ходить в реестр напрямую, чтобы Terraform не висел на недоступном адресе.
Шаг 4. Каталог описаний
Описания будут жить в репозитории, в отдельном каталоге.
mkdir -p ~/infra/terraformШаг 5. Подключить провайдер
Файл versions.tf говорит, какой провайдер нужен и какой версии.
terraform { required_providers { docker = { source = "kreuzwerker/docker" version = "~> 3.0" } } }
source — имя провайдера в реестре. ~> 3.0 значит «любая 3.x, но не 4.0»: мелкие обновления приезжают, несовместимые — нет. Ниже в том же файле — настройка провайдера: куда стучаться к Docker.
provider "docker" { host = "unix:///var/run/docker.sock" }
Шаг 6. Описать контейнер
Два ресурса: образ и контейнер из него.
resource "docker_image" "nginx" { name = "nginx:1.27-alpine" }
Ниже — контейнер. Ссылка docker_image.nginx.image_id говорит Terraform, что образ нужен раньше.
resource "docker_container" "web" { name = "tf-web" image = docker_image.nginx.image_id ports { internal = 80 external = 8013 } }
ports пробрасывает порт 80 контейнера на 8013 стенда — то же, что -p 8013:80 у docker run. Все поля ресурса — в документации провайдера.
Шаг 7. Инициализация
Переходим в каталог описаний — дальше все команды отсюда.
cd ~/infra/terraform terraform init
Initializing provider plugins... - Finding kreuzwerker/docker versions matching "~> 3.0"... - Installing kreuzwerker/docker v3.9.0... Terraform has been successfully initialized!
Провайдер скачан с зеркала, рядом появились каталог .terraform и файл .terraform.lock.hcl. Если init висит на Finding, проверь ~/.terraformrc.
Между этими строками будет жёлтое Warning: Incomplete lock file information. Оно обычное при зеркале: Terraform посчитал контрольную сумму провайдера только для твоей архитектуры и предупреждает, что на машине с другим процессором lock-файл придётся дополнить. На учебном стенде ничего делать не нужно.
Шаг 8. План
План покажет, что Terraform собирается сделать. Ничего ещё не меняется.
terraform plan# docker_container.web will be created + resource "docker_container" "web" { + name = "tf-web" + image = (known after apply) } # docker_image.nginx will be created + resource "docker_image" "nginx" { + name = "nginx:1.27-alpine" } Plan: 2 to add, 0 to change, 0 to destroy.
Оба ресурса со знаком +. (known after apply) — значение станет известно только после создания: идентификатор образа придёт от Docker. Ничего ещё не создано.
Шаг 9. Применить
Применяем: Terraform ещё раз покажет план и спросит подтверждение.
terraform applyDo you want to perform these actions? Enter a value: yes docker_image.nginx: Creation complete after 4s docker_container.web: Creation complete after 1s Apply complete! Resources: 2 added, 0 changed, 0 destroyed.
На вопрос отвечаешь словом yes — другое слово отменит применение. Сначала образ, потом контейнер: порядок взят из ссылки.
Шаг 10. Проверить результат
Проверим две вещи: отвечает ли nginx и что Terraform записал в состояние.
curl -I http://localhost:8013HTTP/1.1 200 OK Server: nginx/1.27.5
terraform state listdocker_container.web docker_image.nginx
nginx отвечает, а в состоянии ровно два ресурса из описания. Если повторить terraform plan, он скажет No changes: описание, состояние и реальность совпали.
Шаг 11. Что видит git
Состояние лежит рядом с описаниями. Посмотрим на репозиторий глазами git; флаг -uall показывает каждый новый файл, а не только каталог.
git -C ~/infra status --short -uall?? terraform/.terraform.lock.hcl ?? terraform/.terraform/providers/registry.terraform.io/kreuzwerker/docker/3.9.0/linux_amd64/terraform-provider-docker_v3.9.0 ?? terraform/main.tf ?? terraform/terraform.tfstate ?? terraform/versions.tf
Флаг -C у git означает «работай в этом каталоге», как если бы ты сделал туда cd. Вывод сокращён: в .terraform ещё три файла провайдера. Одно git add . — и в историю уедут сам провайдер на десятки мегабайт и terraform.tfstate. В состоянии Terraform хранит всё, что знает о ресурсах, включая пароли, если они есть у ресурса, — и в истории git они останутся навсегда. Открой ~/infra/.gitignore и допиши четыре строки из прошлого урока:
*.tfstate *.tfstate.* .terraform/ *.tfvars
*.tfstate.* — резервные копии состояния, .terraform/ — скачанные провайдеры, *.tfvars — значения переменных, о них следующий урок. Повтори git status:
?? terraform/.terraform.lock.hcl ?? terraform/main.tf ?? terraform/versions.tf
Остались описания и lock-файл — им место в git. Lock-файл фиксирует версию провайдера, чтобы у коллеги поставилась та же. В настоящем проекте .gitignore пишут до первого apply: здесь мы увидели, что будет, если забыть, но не успели ничего закоммитить.
Шаг 12. Изменение на месте
Контейнер не поднимется после перезагрузки стенда: политики перезапуска в описании нет. В main.tf допиши строку в ресурс docker_container, под image:
restart = "unless-stopped"terraform plan# docker_container.web will be updated in-place ~ resource "docker_container" "web" { ~ restart = "no" -> "unless-stopped" } Plan: 0 to add, 1 to change, 0 to destroy.
Знак ~ и update in-place: контейнер останется тем же, поменяется одна настройка. "no" слева — значение, которое провайдер поставил сам, когда строки не было. Примени командой terraform apply.
Шаг 13. Пересоздание
Теперь поменяй образ: nginx:1.27-alpine на nginx:1.26-alpine.
terraform plan# docker_container.web must be replaced ~ image = "sha256:6769dc3a…" -> (known after apply) # forces replacement # docker_image.nginx must be replaced ~ name = "nginx:1.27-alpine" -> "nginx:1.26-alpine" # forces replacement Plan: 2 to add, 0 to change, 2 to destroy.
Образ у работающего контейнера поменять нельзя, поэтому -/+ и forces replacement. Цифра 2 в итоге — потому что пересоздаётся и сам ресурс образа: у него сменилось имя. Между удалением и созданием сервиса нет. Примени, проверь curl -I — в заголовке Server будет 1.26.
Шаг 14. Отчёт
Запиши своими словами, чем изменение на месте отличается от пересоздания: это главное, что надо унести из практики.
Первый ресурс — 01.10.2026 ~ смена restart: контейнер тот же, изменение на месте -/+ смена образа: пересоздание, forces replacement у image, сначала удаление, потом создание — между ними простой Plan: N to add, M to change, K to destroy — читаю первым .gitignore — до первого коммита, а лучше до apply; lock-файл идёт в git
Сдай задание командой из блока проверки. Контейнер tf-web оставь: он понадобится в следующей практике.
Что дальше
Круг пройден. Дальше — переменные и выходные значения: как сделать одно описание для разных значений, не копируя его.