AppSailの設定

起動コマンド

AppSailサービスには、プログラミングスタック、フレームワーク、アプリケーションファイル、使用するWebサーバーに基づいてアプリの起動を指定する起動コマンドを設定できます。基本的にこれは、設定したサーバーでアプリケーションを起動するためにローカル環境で提供するコマンドです。

起動コマンドは、デプロイ中にCLIからアプリをデプロイする際に設定するか、アプリがクラウドにデプロイされた後にコンソールで直接設定できます。

起動コマンドは、アプリに対して2つの方法で設定できます:

• CLIからデプロイされたアプリ: アプリを初期化または追加してからデプロイする場合、app-config.jsonファイルのキーcommandで設定します。スタンドアロンデプロイを行う場合は、デプロイプロセス中に入力として提供できます。デプロイ後にコンソールで直接設定することも可能です。

• コンソールでデプロイされたアプリ: コンソールで直接設定します。

Catalystマネージドランタイムの起動コマンド

Java:

Javaアプリケーションは通常、使用するフレームワークに基づいて、アプリのコードに組み込みサーバーを含みます。たとえば、Spring Bootアプリはデフォルトでwebサーバーがバンドルされています。ただし、特定のフレームワークやフォーマットではデフォルトでサーバーが含まれない場合があり、Javaコードに組み込みサーバーを独自に設定する必要があります。一般的に使用されるWebサーバーには、Eclipse JettyやApache Tomcatがあります。

Node.jsとPython:

Node.jsとPythonアプリケーションでは、使用するフレームワークによって、デプロイメントサーバーがフレームワークの一部として含まれる場合があります。アプリケーションサーバーを適切に設定・管理し、アプリに適切な起動コマンドを提供する必要があります。Catalystは、これらのプログラミング環境に対してサーバーの組み込みサポートを提供していません。

特定のフレームワークでは、サーバーの起動時にコマンドラインでHTTPリスニングポートを指定する必要があります。

例:

python3 -m http.server ${X_ZOHO_CATALYST_LISTEN_PORT}

ただし、AppSailでは、起動コマンドはシェル操作を介さずに直接実行されます。そのため、シェル補完が必要な場合は、起動コマンドをシェルコマンドとして実行するように指定する必要があります。

例:

sh -c 'python3 -m http.server ${X_ZOHO_CATALYST_LISTEN_PORT}'

環境変数

環境変数はメインのソースコードの外部で宣言され、必要に応じて参照できます。Catalystでは、開発環境と本番環境の両方で変数を保存・管理できます。単一の変数を宣言し、両方の環境の値を設定できます。たとえば、両方の環境で異なる値を保持する認証トークン変数を宣言する必要がある場合に使用できます。

Catalystマネージドランタイムアプリとカスタムランタイムアプリの両方で環境変数を設定できます。これらはサービスが生成されたときにプラットフォームインスタンスにプッシュされ、ランタイム固有のコードでアクセスできます。

AppSailでは、環境変数を2つの方法で設定できます:

• CLIからデプロイされたアプリ: アプリを初期化または追加してからデプロイする場合、app-config.jsonファイルのキーenv_variablesで設定します。スタンドアロンデプロイを行う場合は、コンソールで設定します。

• コンソールでデプロイされたアプリ: コンソールで直接設定します。

環境変数の使用

環境変数を作成した後、さまざまなプログラミング環境で異なる方法でキー名を使用してアプリのコードから呼び出せます。各プログラミング環境の構文を以下に示します:

• Java:

System.getenv(variable_name)

• Node.js:

process.env.[variable_name]

• Python:

os.getenv(variable_name)

variable_name: 変数に宣言されたキー名

メモリとディスクの割り当て

アプリの負荷とパフォーマンス要件に基づいて、アプリの実行にメモリを割り当てることができます。アプリのメモリを特に設定しない場合、デフォルトの512 MBが実行に割り当てられます。また、アプリのサイズに基づいて必要なディスクスペースも割り当てることができます。デフォルトで割り当てられるストレージも256 MBです。

アプリのパフォーマンスに基づいて要件を分析した後、メモリとストレージをいつでも編集・再設定して最適化できます。

AppSailでは、メモリを2つの方法で設定できます:

• CLIからデプロイされたアプリ: アプリを初期化または追加してからデプロイする場合、app-config.jsonファイルのキーmemoryで設定します。スタンドアロンデプロイを行う場合は、コンソールで設定します。

• コンソールでデプロイされたアプリ: コンソールで直接設定します。

アプリ実行ポート

AppSailはHTTPポートを通じてリスニングし、アプリケーションにネットワークアクセスを付与します。つまり、アプリへのすべての受信接続は、特定のポートを通じてリスニングされます。Catalystでリスニングポートを設定するには、アプリケーションコードで環境変数キーX_ZOHO_CATALYST_LISTEN_PORTを参照してインターネットに接続します。Catalystはこのポートでリスニングしているプロセスを確認します。

アプリケーションのコードでAppSailリスニングポートを設定する例については、ヘルプガイドセクションを参照してください。

ランタイムのフレームワークによっては、サーバーの起動時に起動コマンドでHTTPリスニングポートを指定する必要がある場合があります。