terraform provider tfe

Penyedia HCP Terraform dan Terraform Enterprise

Penyedia resmi Terraform untuk HCP Terraform dan Terraform Enterprise.

Karena Terraform Enterprise adalah distribusi HCP Terraform yang dihosting sendiri, penyedia ini mendukung kasus penggunaan Cloud dan Enterprise. Di semua/sebagian besar dokumentasi, platform akan selalu dinyatakan sebagai 'Terraform Enterprise' - namun sebuah fitur akan secara eksplisit dicatat sebagai hanya didukung di salah satu fitur tersebut, jika berlaku (jarang).

Perhatikan bahwa penyedia ini masih dalam versi beta dan dapat berubah (walaupun secara umum cukup stabil). Kami akan menunjukkan perubahan apa pun yang dapat mengganggu dengan merilis versi baru. Hingga rilis v1.0, perubahan versi kecil apa pun akan menunjukkan kemungkinan perubahan yang dapat menyebabkan gangguan. Perubahan versi patch akan digunakan untuk perbaikan bug dan perubahan yang tidak dapat menyebabkan gangguan.

• Dokumentasi: https://registry.terraform.io/providers/hashicorp/tfe/latest/docs
• Situs web : https://registry.terraform.io/providers/hashicorp/tfe / https://www.terraform.io
• Forum diskusi : https://discuss.hashicorp.com/c/terraform-providers

Instalasi

Deklarasikan penyedia dalam konfigurasi Anda dan terraform init akan secara otomatis mengambil dan menginstal penyedia untuk Anda dari Terraform Registry:

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

Untuk penggunaan produksi, Anda harus membatasi versi penyedia yang dapat diterima melalui konfigurasi (seperti di atas), untuk memastikan bahwa versi baru dengan perubahan yang dapat menyebabkan gangguan tidak akan diinstal secara otomatis oleh terraform init di masa mendatang. Karena penyedia ini masih pada versi nol, Anda harus membatasi versi penyedia yang dapat diterima pada versi minor.

Cuplikan di atas menggunakan required_providers adalah untuk Terraform 0.13+; jika Anda menggunakan Terraform versi 0.12, Anda dapat membatasi dengan menambahkan batasan versi ke blok provider :

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

Sejak v0.24.0, penyedia ini memerlukan Terraform >= 0.12

Untuk informasi lebih lanjut tentang instalasi penyedia dan membatasi versi penyedia, lihat dokumentasi Persyaratan Penyedia.

Penggunaan

Buat token API pengguna atau tim di HCP Terraform atau Terraform Enterprise, dan gunakan token di blok konfigurasi penyedia:

 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" {
  # ...
}

Ada beberapa cara lain untuk mengonfigurasi token autentikasi, bergantung pada kasus penggunaan Anda. Untuk metode lainnya, lihat dokumentasi Autentikasi

Untuk informasi selengkapnya tentang mengonfigurasi penyedia secara umum, lihat dokumentasi Konfigurasi Penyedia.

Perkembangan

Kami telah mengembangkan beberapa pedoman untuk membantu Anda mempelajari lebih lanjut tentang kompilasi penyedia, menggunakannya secara lokal, dan memberikan kontribusi perubahan yang disarankan dalam panduan kontribusi.