terraform provider tfe

HCP Terraform и корпоративный поставщик Terraform

Официальный поставщик Terraform для HCP Terraform и Terraform Enterprise.

Поскольку Terraform Enterprise — это самостоятельный дистрибутив HCP Terraform, этот поставщик поддерживает варианты использования как в облаке, так и в корпоративном режиме. Во всей/большинстве документации платформа всегда будет указываться как «Terraform Enterprise», но функция будет явно отмечена как поддерживаемая только в одном или другом, если это применимо (редко).

Обратите внимание, что этот провайдер находится в стадии бета-тестирования и может быть изменен (хотя в целом он довольно стабилен). Мы сообщим о любых критических изменениях, выпустив новые версии. До выпуска версии 1.0 любые незначительные изменения версии будут указывать на возможные критические изменения. Изменения версий исправлений будут использоваться как для исправлений ошибок, так и для некритических изменений.

• Документация: https://registry.terraform.io/providers/hashicorp/tfe/latest/docs.
• Веб-сайт : https://registry.terraform.io/providers/hashicorp/tfe / https://www.terraform.io.
• Форум обсуждений : https://discuss.hashicorp.com/c/terraform-providers.

Установка

Объявите провайдера в своей конфигурации, и terraform init автоматически получит и установит провайдера из реестра Terraform:

 terraform {
  required_providers {
    tfe = {
      version = " ~> 0.60.1 "
    }
  }
}

Для производственного использования вам следует ограничить допустимые версии поставщика с помощью конфигурации (как указано выше), чтобы гарантировать, что новые версии с критическими изменениями не будут автоматически устанавливаться terraform init в будущем. Поскольку этот поставщик все еще имеет нулевую версию, вам следует ограничить допустимые версии поставщика дополнительной версией.

Приведенный выше фрагмент с использованием required_providers предназначен для Terraform 0.13+; если вы используете Terraform версии 0.12, вы можете ограничить, добавив вместо этого ограничение версии в блок provider :

 provider "tfe" {
  version = " ~> 0.60.1 "
  ...
}

Начиная с версии 0.24.0, этому провайдеру требуется Terraform >= 0,12.

Дополнительные сведения об установке поставщика и ограничении версий поставщика см. в документации «Требования к поставщику».

Использование

Создайте токен API пользователя или команды в HCP Terraform или Terraform Enterprise и используйте токен в блоке конфигурации поставщика:

 provider "tfe" {
  hostname = var . hostname # Optional, for use with Terraform Enterprise. Defaults to app.terraform.io.
  token    = var . token
}

# Create an organization
resource "tfe_organization" "org" {
  # ...
}

Существует несколько других способов настройки токена аутентификации, в зависимости от вашего варианта использования. Другие методы см. в документации по аутентификации.

Дополнительные сведения о настройке поставщиков в целом см. в документации по настройке поставщиков.

Разработка

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