--- title: "AppSailの設定" url: https://docs.catalyst.zoho.com/ja/serverless/help/appsail/appsail-configurations/ description: "Catalyst AppSailは、Catalyst Serverlessのフルマネージドプラットフォームであり、Java、Node.js、Pythonのマネージドランタイム、またはOCIイメージとしてのカスタムランタイムでWebサービスを簡単に開発・デプロイできます。" last_updated: 2026-03-05T06:13:24Z service: Serverless type: general --- # AppSailの設定 ### 起動コマンド AppSailサービスには、プログラミングスタック、フレームワーク、アプリケーションファイル、使用するWebサーバーに基づいてアプリの起動を指定する起動コマンドを設定できます。基本的にこれは、設定したサーバーでアプリケーションを起動するためにローカル環境で提供するコマンドです。 起動コマンドは、デプロイ中にCLIからアプリをデプロイする際に設定するか、アプリがクラウドにデプロイされた後にコンソールで直接設定できます。 > **Note:** カスタムランタイムとしてデプロイされたアプリの場合、起動コマンドの設定はオプションです。これは、OCIイメージの定義に直接起動コマンドを追加できるためです。ただし、アプリがコンソールにデプロイされた後に設定して、定義済みのコマンドをオーバーライドすることも可能です。 起動コマンドは、アプリに対して2つの方法で設定できます: * **CLIからデプロイされたアプリ:** アプリを[初期化](https://docs.catalyst.zoho.com/ja/cli/v1/initialize-resources/initialize-appsail/)または[追加](https://docs.catalyst.zoho.com/ja/cli/v1/add-appsail/)してから[デプロイ](https://docs.catalyst.zoho.com/ja/cli/v1/deploy-resources/deploy-appsail/)する場合、[`app-config.json`](https://docs.catalyst.zoho.com/ja/serverless/help/appsail/catalyst-managed-runtimes/key-concepts/#the-app-configjson-file)ファイルのキー`command`で設定します。スタンドアロンデプロイを行う場合は、デプロイプロセス中に入力として提供できます。デプロイ後にコンソールで直接設定することも可能です。 * **コンソールでデプロイされたアプリ:** [コンソールで直接設定します。](https://docs.catalyst.zoho.com/ja/serverless/help/appsail/console/configurations/#startup-command) #### Catalystマネージドランタイムの起動コマンド **Java**: Javaアプリケーションは通常、使用するフレームワークに基づいて、アプリのコードに組み込みサーバーを含みます。たとえば、Spring Bootアプリはデフォルトでwebサーバーがバンドルされています。ただし、特定のフレームワークやフォーマットではデフォルトでサーバーが含まれない場合があり、Javaコードに組み込みサーバーを独自に設定する必要があります。一般的に使用されるWebサーバーには、[Eclipse Jetty](https://www.eclipse.org/jetty/)や[Apache Tomcat](https://tomcat.apache.org/)があります。 > **Note:** Catalystは、Javaアプリケーションに対して**Java WAR**と**Java SE**の2つのフォーマットをサポートしています。JavaアプリをWARファイルとして初期化する場合、CatalystがデフォルトでJettyサーバーをバンドルするため、アプリに組み込みサーバーを提供する必要はありません。したがって、起動コマンドを提供する必要もありません。Catalystがアプリケーションの起動を処理します。ただし、Java SEオプションを選択する場合は、サーバーを組み込んで適切な起動コマンドを提供する必要があります。いくつかの例については[Javaヘルプガイド](https://docs.catalyst.zoho.com/ja/serverless/help/appsail/help-guides/java/overview/)を参照してください。 **Node.jsとPython**: Node.jsとPythonアプリケーションでは、使用するフレームワークによって、デプロイメントサーバーがフレームワークの一部として含まれる場合があります。アプリケーションサーバーを適切に設定・管理し、アプリに適切な起動コマンドを提供する必要があります。Catalystは、これらのプログラミング環境に対してサーバーの組み込みサポートを提供していません。 特定のフレームワークでは、サーバーの起動時にコマンドラインで[HTTPリスニングポート](https://docs.catalyst.zoho.com/ja/serverless/help/appsail/appsail-configurations/#ports-for-app-executions)を指定する必要があります。 例: ```json python3 -m http.server ${X_ZOHO_CATALYST_LISTEN_PORT} ``` ただし、AppSailでは、起動コマンドはシェル操作を介さずに直接実行されます。そのため、シェル補完が必要な場合は、起動コマンドをシェルコマンドとして実行するように指定する必要があります。 例: ```json sh -c 'python3 -m http.server ${X_ZOHO_CATALYST_LISTEN_PORT}' ``` ### 環境変数 環境変数はメインのソースコードの外部で宣言され、必要に応じて参照できます。Catalystでは、[開発環境と本番環境](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/introduction/)の両方で変数を保存・管理できます。単一の変数を宣言し、両方の環境の値を設定できます。たとえば、両方の環境で異なる値を保持する認証トークン変数を宣言する必要がある場合に使用できます。 Catalystマネージドランタイムアプリとカスタムランタイムアプリの両方で環境変数を設定できます。これらはサービスが生成されたときにプラットフォームインスタンスにプッシュされ、ランタイム固有のコードでアクセスできます。 > **Note:** 本番変数を宣言する場合は、[プロジェクトを本番環境にデプロイ](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/deployment-types/)している必要があります。プロジェクトがデプロイされていない場合、または本番環境が無効になっている場合は、本番変数にアクセスできません。 AppSailでは、環境変数を2つの方法で設定できます: * **CLIからデプロイされたアプリ:** アプリを[初期化](https://docs.catalyst.zoho.com/ja/cli/v1/initialize-resources/initialize-appsail/)または[追加](https://docs.catalyst.zoho.com/ja/cli/v1/add-appsail/)してから[デプロイ](https://docs.catalyst.zoho.com/ja/cli/v1/deploy-resources/deploy-appsail/)する場合、[`app-config.json`](https://docs.catalyst.zoho.com/ja/serverless/help/appsail/catalyst-managed-runtimes/key-concepts/#the-app-configjson-file)ファイルのキー`env_variables`で設定します。スタンドアロンデプロイを行う場合は、コンソールで設定します。 * **コンソールでデプロイされたアプリ:** [コンソールで直接設定します。](https://docs.catalyst.zoho.com/ja/serverless/help/appsail/console/configurations/#environment-variables) #### 環境変数の使用 環境変数を作成した後、さまざまなプログラミング環境で異なる方法でキー名を使用してアプリのコードから呼び出せます。各プログラミング環境の構文を以下に示します: * **Java:** ```json System.getenv(variable_name) ``` * **Node.js:** ```json process.env.[variable_name] ``` * **Python:** ```json os.getenv(variable_name) ``` `variable_name`: 変数に宣言されたキー名 > **Note:** 変数の値は、アプリが呼び出される環境に基づいて取得されます。つまり、[アプリの開発URL](https://docs.catalyst.zoho.com/ja/serverless/help/appsail/console/overview/#appsail-url)が呼び出されると開発値が取得され、逆もまた同様です。 ### メモリとディスクの割り当て アプリの負荷とパフォーマンス要件に基づいて、アプリの実行にメモリを割り当てることができます。アプリのメモリを特に設定しない場合、デフォルトの512 MBが実行に割り当てられます。また、アプリのサイズに基づいて必要なディスクスペースも割り当てることができます。デフォルトで割り当てられるストレージも256 MBです。 アプリのパフォーマンスに基づいて要件を分析した後、メモリとストレージをいつでも編集・再設定して最適化できます。 AppSailでは、メモリを2つの方法で設定できます: * **CLIからデプロイされたアプリ:** アプリを[初期化](https://docs.catalyst.zoho.com/ja/cli/v1/initialize-resources/initialize-appsail/)または[追加](https://docs.catalyst.zoho.com/ja/cli/v1/add-appsail/)してから[デプロイ](https://docs.catalyst.zoho.com/ja/cli/v1/deploy-resources/deploy-appsail/)する場合、[`app-config.json`](https://docs.catalyst.zoho.com/ja/serverless/help/appsail/catalyst-managed-runtimes/key-concepts/#the-app-configjson-file)ファイルのキー`memory`で設定します。スタンドアロンデプロイを行う場合は、コンソールで設定します。 * **コンソールでデプロイされたアプリ:** [コンソールで直接設定します。](https://docs.catalyst.zoho.com/ja/serverless/help/appsail/console/configurations/#app-execution-settings) ### アプリ実行ポート AppSailはHTTPポートを通じてリスニングし、アプリケーションにネットワークアクセスを付与します。つまり、アプリへのすべての受信接続は、特定のポートを通じてリスニングされます。Catalystでリスニングポートを設定するには、アプリケーションコードで[環境変数](https://docs.catalyst.zoho.com/ja/serverless/help/appsail/appsail-configurations/#environment-variables)キー`X_ZOHO_CATALYST_LISTEN_PORT`を参照してインターネットに接続します。Catalystはこのポートでリスニングしているプロセスを確認します。 アプリケーションのコードでAppSailリスニングポートを設定する例については、[ヘルプガイド](https://docs.catalyst.zoho.com/ja/serverless/help/appsail/help-guides/introduction/)セクションを参照してください。 > **Note:** AppSailサービスに必要なポートを割り当てることができます。0から1024の範囲のポートは予約されていますが、ポート80と443は例外です。これら以外の任意のポートを使用できます。デフォルトではポート9000が使用されます。 ランタイムのフレームワークによっては、サーバーの起動時に[起動コマンド](https://docs.catalyst.zoho.com/ja/serverless/help/appsail/appsail-configurations/#startup-commands)でHTTPリスニングポートを指定する必要がある場合があります。