Caputchin
الأتمتة

استخدم Terraform أو OpenTofu

يتيح لك مزوّد Caputchin الرسمي إدارة حسابك كبنية تحتية ككود: تعلن الفرق، ومفاتيح المواقع، وسياسة الأمان، والأعضاء، والرموز في ملفّات .tf وتطبّقها كأي مورد آخر. إنه API الإدارة نفسه كأي شيء آخر تحت الأتمتة، معبَّرًا عنه كموارد Terraform.

تُنشَر مرة واحدة وتعمل مع Terraform وOpenTofu كليهما من المصدر نفسه؛ الـ HCL متطابق، ولا يختلف سوى ثنائي الـ CLI‏ (terraform أو tofu) والسجلّ. في كل ما أدناه، استخدم أيًّا تشغّل.

اسكك رمز وصول

يقرأ المزوّد رمزه من متغيّر البيئة CAPUTCHIN_MANAGEMENT_TOKEN (موصى به، كي يبقى خارج المصدر). كلا نوعي الرمز يعمل (انظر مصادقة الـ API): رمز وصول شخصي لبنية الحساب الكاملة، أو رمز وصول فريق محصور بالفرق التي يديرها إعدادك.

export CAPUTCHIN_MANAGEMENT_TOKEN=cpt_pat_...

هناك حالة بيضة ودجاجة: يستطيع المزوّد أيضًا سكّ الرموز (موردا caputchin_account_token وcaputchin_troop_pat)، لكنه يحتاج رمزًا ليصادق من الأساس. اسكك الأول يدويًّا في لوحة التحكّم، ثم دع Terraform يدير البقية.

أعدّ المزوّد

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" نفسه يُحلّ من Terraform Registry وOpenTofu Registry، فالكتلة هي ذاتها تحت أيّ أداة.

مثال مشروح: فريق بمفتاح موقع محكوم ببوّابة

ينشئ هذا فريقًا، ومفتاح موقع فيه، ويشغّل بوّابة اللعبة لذلك المفتاح:

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
}

ثم، بأيّ أداة:

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

‏secret مفتاح الموقع سمة محسوبة حسّاسة؛ اقرأها من الحالة (terraform output) لإعداد التحقّق على خادمك الخلفي. كل تطبيق منسوب إلى رمزك في سجلّ التدقيق على Apex، فتغيير عبر Terraform قابل للتتبّع كتحرير في لوحة التحكّم.

ما الذي تستطيع إدارته

تغطّي الموارد السطح نفسه كلوحة التحكّم: الفرق وأعضاؤها ورموزها، ومفاتيح المواقع، وإعدادات الأمان، والتحقّق المُستضاف، وتخصيص اللعبة والعلامة البيضاء، ورموز الحساب. تتيح مصادر البيانات قراءة الفرق والمواقع ومعلومات الحساب والإحصاءات القائمة إلى إعداد.

المرجع الكامل

كل مورد ومصدر بيانات، بكل وسائطه وسماته وصياغة استيراده، على صفحة سجلّ المزوّد. إنه مولَّد من مصدر المزوّد، فيتتبّع النسخة المنشورة بدقّة:

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

للعمليات الأساسية التي يؤدّيها كل مورد، انظر مرجع الـ API التفاعلي.

انظر أيضًا

مرجع أدوات MCP

السابق

شغّل لعبتك الخاصة

التالي

في هذه الصفحة

اسكك رمز وصولأعدّ المزوّدمثال مشروح: فريق بمفتاح موقع محكوم ببوّابةما الذي تستطيع إدارتهالمرجع الكاملانظر أيضًا