---
title: "CLIからのデプロイ"
url: https://docs.catalyst.zoho.com/ja/serverless/help/appsail/custom-runtimes/deploy-from-cli/
description: "Catalyst AppSailは、Catalyst Serverlessのフルマネージドプラットフォームであり、Java、Node.js、Pythonのマネージドランタイム、またはOCIイメージとしてのカスタムランタイムでWebサービスを簡単に開発・デプロイできます。"
last_updated: 2026-08-17T12:16:04Z
service: Serverless
type: general
---

# CLIからカスタムランタイムとしてAppSailをデプロイする

### AppSailサービスの初期化または追加

[Catalyst CLI](https://docs.catalyst.zoho.com/ja/cli/v1/cli-command-reference/)を使用して、カスタムランタイムアプリ用のAppSailサービスをアプリのディレクトリ内で直接、または新しいディレクトリから[初期化](https://docs.catalyst.zoho.com/ja/cli/v1/initialize-resources/initialize-appsail/)できます。また、他のリソースが初期化されている既存のCatalystプロジェクトディレクトリに[AppSailサービスを追加](https://docs.catalyst.zoho.com/ja/cli/v1/add-appsail/)することもできます。初期化または追加の後に、[AppSailサービスをデプロイ](https://docs.catalyst.zoho.com/ja/serverless/help/appsail/custom-runtimes/deploy-from-cli/#appsailサービスのデプロイ)できます。

新しいディレクトリでAppSailサービスを初期化するには、ローカルマシンにプロジェクト用のフォルダを作成し、ターミナルからそのフォルダに移動します。そのディレクトリから以下のコマンドを実行してプロジェクトを初期化します：

```sh
catalyst init
```

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

```sh
catalyst appsail:add
```

Catalystは、アプリのイメージをAppSailに関連付けるために使用できる、カスタムランタイムアプリ用の2つのプロトコルをサポートしています。各プロトコルには、識別と機能のための固有のスキーマがあります。

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

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

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

コンテナイメージの場合、AppSailの名前以外の詳細を提供する必要はありません。アプリのソースまたはビルドパス、スタック、スタートアップコマンドは、イメージ内ですでに定義されているため、設定する必要はありません。AppSailサービスの初期化または追加の手順は、以下に説明するとおり同じです：

1. AppSailの初期化時に、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 Protocol:**

**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 Protocol:**

**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)

> **Note:** 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)

> **Note:** コンテナイメージで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/serverless/help/appsail/catalyst-managed-runtimes/key-concepts/#the-app-configjson-file)して[デバッグ](https://docs.catalyst.zoho.com/ja/serverless/help/appsail/catalyst-managed-runtimes/key-concepts/#the-app-configjson-file)やテストを行うか、リモートコンソールに直接[デプロイ](https://docs.catalyst.zoho.com/ja/serverless/help/appsail/catalyst-managed-runtimes/key-concepts/#the-app-configjson-file)できます。

### AppSailサービスのデプロイ

Catalystでは、[AppSailサービス](https://docs.catalyst.zoho.com/ja/serverless/help/appsail/introduction/)を2つの方法でデプロイできます：

* **通常デプロイ:** 通常デプロイは、[プロジェクトの初期化](https://docs.catalyst.zoho.com/ja/cli/v1/initialize-resources/initialize-appsail/)時または[既存のプロジェクトディレクトリへの追加](https://docs.catalyst.zoho.com/ja/cli/v1/add-appsail/)時にAppSailリソースをすでに初期化している場合に適用されます。

* **スタンドアロンデプロイ:** 事前にAppSailサービスとして初期化せずに、アプリを直接スタンドアロンデプロイできます。

AppSailに関連付けられたアプリのOCIイメージが、プロジェクトの設定ファイルとともにデプロイされます。

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

### 通常デプロイ

AppSailアプリがプロジェクトディレクトリですでに初期化されている場合、`catalyst deploy`コマンドを実行すると、CLIは他のプロジェクトリソースとともにアプリを自動的にデプロイします。CLIはデプロイ後にアプリのエンドポイントURLを表示し、それを使用してアプリを開くことができます。

![Deploy AppSail](https://catalyst-docs-development.zohostratus.in/images/cli/deploy-resources/cli-appsail-deploy-proj-init-1.png)

プロジェクトディレクトリに複数のAppSailアプリがある場合、CLIからすべてのURLエンドポイントにアクセスできます。

アプリのソースディレクトリから以下のコマンドを実行して、AppSailサービスのみをデプロイすることもできます。

```sh
catalyst deploy appsail
```

デプロイメントプロセスは同じです。

![Deploy AppSail](https://catalyst-docs-development.zohostratus.in/images/cli/deploy-resources/cli-appsail-deploy-proj-init-2.webp)

### スタンドアロンデプロイ

スタンドアロンデプロイコマンドは、Catalystプロジェクトディレクトリのルートから実行する必要があります。つまり、`catalyst.json`およびその他の[プロジェクト依存ファイル](https://docs.catalyst.zoho.com/ja/cli/v1/project-directory-structure/introduction/)がディレクトリに存在している必要があります。

> **Note:** [コンテナイメージのデプロイに固有のオプション](https://docs.catalyst.zoho.com/ja/serverless/help/appsail/custom-runtimes/deploy-from-cli/#スタンドアロンデプロイのappsailオプション)なしでスタンドアロンデプロイコマンドを実行すると、CLIはデフォルトでCatalystマネージドランタイムアプリに関連する入力のみを求めます。

スタンドアロンデプロイコマンドでは、コンテナイメージとしてアプリをデプロイするために以下のオプションを使用できます：`--name <name>`、`--source <image>`、`--command <command>`、`--port <port>`。最初の2つは必須で、最後の2つはオプションであり、コンテナイメージ定義で既に設定されているスタートアップコマンドやポートを上書きするために使用できます。オプションの詳細は以下で説明します。

AppSailアプリのスタンドアロンデプロイは、以下の方法で実行できます：

1. アプリのデプロイ可能なファイルがあるディレクトリに移動し、以下のコマンドを実行します：

```sh
catalyst deploy appsail
```

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

![Deploy AppSail](https://catalyst-docs-development.zohostratus.in/images/cli/deploy-resources/catalyst-appsail-standalone-deploy-1.webp)

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

3. リストからアプリのビルドパスを選択し、**Enter** を押します。

![Deploy AppSail](https://catalyst-docs-development.zohostratus.in/images/cli/deploy-resources/catalyst-appsail-standalone-deploy-2.webp)

4. アプリのスタックを選択し、**Enter** を押します。

![Deploy AppSail](https://catalyst-docs-development.zohostratus.in/images/cli/deploy-resources/catalyst-appsail-standalone-deploy-3.webp)

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

![Deploy Functions](https://catalyst-docs-development.zohostratus.in/images/cli/deploy-resources/catalyst-appsail-standalone-deploy-4.webp)

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

5. さらに、使用するスタック、フレームワーク、Webサーバーに基づいてアプリのスタートアップコマンドを指定する必要があります。この情報は直接デプロイされ、アプリのデプロイ後にコンソールのConfigurationsセクションで利用可能になります。

![Deploy Functions](https://catalyst-docs-development.zohostratus.in/images/cli/deploy-resources/catalyst-appsail-standalone-deploy-5.webp)

これで、AppSailリソースとして初期化することなく、アプリが関連するリモートプロジェクトに直接デプロイされました。CLIに表示されるエンドポイントURLを使用してアプリにアクセスできます。

![Deploy Functions](https://catalyst-docs-development.zohostratus.in/images/cli/deploy-resources/catalyst-appsail-standalone-deploy-6.webp)

### スタンドアロンデプロイのAppSailオプション

catalyst deploy appsailスタンドアロンコマンドは、以下のオプションをサポートしています。一部はCatalystマネージドランタイムとコンテナイメージアプリの両方に適用されますが、一部は一方にのみ適用されます。

**--name <name>**           

アプリの名前を指定するために使用します。Catalystマネージドランタイムとコンテナイメージアプリの両方に適用されます。例：

```sh
--name DemoApp
```

**--command <command>**      

アプリの[スタートアップコマンド](https://docs.catalyst.zoho.com/ja/serverless/help/appsail/appsail-configurations/#startup-commands)を指定するために使用します。Catalystマネージドランタイムとコンテナイメージアプリの両方に適用されます。コンテナイメージ定義で既に設定されている値を上書きします。例：

```sh
--command npm start
```

**--source <image>**      

デプロイするDockerイメージのソースを指定するために使用します。コンテナイメージアプリにのみ適用されます。Docker imageプロトコルの場合は「*docker://*」で、Docker archiveプロトコルの場合は「*docker-archive://*」で始める必要があります。詳細は[こちらを参照](https://docs.catalyst.zoho.com/ja/cli/v1/initialize-resources/initialize-appsail/#initialize-appsail-as-a-custom-runtime)してください。例：

```sh
--source docker://example-voting-app-worker:latest
```

**--port <port>**           

AppSailのポートを指定するために使用します。コンテナイメージアプリにのみ適用されます。コンテナイメージ定義で既に設定されている値を上書きします。例：

```sh
--port 8000
```