terraform – Управляет развертыванием Terraform (и планами)

Новое в версии 2.5.

Описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

Описание

Предоставляет поддержку развертывания ресурсов с помощью Terraform и извлечения информации о ресурсах обратно в Ansible.

Требования

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

terraform

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
backend_config - добавлено в 2.7		Группа пар ключ-значение для предоставления на этапе инициализации параметру -backend-config.
binary_path -		Путь к двоичному файлу terraform, относительно 'service_path', если не указан абсолютный путь.
force_init boolean	Варианты: нет ← да	Для предотвращения дублирования инфраструктуры, если файл состояния не найден, это принудительно выполнит `terraform init`. Как правило, этот параметр следует выключать, если вы не планируете развертывание совершенно новой инфраструктуры Terraform.
lock boolean	Варианты: нет да	Включить блокировку файла состояния, если используется служба, которая поддерживает блокировки (например, S3+DynamoDB) для хранения файла состояния.
lock_timeout -		Время удержания блокировки файла состояния, если используется служба, которая поддерживает блокировки (например, S3+DynamoDB).
plan_file -		Путь к существующему файлу плана Terraform для применения. Если этот параметр не указан, Ansible создаст новый план TF и выполнит его. Обратите внимание, что этот параметр обязателен, если у 'state' значение 'planned'.
project_path - / обязательно		Путь к корню каталога Terraform с файлами vars.tf/main.tf и т.д.
purge_workspace boolean добавлено в 2.7	Варианты: нет ← да	Работает только со значением state = absent Если значение true, рабочая область будет удалена после выполнения "terraform destroy". Рабочая область 'default' не будет удалена.
state -	Варианты: planned present ← absent	Целевое состояние данной стадии/проекта
state_file -		Путь к существующему файлу состояния Terraform для использования при построении плана. Если этот параметр не указан, будет использован файл по умолчанию `terraform.tfstate`. Этот параметр игнорируется, если указан параметр plan.
targets -		Список конкретных ресурсов для выбора в этом плане/приложении. Выбранные здесь ресурсы также автоматически включат все зависимости.
variables -		Группа пар ключ-значение для переопределения переменных шаблона или переменных в файлах переменных.
variables_file -		Путь к файлу переменных для Terraform, чтобы заполнить конфигурации TF.
workspace - добавлено в 2.7	По умолчанию: "default"	Рабочая область terraform для работы.

Примечания

Примечание

Чтобы просто запустить terraform plan, используйте режим проверки.

Примеры

# Basic deploy of a service
- terraform:
    project_path: '{{ project_dir }}'
    state: present

# Define the backend configuration at init
- terraform:
    project_path: 'project/'
    state: "{{ state }}"
    force_init: true
    backend_config:
      region: "eu-west-1"
      bucket: "some-bucket"
      key: "random.tfstate"

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:

Ключ		Возвращается	Описание
command строка		всегда	Полная команда `terraform`, созданная этим модулем, в случае, если вы хотите повторно запустить команду вне модуля или отладить проблему. Пример: terraform apply ...
outputs сложное		при успехе	Словарь всех выходов TF по их назначенному имени. Используйте `.outputs.MyOutputName.value`, чтобы получить значение. Пример: {"bukkit_arn": {"sensitive": false, "type": "string", "value": "arn:aws:s3:::tf-test-bukkit"}
	sensitive boolean	всегда	Указано ли Terraform это значение как конфиденциальное
	type строка	всегда	Тип значения (строка, целое число и т.д.)
	value -	всегда	Значение выхода, интерполированное Terraform
stdout строка		всегда	Полный вывод команды `terraform`, в случае, если вы хотите его отобразить или изучить журнал событий

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

Ryan Scott Brown (@ryansb)

Подсказка

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

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/terraform_module.html