---
title: "AppSailサービスの追加"
url: https://docs.catalyst.zoho.com/ja/cli/v1/add-appsail/
description: "Java、Node.js、PythonのCatalystマネージドランタイム、またはOCIイメージとしてのカスタムランタイムで、Catalyst AppSail Webサービスをプロジェクトディレクトリに追加し、クラウドにデプロイします。"
last_updated: 2026-08-17T12:16:04Z
service: All Services
type: general
---

# AppSailサービスの追加

### はじめに

[AppSail](https://docs.catalyst.zoho.com/ja/serverless/help/appsail/introduction/)は、あらゆる規模のWebサービスをクラウドにデプロイし、そのプラットフォームインスタンスを管理するために使用できるCatalystのサーバーレスプラットフォームです。AppSailサービスは、次の2つの方法のいずれかで初期化できます。

* **Catalystマネージドランタイムとして**：Catalystがサポートする特定のJava、Node.js、Pythonランタイムのアプリケーションを初期化し、リモートコンソールに直接デプロイします

* **コンテナイメージとして**：ローカルレジストリから任意のランタイムまたはフレームワークのアプリケーションのOCIイメージを初期化し、リモートコンソールにデプロイします

> **注意:** Catalystは、Linux AMD64（x86-64）プラットフォーム向けにビルドされた[OCI準拠のイメージ](https://github.com/opencontainers/image-spec)のデプロイのみをサポートしています。

どちらの場合も、デプロイ準備が整ったアプリのAppSailサービスを初期化し、このコマンドを使用してCatalystプロジェクトに関連付けることができます。

> **情報:** このコマンドを使用して、既存のCatalystプロジェクトディレクトリにAppSailサービスを追加できます。最初にプロジェクトを初期化した際に[AppSailを初期化](https://docs.catalyst.zoho.com/ja/cli/v1/initialize-resources/initialize-appsail/#initialize-appsail-as-a-custom-runtime)しなかった場合や、最初のAppSailサービスの後に追加のAppSailサービスを追加する場合に使用できます。まだプロジェクトを初期化していない場合は、最初に初期化する必要があります。また、[スタンドアロンコマンド](https://docs.catalyst.zoho.com/ja/cli/v1/deploy-resources/deploy-appsail/)を使用して、初期化なしでアプリを直接デプロイすることもできます。

既存のCatalystプロジェクトディレクトリで次のCLIコマンドを実行して、AppSailサービスを追加できます。

```sh
catalyst appsail:add
```

### CatalystマネージドランタイムとしてAppSailを追加

Catalystマネージドランタイム用のAppSailサービスを、アプリのディレクトリ内で直接、または新しいディレクトリから初期化できます。プロジェクトの初期化時にAppSailを選択していた場合、Catalystはクライアントの初期化後にセットアップを行います。

Catalystは、この方法でAppSailサービスが初期化されると、**[`app-config.json](https://docs.catalyst.zoho.com/ja/serverless/help/appsail/catalyst-managed-runtimes/key-concepts/#the-app-configjson-file)`**ファイルを作成します。

1. CLIは、ランタイムタイプとして**Catalyst-Managed Runtime**または**Docker Image**を選択するよう求めます。最初のオプションを選択してください。

![catalyst_cli_appsail_init_1](https://catalyst-docs-development.zohostratus.in/images/cli/initialize-resources/catalyst_cli_appsail_init_0.webp)

2. 「Y」を入力して**Enter**を押すと、既製のサンプルプロジェクトで開始できます。次に、リストからサンプルアプリを選択します。

![catalyst_cli_appsail_init_1](https://catalyst-docs-development.zohostratus.in/images/cli/initialize-resources/catalyst_cli_appsail_init_1.png)

サンプルアプリがディレクトリにダウンロードされます。プロンプトが表示されたら、名前を入力してください。

![catalyst_cli_appsail_init_1](https://catalyst-docs-development.zohostratus.in/images/cli/initialize-resources/catalyst_cli_appsail_init_2.png)

独自のアプリを初期化する場合は、「N」を入力して**Enter**を押してください。

3. 「Y」を入力して、ここがアプリの[ソースディレクトリ](https://docs.catalyst.zoho.com/ja/serverless/help/appsail/catalyst-managed-runtimes/key-concepts/#source-directory-and-build-path)かどうかを選択します。「N」を入力すると、CLIはディレクトリ内のアプリのソースの絶対パスを入力するよう求めます。入力後に**Enter**を押してください。

![catalyst_cli_appsail_init_1](https://catalyst-docs-development.zohostratus.in/images/cli/initialize-resources/catalyst_cli_appsail_init_3.png)

4. アプリの名前を入力します。アプリのビルドのメインファイルには、任意の名前を付けることができます。

![catalyst_cli_appsail_init_1](https://catalyst-docs-development.zohostratus.in/images/cli/initialize-resources/catalyst_cli_appsail_init_4.png)

> **注意:** アプリをJava WARファイルとしてビルドする場合、メインファイルを`root.war`と名付けるか、コードに応じて特定のコントローラーを追加する必要があります。

5. アプリの絶対[ビルドパス](https://docs.catalyst.zoho.com/ja/serverless/help/appsail/catalyst-managed-runtimes/key-concepts/#source-directory-and-build-path)を入力し、**Enter**を押してください。

![catalyst_cli_appsail_init_1](https://catalyst-docs-development.zohostratus.in/images/cli/initialize-resources/catalyst_cli_appsail_init_5.png)

6. アプリのスタックとランタイムを選択し、**Enter**を押してください。

![catalyst_cli_appsail_init_1](https://catalyst-docs-development.zohostratus.in/images/cli/initialize-resources/catalyst_cli_appsail_init_6.png)

Javaを選択した場合、CLIはさらに**Java SE**または**Java WAR**をアプリのデプロイ可能な形式として選択するよう求めます。これについての詳細は[こちら](https://docs.catalyst.zoho.com/ja/serverless/help/appsail/catalyst-managed-runtimes/key-concepts/)をご覧ください。

![catalyst_cli_appsail_init_1](https://catalyst-docs-development.zohostratus.in/images/cli/initialize-resources/catalyst_cli_appsail_init_7.png)

他のスタックを選択した場合、このステップはスキップされます。

AppSailが選択したソースディレクトリに追加され、アプリがCatalystプロジェクトに関連付けられました。設定は[`catalyst.json`](https://docs.catalyst.zoho.com/ja/cli/v1/project-directory-structure/catalyst-json/)ファイルに更新されます。

![catalyst_cli_appsail_init_1](https://catalyst-docs-development.zohostratus.in/images/cli/initialize-resources/catalyst_cli_appsail_init_8.webp)

Catalystは、この方法でAppSailサービスが追加されると、[`app-config.json](https://docs.catalyst.zoho.com/ja/serverless/help/appsail/catalyst-managed-runtimes/key-concepts/#the-app-configjson-file)`ファイルを作成します。これは、アプリのソースディレクトリ内のAppSail固有の唯一のファイルになります。デプロイ前に、このファイルでスタートアップコマンド、環境変数、メモリなどの値を編集できます。

![catalyst_cli_appsail_init_1](https://catalyst-docs-development.zohostratus.in/images/cli/initialize-resources/catalyst_cli_appsail_init_9.webp)

### カスタムランタイムとしてAppSailを追加

新しいディレクトリから、アプリの準拠OCIイメージ用にAppSailを初期化できます。Catalystは、アプリのイメージをAppSailに関連付けるために使用できる2つのプロトコルをサポートしています。各プロトコルには、識別と機能のための個別のスキーマがあります。

* **Docker Imageプロトコル:** ローカルDockerレジストリに存在するアプリの事前ビルドされたイメージを関連付けるために使用します。イメージはビルドされ、ローカルレジストリを指すように[タグ付け](https://docs.docker.com/reference/cli/docker/image/tag/)されている必要があります。例: *docker://localhost/expres-hw:latest*

* **Docker Archiveプロトコル:** システムのディレクトリにあるアプリの事前ビルドされたイメージのアーカイブファイル（.tarまたは.tar.gz）を指定するために使用します。例: *docker-archive://test.tar*

> **注意:** `.tar`ファイルは、通常[`docker save`コマンド](https://docs.docker.com/reference/cli/docker/image/save/)で生成できます。

コンテナイメージのAppSailでは、名前以外の詳細を提供する必要はありません。OCIイメージではすでに定義されているため、アプリのソースまたはビルドパス、スタック、スタートアップコマンドの設定は不要です。

1. CLIは、ランタイムタイプとしてCatalyst-Managed Runtimeまたは**Docker Image**を選択するよう求めます。2番目のオプションを選択してください。

![catalyst_cli_appsail_init_1](https://catalyst-docs-development.zohostratus.in/images/cli/initialize-resources/catalyst_cli_appsail_init_01.png)

2. プロトコルとして**Docker Image**または**Docker Archive**を選択します。

![catalyst_cli_appsail_init_1](https://catalyst-docs-development.zohostratus.in/images/cli/initialize-resources/catalyst_cli_appsail_init_02.png)

3. **Docker Imageプロトコル:**

**Docker Image**を選択した場合、CLIはローカルDockerレジストリ内の利用可能なすべてのイメージとタグを一覧表示します。必要なイメージを選択してください。

![catalyst_cli_appsail_init_1](https://catalyst-docs-development.zohostratus.in/images/cli/initialize-resources/catalyst_cli_appsail_init_03.png)

**Docker Archiveプロトコル:**

**Docker Archive**を選択した場合、CLIはローカルシステム内のアプリのTARファイルイメージの絶対パスを入力するよう求めます。

![catalyst_cli_appsail_init_1](https://catalyst-docs-development.zohostratus.in/images/cli/initialize-resources/catalyst_cli_appsail_init_04.png)

> **注意:** AppSailの設定が[`catalyst.json`](https://docs.catalyst.zoho.com/ja/cli/v1/project-directory-structure/catalyst-json/)ファイルに保存される場合、パスはそのファイルの場所からの相対パスとして保存されます。

4. AppSailサービスの名前を入力します。任意の名前を付けることができます。

![catalyst_cli_appsail_init_1](https://catalyst-docs-development.zohostratus.in/images/cli/initialize-resources/catalyst_cli_appsail_init_05.png)

AppSailがローカルディレクトリに追加され、アプリのイメージがAppSailサービスに関連付けられました。設定は[`catalyst.json`](https://docs.catalyst.zoho.com/ja/cli/v1/project-directory-structure/catalyst-json/)ファイルに更新されます。

![catalyst_cli_appsail_init_1](https://catalyst-docs-development.zohostratus.in/images/cli/initialize-resources/catalyst_cli_appsail_init_06.png)

> **注意:** コンテナイメージでAppSailを追加した場合、[`app-config.json](https://docs.catalyst.zoho.com/ja/serverless/help/appsail/catalyst-managed-runtimes/key-concepts/#the-app-configjson-file)`ファイルは作成されません。すべてのアプリの仕様は`catalyst.json`ファイルに保存されます。このファイルでアプリの特定のカスタム設定を追加できます。詳細は[こちら](https://docs.catalyst.zoho.com/ja/serverless/help/appsail/appsail-configurations/)を参照してください。

アプリにビジネスロジックをコーディングし、localhostを通じてAppSailサービスを[サーブ](https://docs.catalyst.zoho.com/ja/cli/v1/serve-resources/serve-all-resources/#serve-appsail-applications)して[デバッグ](https://docs.catalyst.zoho.com/ja/serverless/help/appsail/debug-appsail/)およびテストするか、リモートコンソールに直接[デプロイ](https://docs.catalyst.zoho.com/ja/cli/v1/deploy-resources/deploy-appsail/)できます。