Rivalry2

HTML Diff

0 added 0 removed

Original 2026-01-01

Modified 2026-02-26

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

2 Terraform позволяет описывать наборы взаимосвязанных ресурсов как модули. Модули Terraform близки по своей идее к импортируемым ролям в Ansible. Мы можем подключать их в свой проект, передавать им параметры и на выходе получать комплексное инфраструктурное решение.

3 В этом уроке мы разберемся, зачем нужны модули Terraform и как их применять.

4 <h2>Какую проблему решают модули</h2>

5 Модули помогают отвлечься от особенностей описания ресурсов и зависимостей конкретного облака. Мы импортируем модуль, передаем в него параметры, а дальше уже сам модуль создает все необходимые ресурсы.

6 Так модуль с хорошей документацией экономит время, которое мы тратим на изучение ресурсов и зависимостей конкретного провайдера. Модуль помогает быстрее добиться нужного результата.

7 Возьмем для примера модуль<a>terraform-yc-postgresql</a>. Он описывает создание в облаке Yandex кластера БД PostgreSQL, а также помещение в него баз данных и пользователей.

8 Ранее мы описывали кластер, его базу и пользователей с помощью обычных ресурсов. Попробуем сделать то же, но с помощью модуля.

9 <h2>Подключаем в инфраструктуру модуль</h2>

10 Возьмем<a>пример описания модуля</a>для простого single-node кластера, уберем лишние настройки и подправим некоторые поля:

11 Модуль обозначается ключевым словом module. Далее мы даем модулю имя как обычным ресурсам Terraform. Мы назовем модульyandex-postgresql. Так будет понятно, что он делает.

12 В обязательном для модуля поле source мы указали путь к<a>коду модуля</a>на Github с указанием используемой версии в ref. Так можно ссылаться на любые модули, которые хранятся на Github, в том числе на свои.

13 В network_id и subnet_id мы добавили ссылки на ресурсы сети и подсети, которые создаем в том же проекте. Также добавили в кластер вторую базуhexlet-test, чтобы проверить, как модуль работает с несколькими ресурсами. Еще добавили дополнительного пользователяguest.

14 Вместо того чтобы описывать пять отдельных ресурсов Terraform, мы компактно описали все взаимозависимые ресурсы в одном модуле.

15 Мы технически можем добавить еще один модульyandex-postgresql-2с тем же source, описать в нем другой набор параметров и создать два полноценных кластера БД со всем содержимым в одном проекте. Так с помощью модулей мы можем управлять инфраструктурой на более высоком уровне абстракции.

16 Выполним terraform init, чтобы загрузить модуль:

17 Initializing modules... Initializing the backend... Initializing provider plugins... - Finding yandex-cloud/yandex versions matching ">= 0.89.0"... - Finding hashicorp/local versions matching "> 2.2.0"... - Finding hashicorp/random versions matching "> 3.3.0"... - Installing yandex-cloud/yandex v0.97.0... - Installed yandex-cloud/yandex v0.97.0 (unauthenticated) - Installing hashicorp/local v2.4.0... - Installed hashicorp/local v2.4.0 (unauthenticated) - Installing hashicorp/random v3.5.1... - Installed hashicorp/random v3.5.1 (unauthenticated) ... Terraform has been successfully initialized!

18 Помимо провайдераyandex-cloudдополнительно установились провайдерыlocalиrandom. Это произошло, так как наш модульterraform-yc-postgresqlиспользует их, чтобы генерировать случайные пароли и сохранять их в файлы.

19 Если инициация прошла успешно, мы сможем увидеть код используемого модуля в рабочей папке .terraform/modules внутри проекта. Заглянем внутрь и посмотрим, из чего состоит модуль.

20 <h2>Знакомимся со структурой модуля</h2>

21 Модуль по сути является вложенным проектом Terraform, который содержит все стандартные компоненты: источники данных, ресурсы, переменные, outputs. Модуль принимает из проекта<a>значения переменных</a>и использует их, чтобы параметризировать<a>ресурсы</a>.

22 Главное отличие модуля от проекта - отсутствие блока provider, поскольку модуль не предназначен для самостоятельного использования. При этом в модуле<a>есть раздел required_providers</a>, который определяет, какие версии провайдеров понадобится доустановить при подключении модуля в проект.

23 Модуль Terraform может храниться в обычном git-репозитории и версионироваться с помощью тегов git либо использовать для хранения специальный инфраструктурный registry, реализация которого есть, к примеру, в Gitlab.

24 Сейчас внутри модуля нас интересуют outputs. Модуль создаст кластер, базы, пользователей и сгенерит для них пароли. Нам нужно извлечь эти данные, чтобы передать их ресурсу виртуальной машины.

25 <h2>Обращаемся к полям модуля</h2>

26 Заглянем вoutputs.tfподключенного модуля:

27 Вcluster_fqdns_listмы сможем прочитать хост, который раньше получали из поля ресурса кластера yandex_mdb_postgresql_cluster.dbcluster.host.0.fqdn. Вownersво вложенной структуре хранятся пользователи и пароли БД, вdatabases- список баз данных.

28 К полям модулей можно обращаться так же, как к полям ресурсов. Outputs являются полями самого модуля, поэтому мы в общем виде можем получить их значения, если пропишем module.<modulename>.<outputname>.

29 Пропишем в ресурсе виртуальной машины значения, которые возвращает модуль:

30 Поскольку outputs в этом модуле представляют собой списки, в ресурсеvmмы обращаемся к отдельным элементам списка, чтобы извлечь строковые значения:

31 <ul><li>Берем module.yandex-postgresql.cluster_fqdns_list[0].0, чтобы извлечь строку с хостом кластера</li>

32 <li>Берем module.yandex-postgresql.databases[0], чтобы извлечь имя первой базы данных, созданной в модуле - это будет hexlet</li>

33 <li>Берем module.yandex-postgresql.owners_data[0].user и module.yandex-postgresql.owners_data[0].password, чтобы получить у первого и единственного owner-пользователя имя и пароль для подключения к БД</li>

34 </ul>Также установим зависимость, чтобы виртуальная машина не создавалась до тех пор, пока модуль не развернет кластер БД:

35 На этом наша инфраструктура готова к запуску.

36 <h2>Запускаем инфраструктуру</h2>

37 Попробуем запустить terraform apply и посмотрим, как Terraform обработает запрос на создание инфраструктуры с подключенным модулем:

38 # module.yandex-postgresql.random_password.password["guest"] will be created + resource "random_password" "password" { ... } # module.yandex-postgresql.random_password.password["me"] will be created + resource "random_password" "password" { ... } # module.yandex-postgresql.yandex_mdb_postgresql_cluster.this will be created + resource "yandex_mdb_postgresql_cluster" "this" { ... }

39 На этапе подтверждения видим, что Terraform трансформирует параметры, переданные модулю в отдельные ресурсы, и присваивает им имена вида module.yandex-postgresql.*. Когда мы изменяем параметры, передаваемые модулю, мы будем изменять ресурсы, которые стоят за ним.

40 Применим изменения и понаблюдаем, как создается инфраструктура:

41 module.yandex-postgresql.random_password.password["guest"]: Creating... module.yandex-postgresql.random_password.password["me"]: Creating... module.yandex-postgresql.random_password.password["me"]: Creation complete after 0s [id=none] module.yandex-postgresql.random_password.password["guest"]: Creation complete after 0s [id=none] yandex_vpc_network.net: Creating... yandex_vpc_network.net: Creation complete after 0s [id=enpn9tfh3hd8s8hara9m] yandex_vpc_subnet.subnet: Creating... yandex_vpc_subnet.subnet: Creation complete after 1s [id=e9bk60o99g5i2r01ia47] module.yandex-postgresql.yandex_mdb_postgresql_cluster.this: Creating... module.yandex-postgresql.yandex_mdb_postgresql_cluster.this: Still creating... [10s elapsed] ... module.yandex-postgresql.yandex_mdb_postgresql_cluster.this: Creation complete after 6m3s [id=c9q7s2022m4rife6o7bt] module.yandex-postgresql.yandex_mdb_postgresql_user.owner["me"]: Creation complete after 37s [id=c9q7s2022m4rife6o7bt:me] module.yandex-postgresql.yandex_mdb_postgresql_database.database["hexlet"]: Creating... module.yandex-postgresql.yandex_mdb_postgresql_database.database["hexlet-test"]: Creating... module.yandex-postgresql.yandex_mdb_postgresql_database.database["hexlet-test"]: Creation complete after 40s [id=c9q7s2022m4rife6o7bt:hexlet-test] module.yandex-postgresql.yandex_mdb_postgresql_database.database["hexlet"]: Creation complete after 1m16s [id=c9q7s2022m4rife6o7bt:hexlet] module.yandex-postgresql.yandex_mdb_postgresql_user.user["guest"]: Creating... module.yandex-postgresql.yandex_mdb_postgresql_user.user["guest"]: Creation complete after 54s [id=c9q7s2022m4rife6o7bt:guest] yandex_compute_instance.vm: Creating... yandex_compute_instance.vm: Provisioning with 'remote-exec'... yandex_compute_instance.vm (remote-exec): (output suppressed due to sensitive value in config) yandex_compute_instance.vm: Creation complete after 1m27s [id=fhm60f9q8b2ach07atnm]

42 При использовании логики модуля Terraform сгенерировал случайные пароли для пользователей с помощью провайдера random, создал кластер PostgreSQL, добавил в него базы и пользователей. Лог работы провижнера, создающего контейнер с приложением, оказался скрыт, так как в нем применялись сенситивные переменные.

43 <h2>Выводы</h2>

44 Модуль Terraform - это инструмент для описания комплексных инфраструктурных решений, которые состоят из нескольких взаимосвязанных ресурсов. Модуль можно подключить в свой проект, передать ему набор переменных, и Terraform создаст новые ресурсы на основе логики модуля.

45 Модули упрощают описание сложных инфраструктурных решений и позволяют переиспользовать инфраструктурный код в разных проектах.