Rivalry2

HTML Diff

0 added 0 removed

Original 2026-01-01

Modified 2026-02-26

1 В этом уроке мы рассмотрим типовой рабочий процесс с использованием Terraform без погружения в детали. Опишем небольшую инфраструктуру и поработаем с ней, развернем, обновим и удалим. А в следующих уроках, рассмотрим все это подробно.

2 <h2>Подготовка</h2>

3 На протяжении всего курса, мы будем описывать нашу инфраструктуру в репозитории, который станет частью вашего портфолио. Для этого создайте на Github репозиторийhexlet-terraformи клонируйте его себе на компьютер. Все дальнейшие команды будут выполняться внутри этого репозитория.

4 Теперь установите Terraform по<a>этой ссылке</a>. Проверьте что он работает:

5 Зарегистрируйтесь в<a>Yandex Cloud</a>.<a>На этой странице</a>описано как получить OAuth-токен. Сделайте запрос и получите ключ, который понадобится Terraform для выполнения удаленных команд.

6 <h2>Инициализация</h2>

7 Перед началом работы с Terraform, нужно определиться с облаком, которое будет использоваться. Все примеры курса даются в Yandex Cloud, но вы можете выбрать любое другое облако, которое вам по душе. Правда для этого придется самостоятельно копаться в документации, чтобы повторять за тем, что дается в уроке.

8 Когда облако выбрано, нужно найти его в<a>списке провайдеров</a>и перейти в<a>документацию</a>. Либо можно посмотреть<a>документацию в самом облачном провайдере</a>. Здесь описано, как инициализировать работу с ним.

9 Зачем нужен провайдер? Провайдер это модуль Terraform, который умеет работать с конкретным облаком. Как только он подключается к проекту, внутри появляются команды для взаимодействия с его сервисами.

10 Для подключения провайдера Yandex Cloud, создайте файл.terraformrcи добавьте в него содержимое:

11 Эти данные содержат информацию об источнике, и которого будет устанавливаться провайдер.

12 Затем создайте файлmain.tfи добавьте в него такое содержимое:

13 Помимо указания списка провайдеров, мы описываем переменную yc_token, которая записывается в аттрибут token провайдераyandex. Это ключ необходим Terraform для выполнения команд по API. Значение ключа указывать в конфигурации нельзя, иначе, кто-нибудь сможет с его помощью выполнить любой код на YandexCloud, включая полное уничтожение всей инфраструктуры.

14 Для работы с секретами, Terraform предлагает создавать файлы с расширением*.auto.tfvars, которые добавляются в.gitignore. Сам ключ, при этом, можно хранить в зашифрованном виде в<a>Ansible Vault</a>.

15 Создадим файлsecrets.auto.tfvars, в котором описываются переменные, содержащие секретные данные. Добавим туда наш ключ как значение переменной yc_token:

16 После того как провайдер добавлен, нужно выполнить инициализацию:

17 Во время инициализации скачивается код провайдера в директорию.terraform. Эта служебная директория, содержимое которой нам не важно, поэтому ее добавляют в.gitignore.

18 Инициализация выполняется каждый раз, когда репозиторий клонируется заново или обновляются версии зависимостей. Несмотря на название, команда terraform init больше похожа на установку зависимостей в JavaScript с помощью npm install.

19 Кроме.terraform, в директории с проектом оказывается файл.terraform.lock.hcl.

20 <h2>Описание инфраструктуры</h2>

21 На странице документации провайдера, слева меню, в котором есть список возможностей провайдера. Мы начнем с самой базовой -<a>создании сервера</a>.

22 В терминах Terraformyandex_compute_instanceназывается ресурсом. Это то, чем мы управляем в нашем облаке. Создадим сервер:

23 Для создания сервера, нам пришлось создать дополнительные ресурсыyandex_vpc_network,yandex_vpc_subnet,yandex_compute_disk.

24 Описание аргументовresources,boot_diskи других идет в документации сразу после примера в секцииArgument Reference. Там же указано какие из них обязательные, а какие нет. С другой стороны, в этом разделе не хватает информации о возможных значениях. Откуда брать значения дляplatform_idилиcores? Иногда в документации есть ссылка на страницу с возможными значениями, но это бывает не всегда. К сожалению здесь не остается ничего другого, как пытаться найти эту информацию в документации облачного провайдера. Здесь обычно помогает Google.

25 Ресурсы требуют указанияfolder_id- это ваш каталог внутри которого будет создан ресурс. Его идентификатор можно найти<a>в консоли Yandex Cloud</a>. Если каталог не создан, создайте его.

26 Язык описания инфраструктуры отдаленно напоминает JSON и интуитивно понятен в большинстве ситуаций. Главное что нужно понимать, он описывает не команды, а состояние того, что мы хотим получить в конце. Это значит что порядок описания инфраструктуры не имеет значения, Terraform все равно сделает изменения в том порядке, в котором нужно.

27 Инфраструктуру можно описывать в любых файлах с расширением*.tf. Terraform самостоятельно их загружает и вычисляет порядок, в котором надо выполнять изменения. Для простоты мы все делаем в файлеmain.tf. Когда кода много, его удобно раскладывать по разным файлам.

28 <h2>Создание</h2>

29 Теперь, когда ресурсы описаны, можно их создать. Делается это в два шага. Сначала нам показывают план изменений и если он соответствует нашим ожиданиям, то мы подтверждаем его выполнение и Terraform делает это

30 Очень важно убедиться, что здесь нет ничего опасного, например удаление или пересоздание каких-то ресурсов, которые нельзя трогать. В этом смысле, Terraform максимально опасный инструмент. Неверно примененный план может привести к полной потере всего проекта включая бекапы.

31 Если нас все устраивает, то нужно набратьyes. Создание серверов займет какое-то время. Terraform выполняет все операции синхронно, поэтому он закончит работу только после внесения всех изменений.

32 Если все прошло успешно, то зайдите в личный кабинет Yandex Cloud и убедитесь, что сервер создан. Правда магия?

33 После того как Terraform выполнит изменения, он создает и затем обновляет файлterraform.tfstate. Этот файл хранит состояние инфраструктуры на текущий момент. Зачем это нужно? С его помощью Terraform вычисляет разницу между тем, что мы хотим получить в итоге и тем что есть сейчас. Без него Terraform будет считать, что инфраструктура каждый раз создается заново. Этот файл обычно не хранят в репозитории, так как вместе с состоянием в нем могут быть чувствительные данные вроде паролей и токенов. Более того, с этим файлом в один момент времени может работать только один человек, иначе Terraform не сможет правильно оценить текущую инфраструктуру. Для этого используют специальные сервисы, которые хранят файл состояния на удаленном сервере

34 Кромеterraform.tfstateTerraform создает файлы бекапы с расширением*.backup. Их нужно добавить в.gitignore.

35 Ну и наконец, давайте попробуем все удалить:

36 <h2>Собирая все вместе</h2>