Skip to content

Takoformどの provider にも依存しない、1つの provider

ポータブルでホスト中立な、Terraform / OpenTofu 用のリソース契約

コード例

hcl
terraform {
  required_providers {
    takoform = {
      source  = "registry.terraform.io/tako0614/takoform"
      version = "= 2.0.0"
    }
  }
}

provider "takoform" {
  endpoint = "https://host.example.com"
  space    = "prod"
}

resource "takoform_edge_worker" "example" {
  name                = "edge-worker"
  artifact_media_type = "application/vnd.takoform.edge-worker+tar"
  artifact_sha256     = "sha256:0f2c0c7ec3d0e2f34f1ea1f6b5f04f0b3aa03d0e6f2f2f8a7f0c5d9e4b1a8c37"
  artifact_url        = "https://artifacts.portable-conformance.invalid/edge-worker.tar"
  entrypoint          = "worker.mjs"
  runtime             = "javascript"
  runtime_version     = "2026.1"
  configuration       = { "LOG_LEVEL" = "info" }
}

資格情報・配置・価格は書きません。これらはホストが決めることで、state には 入りません。provider v2.0.0 は現在の公開済み client で、v1.0.3 は公開済みの Legacy client です。docs で使い方を確認してください。

リソース

9 種類はすべて forms.takoform.com/v1alpha20.1.0 候補です。

Resource宣言するもの
takoform_edge_workerダイジェストを固定した artifact から動く request/event アプリ
takoform_relational_databaseopen engine token で識別する relational database
takoform_object_bucketオブジェクトストレージ
takoform_key_value_storekey/value ストア
takoform_queueat-least-once でメッセージを配信するキュー
takoform_schedule接続したリソースを1つ呼び出す cron
takoform_container_serviceOCI イメージのダイジェストから動くサービス
takoform_stateful_entity参照可能な永続エンティティ
takoform_vector_index次元を固定したベクターインデックス

各リソースは read-only の interface (http.request@1sql.query@1object.storage@1queue.messages@1 など) を公開し、他のリソースから 名前と permission で接続できます。resource reference を参照してください。

どう動くか

  1. 宣言する — ポータブルなフィールドだけを書きます。name、artifact digest、 entrypoint、runtime、configuration、connections。
  2. ホストが実装する — provider は versioned な経路でホストを探し、 preview/apply、observe、refresh、delete を実行します。実装・配置・容量・ 資格情報・ルーティングはホストが決めます。
  3. 接続する — ホストが宣言済みの interface を公開し、他のリソースが 名前と permission を指定して接続します。

ステータス: Takoform は Experimental specification project です。現行の FormRef は forms.takoform.com/v1alpha2、現行の package envelope は packages.forms.takoform.com/v1alpha3 です。provider v1.0.3 は公開済みの Legacy client、provider v2.0.0 は現在の公開済み client です。 forms.takoform.com/v1alpha1 の公開済み Form Package identity 34件は、不変の Legacy 証跡です。現在、中央による承認や admission はありません。