Provision
—— XP

Зачем нужен Terraform

теория~6 минут+240 XP

В прошлом разделе ты руками создал сеть, подсеть, группу безопасности и машину, заполнив десяток полей в консоли. Через месяц ты не вспомнишь, какая доля vCPU стояла и какие порты были открыты, а коллега не повторит это без тебя. Если стенд придётся поднять заново, ты снова будешь кликать по памяти. Этот раздел о том, как записать всё это в файл, который можно выполнить.

Terraform — программа, которая создаёт инфраструктуру по текстовому описанию: сети, машины, группы безопасности, бакеты. Ты пишешь в файле, что должно существовать, а Terraform сам идёт в облако и приводит его к описанию. Такой подход называют инфраструктурой как код: описание лежит в репозитории, видно, кто и зачем его поменял, а повторить всё можно одной командой. Terraform выпустила компания HashiCorp в 2014 году, и сейчас это самый распространённый инструмент такого рода: его спрашивают почти в каждой вакансии DevOps.

В этом уроке — где Terraform проходит границу с Ansible, как он сам выводит порядок действий и откуда знает про конкретное облако.

Где проходит граница с Ansible

В разделе про Ansible ты уже приводил машину в нужное состояние. Возникает вопрос: зачем второй инструмент? Ответ в том, на какой вопрос каждый отвечает.

Две колонки. Terraform создаёт то, чего не было: машины, сети, диски, правила облачного файрвола, балансировщики, записи DNS. Ansible настраивает существующее: пакеты, пользователей, конфигурации, службы.
Граница проходит по вопросу «это уже существует?». Типичная связка: Terraform создаёт машины и отдаёт их адреса, Ansible по этому списку их настраивает.

Удобное сравнение: Terraform — строитель, который возводит дом и проводит коммуникации, а Ansible — тот, кто потом расставляет мебель. Terraform работает с API облака и помнит, что создал, поэтому умеет это удалить. Ansible ходит на машину по SSH и ничего не помнит.

В конце этого раздела ты соединишь оба: Terraform поднимет машину в облаке, а Ansible поставит на неё nginx.

Описать, а не сделать

Скрипт говорит «сделай»: создай сеть, потом подсеть, потом машину. Terraform устроен иначе — ты описываешь результат, а шаги он выводит сам. Такой подход называют декларативным.

Вот как выглядит описание одной сети в Yandex Cloud. Это ресурс — блок, который описывает одну вещь в облаке.

network.tf
resource "yandex_vpc_network" "main" {
  name = "provision-net"
}

Читается так: «должен существовать ресурс типа yandex_vpc_network, внутри описания я зову его main, а в облаке его имя provision-net». Если сети нет, Terraform её создаст. Если есть и совпадает — ничего не сделает. Если имя в файле поменяли — переименует.

С одной сетью всё просто. Но подсеть без сети не создашь, а в описании блоки могут стоять в любом порядке.

Порядок из ссылок

Подсеть не создать раньше сети, а машину — раньше подсети. Писать этот порядок руками не нужно: Terraform выводит его из ссылок одного ресурса на другой.

network.tf
resource "yandex_vpc_subnet" "main" {
  network_id = yandex_vpc_network.main.id
  # ссылка на сеть выше: значит, сеть создаётся раньше
}
Граф из трёх узлов: два независимых ресурса создаются параллельно, обе стрелки ведут к третьему, который ждёт оба. При удалении порядок обратный.
Из ссылок собирается граф зависимостей. Независимое создаётся параллельно, удаление идёт в обратном порядке.

Запись yandex_vpc_network.main.id значит «идентификатор сети main, который станет известен после её создания». Это и есть зависимость, и при удалении Terraform пройдёт граф в обратную сторону — ровно тот порядок уборки, который ты соблюдал руками в прошлом разделе.

При этом в самой программе Terraform нет ни слова про Yandex Cloud: тип yandex_vpc_network ему объясняет кто-то другой.

Провайдеры

Сам Terraform не умеет создавать ничего. Всё умение живёт в провайдерах — подключаемых дополнениях, их ещё называют плагинами. Каждый провайдер работает как переводчик: знает API одной системы и пересказывает ей твоё описание. Провайдер yandex-cloud/yandex говорит с Yandex Cloud, kreuzwerker/docker — с Docker на твоей машине. Их сотни: облака, Kubernetes, GitLab, DNS.

Провайдеры скачиваются из реестра HashiCorp при первом запуске. Из России реестр бывает недоступен, поэтому Yandex Cloud держит зеркало реестра и советует настроить Terraform на него. Как это сделать, покажем в первой практике.

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

Terraform или OpenTofu

В 2023 году HashiCorp сменила лицензию Terraform на более закрытую. В ответ сообщество выпустило OpenTofu — ту же программу под свободной лицензией. Язык, команды и провайдеры у них совпадают, отличается имя команды: tofu вместо terraform.

В курсе мы пользуемся terraform, потому что его больше в вакансиях и статьях. Почти всё написанное работает и в OpenTofu. Отличается настройка источника провайдеров: у OpenTofu свой реестр, и файл ~/.terraformrc с зеркалом Яндекса, который мы заведём в первой практике, написан под реестр HashiCorp. Выбор между ними в компании — вопрос лицензии, а не навыков.

Словарь урока

Инфраструктура как код
Подход, при котором сети, машины и права описываются текстом в репозитории и создаются программой.
Ресурс
Блок описания одной вещи в облаке или системе: сети, машины, контейнера. ↩ к тексту
Декларативный подход
Описывается желаемый результат, а шаги к нему программа выводит сама.
Провайдер
Плагин Terraform, который знает API конкретной системы. ↩ к тексту
OpenTofu
Открытая ветка Terraform с теми же командами и языком. ↩ к тексту
Первое знакомство с Terraform
подборка на ютубе · ролик не закреплён
Ищи ролики, где показывают план с пересозданием ресурса — это главное, что надо научиться замечать.

Что спросят на собеседовании

  • Чем Terraform отличается от Ansible?
    Terraform создаёт ресурсы через API облака и помнит, что создал, поэтому умеет удалять. Ansible настраивает уже существующие машины по SSH и ничего не помнит. Обычно их используют вместе.
  • Что значит декларативный подход?
    Описываешь, какие ресурсы должны существовать, а не какие команды выполнить. Инструмент сам сравнивает описание с реальностью и решает, что создать, изменить или удалить.

Что дальше

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

Проверь себя+240 XPдве попытки
1
Граница
Где проходит граница между Terraform и Ansible?
2
Декларативность
Что ты пишешь в файлах Terraform?
3
Граф
Как Terraform понимает, что подсеть надо создать раньше машины?
4
Провайдер
Что такое провайдер в Terraform?
ответь на все вопросы, чтобы проверить

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