Provision
—— XP

Практика: первый ресурс и чтение плана

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

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

Работаем на стенде, где в разделе про Docker уже стоит Docker. Каталог описаний — ~/infra/terraform внутри репозитория ~/infra.

Шаг 1. Скачать Terraform

Terraform — одна программа без зависимостей. Сайт HashiCorp из России может не открываться, поэтому берём архив с зеркала Yandex Cloud. Номер версии и начало адреса положим в переменные, чтобы команды были короткими.

ubuntu@stand:~$
V=1.16.4
BASE=https://hashicorp-releases.yandexcloud.net/terraform

Архив у каждого типа процессора свой. Спросим систему, какой у стенда.

ubuntu@stand:~$
dpkg --print-architecture
ubuntu@stand:~$
amd64

amd64 — обычный процессор Intel или AMD. На Mac с чипом M1–M4 и на Raspberry Pi будет arm64. Положи ответ в переменную: дальше он подставится в имя архива.

ubuntu@stand:~$
A=amd64
ubuntu@stand:~$
wget $BASE/$V/terraform_${V}_linux_${A}.zip

Фигурные скобки в ${V} отделяют имя переменной от следующих букв: без них шелл искал бы переменную V_linux_. Если скачать архив не той архитектуры, программа не запустится с ошибкой cannot execute binary file: Exec format error. Свежий номер версии смотри на странице зеркала, открыв адрес из BASE в браузере.

Шаг 2. Установить

Распакуем архив и положим программу туда, где шелл ищет команды.

ubuntu@stand:~$
unzip terraform_${V}_linux_${A}.zip
sudo mv terraform /usr/local/bin/
ubuntu@stand:~$
terraform version
ubuntu@stand:~$
Terraform v1.16.4
on linux_amd64

Во второй строке — та же архитектура, что ответил dpkg.

Если unzip не найден, поставь его: sudo apt install unzip.

Шаг 3. Зеркало провайдеров

Провайдеры Terraform скачивает из реестра HashiCorp, который тоже бывает недоступен. Yandex Cloud советует направить Terraform на своё зеркало файлом ~/.terraformrc. Конфиг взят из документации Yandex Cloud.

nano ~/.terraformrc
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. Каталог описаний

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

ubuntu@stand:~$
mkdir -p ~/infra/terraform

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

Файл versions.tf говорит, какой провайдер нужен и какой версии.

nano ~/infra/terraform/versions.tf
terraform {
  required_providers {
    docker = {
      source  = "kreuzwerker/docker"
      version = "~> 3.0"
    }
  }
}

source — имя провайдера в реестре. ~> 3.0 значит «любая 3.x, но не 4.0»: мелкие обновления приезжают, несовместимые — нет. Ниже в том же файле — настройка провайдера: куда стучаться к Docker.

~/infra/terraform/versions.tf, продолжение
provider "docker" {
  host = "unix:///var/run/docker.sock"
}

Шаг 6. Описать контейнер

Два ресурса: образ и контейнер из него.

nano ~/infra/terraform/main.tf
resource "docker_image" "nginx" {
  name = "nginx:1.27-alpine"
}

Ниже — контейнер. Ссылка docker_image.nginx.image_id говорит Terraform, что образ нужен раньше.

~/infra/terraform/main.tf, продолжение
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. Инициализация

Переходим в каталог описаний — дальше все команды отсюда.

ubuntu@stand:~$
cd ~/infra/terraform
terraform init
ubuntu@stand:~$
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 собирается сделать. Ничего ещё не меняется.

ubuntu@stand:~$
terraform plan
ubuntu@stand:~$
  # 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 ещё раз покажет план и спросит подтверждение.

ubuntu@stand:~$
terraform apply
ubuntu@stand:~$
Do 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 записал в состояние.

ubuntu@stand:~$
curl -I http://localhost:8013
ubuntu@stand:~$
HTTP/1.1 200 OK
Server: nginx/1.27.5
ubuntu@stand:~$
terraform state list
ubuntu@stand:~$
docker_container.web
docker_image.nginx

nginx отвечает, а в состоянии ровно два ресурса из описания. Если повторить terraform plan, он скажет No changes: описание, состояние и реальность совпали.

Шаг 11. Что видит git

Состояние лежит рядом с описаниями. Посмотрим на репозиторий глазами git; флаг -uall показывает каждый новый файл, а не только каталог.

ubuntu@stand:~$
git -C ~/infra status --short -uall
ubuntu@stand:~$
?? 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 и допиши четыре строки из прошлого урока:

nano ~/infra/.gitignore, в конец
*.tfstate
*.tfstate.*
.terraform/
*.tfvars

*.tfstate.* — резервные копии состояния, .terraform/ — скачанные провайдеры, *.tfvars — значения переменных, о них следующий урок. Повтори git status:

ubuntu@stand:~$
?? terraform/.terraform.lock.hcl
?? terraform/main.tf
?? terraform/versions.tf

Остались описания и lock-файл — им место в git. Lock-файл фиксирует версию провайдера, чтобы у коллеги поставилась та же. В настоящем проекте .gitignore пишут до первого apply: здесь мы увидели, что будет, если забыть, но не успели ничего закоммитить.

Шаг 12. Изменение на месте

Контейнер не поднимется после перезагрузки стенда: политики перезапуска в описании нет. В main.tf допиши строку в ресурс docker_container, под image:

~/infra/terraform/main.tf, в ресурс web
  restart = "unless-stopped"
ubuntu@stand:~$
terraform plan
ubuntu@stand:~$
  # 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.

ubuntu@stand:~$
terraform plan
ubuntu@stand:~$
  # 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. Отчёт

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

nano ~/devops-lab/reports/terraform-first.txt
Первый ресурс — 01.10.2026

~  смена restart: контейнер тот же, изменение на месте
-/+ смена образа: пересоздание, forces replacement у image,
    сначала удаление, потом создание — между ними простой
Plan: N to add, M to change, K to destroy — читаю первым
.gitignore — до первого коммита, а лучше до apply; lock-файл идёт в git

Сдай задание командой из блока проверки. Контейнер tf-web оставь: он понадобится в следующей практике.

Что дальше

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

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

Пройти полный круг init, plan, apply на бесплатном провайдере и научиться отличать в плане изменение на месте от пересоздания.

  • Ресурсы в состоянии
  • Версии провайдеров зафиксированы
  • Состояние исключено из git
  • Состояние не в репозитории
  • Контейнер отвечает
  • Повторный план пуст
  • Пересоздание разобрано
Команда сдачи — выполни на своей машине
команда
cd ~/infra/terraform 2>/dev/null || echo NODIR; echo "RES=$(terraform state list | wc -l)"; terraform state list; test -f .terraform.lock.hcl && echo LOCK=yes; git -C ~/infra check-ignore -q terraform/terraform.tfstate && echo IGNORED=yes; echo "TRACKED=$(git -C ~/infra ls-files | grep -c tfstate)"; curl -sI http://localhost:8013 | grep -i '^server'; echo "NOCHANGE=$(terraform plan -no-color | grep -c 'No changes')"; cat ~/devops-lab/reports/terraform-first.txt

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