Pakai Terraform atau OpenTofu

Penyedia resmi Caputchin membiarkanmu mengelola akunmu sebagai infrastructure-as-code: deklarasikan tim, kunci situs, kebijakan keamanan, anggota, dan token di berkas .tf dan terapkan seperti sumber daya lain mana pun. Ia adalah management API yang sama dengan semua hal lain di bawah otomasi, dinyatakan sebagai sumber daya Terraform.

Ia dipublikasikan sekali dan berfungsi dengan baik Terraform maupun OpenTofu dari sumber yang sama; HCL-nya identik, hanya biner CLI (terraform atau tofu) dan registry yang berbeda. Di mana pun di bawah, pakai yang mana pun yang kamu jalankan.

Cetak sebuah access token

Penyedia membaca token-nya dari variabel lingkungan CAPUTCHIN_MANAGEMENT_TOKEN (disarankan, agar ia tetap di luar sumber). Salah satu jenis token berfungsi (lihat autentikasi API): sebuah personal access token untuk infrastruktur seluruh-akun, atau sebuah troop access token tercakup ke tim yang dikelola konfigurasimu.

export CAPUTCHIN_MANAGEMENT_TOKEN=cpt_pat_...

Ada kasus ayam-dan-telur: penyedia juga bisa mencetak token (sumber daya caputchin_account_token dan caputchin_troop_pat), tapi ia butuh sebuah token untuk berautentikasi sejak awal. Cetak yang pertama dengan tangan di dasbor, lalu biarkan Terraform mengelola sisanya.

Konfigurasi penyedia

terraform {
  required_providers {
    caputchin = {
      source  = "caputchin/caputchin"
      version = "~> 0.1"
    }
  }
}

# Token from CAPUTCHIN_MANAGEMENT_TOKEN; endpoint defaults to https://caputchin.com/api.
provider "caputchin" {}

source = "caputchin/caputchin" yang sama menyelesaikan dari Terraform Registry dan OpenTofu Registry, jadi blok-nya sama di bawah salah satu alat.

Contoh kerja: sebuah tim dengan kunci situs bergerbang

Ini membuat sebuah tim, sebuah kunci situs di dalamnya, dan menyalakan gerbang game untuk key itu:

resource "caputchin_troop" "shop" {
  name = "shop-team"
}

resource "caputchin_site_key" "shop_frontend" {
  name     = "shop-frontend"
  troop_id = caputchin_troop.shop.id
}

resource "caputchin_site_security_settings" "shop_frontend" {
  site_id      = caputchin_site_key.shop_frontend.id
  require_game = true
}

# The public key is an attribute; the secret is sensitive, in state only.
output "shop_site_key" {
  value = caputchin_site_key.shop_frontend.key
}

Lalu, dengan salah satu alat:

terraform init && terraform apply
# or
tofu init && tofu apply

secret kunci situs adalah atribut terkomputasi yang sensitif; baca ia dari state (terraform output) untuk mengonfigurasi verifikasi backend-mu. Setiap apply diatribusikan ke token-mu di log audit di Apex, jadi sebuah perubahan lewat Terraform sama bisa-dilacaknya dengan suntingan dasbor.

Apa yang bisa kamu kelola

Sumber daya mencakup permukaan yang sama dengan dasbor: tim dan anggota serta token mereka, kunci situs, pengaturan keamanan, verifikasi terhosting, kustomisasi game dan white-label, dan token akun. Sumber data membiarkanmu membaca tim, situs, info akun, dan statistik yang ada ke dalam sebuah konfigurasi.

Referensi lengkap

Setiap sumber daya dan sumber data, dengan semua argumen dan atribut serta sintaks impor-nya, ada di halaman registry penyedia. Ia dihasilkan dari sumber penyedia, jadi ia melacak versi yang dirilis persis:

Terraform Registry: registry.terraform.io/providers/caputchin/caputchin
OpenTofu Registry: search.opentofu.org/provider/caputchin/caputchin

Untuk operasi mendasar yang dilakukan tiap sumber daya, lihat referensi API interaktif.

Lihat juga

Kelola Caputchin dari API: API HTTP yang menjadi dasar penyedia.
Pakai server MCP: permukaan agen-AI.
Tim dan kunci situs: sumber daya yang kamu kelola.