アプリ構成

Takos を使ってサービスやソフトウェアを構成するときに使う public surface をまとめた章です。中心になるのは .takos/app.yml ですが、manifest だけでなく Workers、Containers、Routes、環境変数、MCP、OAuth、File Handlers の関係もここで扱います。

最小構成

apiVersion: takos.dev/v1alpha1
kind: App
metadata:
  name: my-app
spec:
  version: 0.1.0
  workers:
    web:
      build:
        fromWorkflow:
          path: .takos/workflows/deploy.yml
          job: bundle
          artifact: web
          artifactPath: dist/worker

セクション別ガイド

ガイド	内容
アプリマニフェスト	.takos/app.yml の全体像、パターン、完全な例
Workers	CF Workers の定義、ビルド、バインディング
Containers	Docker コンテナの定義、Worker との紐づけ
Routes	HTTP エンドポイントの公開
環境変数	テンプレート変数、値の注入
MCP Server	MCP Server の公開と認証
File Handlers	ファイルハンドラーの登録
OAuth	OAuth client の自動登録

次のステップ

• Takos 全体像 --- platform と用語から理解する
• アプリマニフェスト --- アプリ定義の中心となる spec を確認する
• サンプル集 --- コピペで始められるサンプル