Для нескольких одинаковых окружений переиспользуйте проверенный модуль, но не копируйте state рабочего проекта в новый. Состояние описывает управление конкретными объектами, а не шаблон будущей инфраструктуры. Начните с матрицы: проект, назначение, state, provider-идентичность и версия модуля. Первый контрольный план одного тестового проекта не должен предлагать изменения соседних проектов.
Одинаковость означает общий договор возможностей, а не одинаковые адреса и credentials. Размеры, домены и разрешённые интеграции могут различаться явно. Нужный результат — воспроизводимое создание и независимое обновление проекта без скрытого общего владельца его ресурсов.
Переиспользуйте описание, сохраняйте идентичность
| Слой | Что может быть общим | Что задаётся для проекта |
|---|---|---|
| Модуль | Ресурсы и проверенный интерфейс | Входы и версия |
| Root-конфигурация | Структура вызова | Назначение и зависимости |
| State | Выбранный механизм хранения | Явная область управления |
| Полномочия | Принципы минимального доступа | Конкретная роль и граница проекта |
Terraform CLI workspaces позволяют связывать несколько состояний с одной конфигурацией на поддерживаемом backend. Однако HashiCorp прямо указывает, что они не подходят для разделения систем или развёртываний, которым нужны отдельные credentials и контроль доступа. Проверено 16 октября 2026 года. Не путайте CLI workspaces с одноимённой сущностью HCP Terraform и не считайте смену имени workspace полноценной изоляцией.
Один выпуск модуля не должен обновлять всех сразу
Зафиксируйте проверенную версию модуля и provider-зависимости в каждом потребителе. Обновление сначала проходит на представительном тестовом проекте, затем распространяется по принятому порядку. Если все root-конфигурации бесконтрольно читают текущую ветку модуля, маленькая правка способна изменить будущие планы всех проектов одновременно. Это отдельный риск от качества самого модуля.
Условная матрица потребителей:
project_A -> module_revision_R -> state_A -> role_A
project_B -> module_revision_R -> state_B -> role_B
shared_network -> свой владелец -> явные ссылки
upgrade_trial -> project_A_test -> проверенный план
rollout -> отдельное решение для каждого потребителяОбщую сеть, DNS-зону или другую зависимость назначьте одному владельцу. Потребители получают согласованные ссылки, а не создают тот же объект заново. При изменении общего ресурса проверяют влияние на всех пользователей. Граница state не должна случайно проходить через объекты, которые постоянно меняются только совместно, без описанного процесса координации.
Полномочия на backend состояния и полномочия provider к инфраструктуре проверяются отдельно. Доступ к чужому state может раскрывать чувствительные сведения даже без права apply. В диагностике достаточно безопасной идентичности backend и роли; полный state, токены и значения credentials в общие отчёты не попадают. Названия проектов также не являются секретным барьером доступа.
Проверка независимости меняет один проект
- Составить матрицу root, state, ролей и версий.
- Получить план двух тестовых проектов без применения.
- Изменить один допустимый параметр только первого.
- Подтвердить отсутствие чужих объектов в его области управления.
- Повторить план второго и проверить ожидаемое отсутствие изменений.
Не проверяйте изоляцию запуском destroy над рабочим окружением. Для удаления используют отдельный тестовый проект и заранее видимый состав объектов. Если неверная root-конфигурация уже управляла чужим объектом, исправление пути backend само не передаёт управление: нужен контролируемый разбор состояния и реальных ресурсов. Для проектирования достаточно матрицы границ, интерфейса модуля и безопасных планов двух потребителей. По ним видно, что повторяется как код, а что остаётся самостоятельной инфраструктурой.