mcpField
C
catalyst-appsail

catalyst-appsail

github.com/catalystbyzohoクラウド・DevOps701.1k 回インストール今日更新
リポジトリ

catalyst-appsail について

catalyst-appsail は Zoho Catalyst 上で AppSail アプリをデプロイ、運用するためのガイダンススキルです。ランタイムの選択や設定ルールを案内し、AppSail と Functions の違いを説明します。

主な機能

  1. 01マネージドランタイムと Docker の解説
  2. 02AppSail の設定とデプロイの説明
  3. 03Catalyst のリッスンポート変数の指定
  4. 04AppSail と Functions の比較

活用シーン

  1. 01Node.js、Java、Python アプリのデプロイ
  2. 02Catalyst での常駐サーバーのホスティング
  3. 03AppSail と Functions の選択

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/catalystbyzoho/agent-skills --skill catalyst-appsail

インストール後、Claude Code で/catalyst-appsailを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
appsail-basics.md
appsail-crossorigin.md
appsail-deploy.md

詳細

仕組み

  1. ランタイムを特定する — マネージドランタイム（Node.js、Java、Python）か、カスタム Docker コンテナかを確認します。

  2. references/appsail-basics.md を読み込む — PORT の設定、プロジェクト構成、Dockerfile の要件を確認します。デプロイコマンドと環境変数については、references/appsail-deploy.md を読み込みます。

  3. PORT のルール — 必ず process.env.X_ZOHO_CATALYST_LISTEN_PORT を使用し、PORT や 3000 をハードコードしないでください。

  4. AppSail と Functions のどちらを選ぶか — ユーザーがどちらを使うべきか判断できない場合は、次の表を適用します。

    Catalyst FunctionsAppSail
    コード構成Catalyst 固有のテンプレートが必要任意のフレームワーク、任意の形式で完全に独立
    ユースケースHTTP ハンドラー、イベント、cron、Zoho 連携永続サーバー、長時間実行プロセス、Docker
    課金API 呼び出しごとインスタンスの稼働時間ごと
    依存関係の管理Catalyst が処理すべてのライブラリとフレームワークを自分で管理

トリガー

次の内容がある場合に、このスキルを使用します：「AppSail」、「persistent server」、「Docker on Catalyst」、「backend hosting」、「X_ZOHO_CATALYST_LISTEN_PORT」、「appsail:add」、「catalyst managed runtime」、「deploy Express app」、「AppSail vs Functions」、「long-running process on Catalyst」、「containerized app on Catalyst」。

リファレンス

リファレンス次の内容に関するクエリの場合に読み込む
references/appsail-basics.mdランタイム、プロジェクト構成、app-config.json のフィールド、Node.js／Docker のテンプレート、SDK のバージョン
references/appsail-deploy.mdデプロイコマンド（Path A/B/C）、環境変数、ヘルスチェック、AppSail の URL パターン、構成
references/appsail-crossorigin.mdSlate と AppSail のクロスオリジンエラー、MCP を介した CORS の設定、catalyst_auth、カスタムドメインの SSL

コメント

Markdown 対応