Takos Docs

テーマ切替

Takos をセルフホストする ​

Takos はTakoform対応hostまたは自分のCloudflareアカウントへ配置できます。このリポジトリの deploy/opentofu/takoform と deploy/opentofu/cloudflare が、同じproduct resource contractをそれぞれのproviderへ写します。

このページは運用者向けです。Takos を利用するだけなら、スタートガイド へ進んでください。

何が配置されるか ​

既定のTakoform adapterは、選択したTakoform対応hostへ次の論理リソースを要求します。直接Cloudflare adapterを選んだ場合は、それぞれをWorkers、D1、R2、KV、Queues、Vectorize、Containersへ写します。

  • Takos の Worker と静的 UI
  • relational database
  • object bucket
  • key-value store
  • Queue
  • vector index
  • エージェント実行に必要な構成

OpenTofu はリソースと Worker に渡す binding を作ります。Worker のコードは、この binding を使って起動します。

Takosumi は必須か ​

OpenTofu モジュール自体は標準的な IaC です。運用者が自分の方法で tofu plan / tofu apply を実行できます。

Takosumi を使うと、Git ソース、確認済み plan、apply の結果、output、監査記録を一つの管理画面と API で扱えます。Takos 自体は、これらのデプロイ制御を実装しません。

必要なもの ​

  • OpenTofu 1.5 以降
  • 選択したTakoform hostへの接続、またはCloudflare direct用のアカウントと必要な権限
  • Takosumi Accounts の URL、issuer、OIDC client
  • Takos の公開 URL
  • Worker artifact をアップロードする手順
  • 本番用の secret を保管する仕組み

secret を .tfvars、OpenTofu output、Git リポジトリへ保存しないでください。

基本の流れ ​

  1. このリポジトリを tag または commit に固定する
  2. 選んだadapterの変数を確認する。Cloudflare directでは deploy/opentofu/cloudflare/opentofu.tfvars.example を参考にする
  3. tofu init と tofu plan を実行する
  4. 作成・変更・削除と料金を確認する
  5. 確認した plan を apply する
  6. 同じ commit の Worker artifact を app-owned materializer で反映する
  7. 公開 URL、ログイン、Chat、エージェント実行を確認する

Cloudflareへ直接配置する例:

sh
cd deploy/opentofu/cloudflare
tofu init
tofu plan -var-file=opentofu.tfvars
tofu apply

実際の入力名は 環境と変数 を参照してください。Worker の公開は デプロイ手順 に分けています。 Takosumi lifecycle action との正確な境界は Worker artifact materializer を参照してください。

アプリとの連携 ​

Workspace に追加するアプリも、Git リポジトリにある OpenTofu モジュールとして扱えます。

アプリは、通常の OpenTofu output で起動 URL などを返します。Takos から使う画面、MCP、ファイル形式などは、アプリの公開情報として Takosumi が記録します。認証情報は output に含めません。

詳しくは OpenTofu output とアプリの公開先 を参照してください。

配置後の確認 ​

  • 公開 URL が 200 を返す
  • OIDC でサインインできる
  • Workspace を作成または開ける
  • Chat からエージェントを実行できる
  • 完了または失敗の状態が記録される
  • 必要な D1、R2、KV、Queue へアクセスできる
  • ロールバックする commit と手順が決まっている

問題がある場合は トラブルシューティング を参照してください。

関連ページ ​