Dispatch Namespace

このページでわかること: dispatch namespace を使ったマルチテナントデプロイの仕組み。

--namespace を指定すると、Worker は Cloudflare の dispatch namespace 内にデプロイされます。テナントごとに Worker を論理分離する場合に使います。

基本的な使い方

takos apply --env staging --namespace takos-staging-tenants

namespace あり / なしの違い

項目	namespace なし	namespace あり
Worker 名	{workerName}	{groupName}-{workerName}
service binding の参照先	{targetName}	{groupName}-{targetName}
wrangler.toml	通常	dispatch_namespace field が追加

マルチテナントの構成例

テナントごとに同じアプリを namespace 内にデプロイする場合:

# テナント A
takos apply --env production \
  --namespace production-tenants \
  --group tenant-a

# テナント B
takos apply --env production \
  --namespace production-tenants \
  --group tenant-b

--group でグループ名を指定すると、Worker 名のプレフィックスが変わります。これにより、同じ namespace 内で複数テナントの Worker を共存させられます。

target 指定との組み合わせ

namespace は全体 apply にも部分 apply にも使えます。

takos apply \
  --env staging \
  --namespace takos-staging-tenants \
  --target workers.web

注意点

• namespace 内の Worker は、namespace 外から直接アクセスできません。dispatcher Worker 経由でアクセスします
• namespace の作成自体は Cloudflare ダッシュボードまたは API で事前に行う必要があります
• namespace を使う場合、service binding の参照先も namespace 内の名前に変わります

次のステップ

• apply --- takos apply の詳細
• Store 経由デプロイ --- Store 経由のデプロイ
• トラブルシューティング --- よくあるエラーと対処