環境変数の構成 - Enterprise Distributed Application Service - Alibaba Cloud ドキュメントセンター

システムでアプリケーションを実行するには、環境変数を構成する必要があります。たとえば、Java アプリケーションのコマンドは、JAVA_HOME および PATH 環境変数を構成した後にのみ実行できます。このトピックでは、Enterprise Distributed Application Service (EDAS) コンソールでアプリケーションの環境変数を構成する方法について説明します。

背景情報

EDAS コンソールでは、次の 3 種類の環境変数を構成できます。

カスタム環境変数: アプリケーションの作成時にカスタマイズする環境変数です。
ConfigMap: 機密性を保持する必要のない定義済みの構成です。 ConfigMap をアプリケーションに適用するには、アプリケーションが ConfigMap と同じリージョン、クラスター、および Kubernetes 名前空間に存在する必要があります。そうでない場合、アプリケーションは ConfigMap を使用できません。
ConfigMap の作成方法の詳細については、「構成アイテムの作成」をご参照ください。
Secret: パスワードや証明書など、機密性を保持する必要のある定義済みの構成です。 Secret をアプリケーションに適用するには、アプリケーションが Secret と同じリージョン、クラスター、および Kubernetes 名前空間に存在する必要があります。そうでない場合、アプリケーションは Secret を使用できません。
Secret の作成方法の詳細については、「Secret の作成」をご参照ください。

アプリケーションの作成時に環境変数を構成する

EDAS コンソールにログインします。
EDAS コンソールにログインします。左側のナビゲーションペインで、[アプリケーション管理] > [アプリケーション] を選択します。 [アプリケーション] ページが表示されます。上部のナビゲーションバーで、リージョンを選択します。ページの上部で、名前空間を選択します。左上隅にある [アプリケーションの作成] をクリックします。

[基本情報] ステップで、クラスタータイプとアプリケーションランタイム環境を指定し、[次へ] をクリックします。次の表にパラメーターを示します。

パラメーター

説明

クラスタータイプ

アプリケーションをデプロイするクラスターのタイプ。 [kubernetes クラスター] を選択します。

アプリケーションランタイム環境

アプリケーションランタイム環境。ホストされているアプリケーションのタイプに基づいて、アプリケーションランタイム環境を選択します。

Java
- カスタム: カスタムイメージを使用して Kubernetes クラスターにアプリケーションをデプロイする場合に、このオプションを選択します。
- Java: ユニバーサル JAR パッケージを使用してアプリケーションを Dubbo アプリケーションまたは Spring Boot アプリケーションとしてデプロイする場合に、このオプションを選択します。このオプションを選択した後、Java 環境パラメーターを設定できます。
- Tomcat: ユニバーサル WAR パッケージを使用してアプリケーションを Dubbo アプリケーションまたは Spring アプリケーションとしてデプロイする場合に、このオプションを選択します。このオプションを選択した後、Java 環境およびコンテナバージョンパラメーターを設定できます。
- EDAS-Container (HSF): WAR パッケージまたは FatJar パッケージを使用してアプリケーションを High-speed Service Framework (HSF) アプリケーションとしてデプロイする場合に、このオプションを選択します。このオプションを選択した後、Java 環境、Pandora バージョン、および Ali-Tomcat バージョンパラメーターを設定できます。
PHP: アプリケーションが Apache HTTP Server 上で実行される PHP アプリケーションである場合に、このオプションを選択します。
Node.js、c++、go、およびその他の言語: カスタムイメージを使用して Kubernetes クラスターにアプリケーションをデプロイする場合に、このオプションを選択します。多言語アプリケーションの構成プロセスについては、このトピックでは説明していません。

[構成] ステップで、アプリケーションの環境情報、基本情報、およびデプロイ方法を構成し、関連するリソースパラメーターを設定して、[次へ] をクリックします。

[詳細設定] ステップで、[環境変数] をクリックし、必要に応じて環境変数を構成します。

アプリケーションを作成するときに、構成した環境変数を生成されるコンテナに渡します。こうすることで、頻繁に使用する環境変数を繰り返し追加する必要がなくなります。 EDAS では、環境変数をカスタマイズしたり、ConfigMap および Secret を使用して環境変数を構成したりできます。 EDAS では、一度に 1 つ以上の環境変数を追加することもできます。必要に応じて方法を選択します。

一度に 1 つの環境変数を追加します。
- 環境変数をカスタマイズします。
  説明
  - Java 仮想マシン (JVM) ヒープメモリ、JVM プロパティ、および Java エージェントのパラメーターを指定する場合は、この手順でパラメーターを追加します。
    変数名: CATALINA_OPTS
    変数値: [追加するパラメーター] $(EDAS_CATALINA_OPTS)
  - MySQL イメージを使用している場合は、次の環境変数を構成できます。
    MYSQL_ROOT_PASSWORD: 必須。 MySQL ルートパスワードを設定できます。
    MYSQL_USER および MYSQL_PASSWORD: オプション。ルートアカウントに加えてアカウントを作成し、パスワードを設定できます。
    MYSQL_DATABASE: オプション。コンテナの生成時に作成するデータベースを指定できます。
  - 別のタイプのイメージを使用している場合は、必要に応じて環境変数を構成します。
- ConfigMap を使用して環境変数を構成します。
  [変数値/変数参照] ドロップダウンリストから ConfigMap を選択します。 ConfigMap には複数のキーと値のペアが含まれている場合があります。必要に応じて、キーと値のペアを選択します。
- Secret を使用して環境変数を構成します。
  [変数値/変数参照] ドロップダウンリストから Secret を選択します。 Secret には複数のキーと値のペアが含まれている場合があります。必要に応じて、キーと値のペアを選択します。

複数の環境変数を追加します

パラメーター	説明
タイプ	環境変数のタイプ。必要に応じて、[構成アイテム] または [secret] を選択します。 [カスタム] はサポートされていません。この例では、構成アイテムを選択します。
構成モード	環境変数を構成するモード。有効な値: [env] および [envfrom]。 env: ConfigMap を選択した後、ConfigMap 内のキーと値のペアも選択する必要があります。 envFrom: ConfigMap を選択した後、ConfigMap 内のキーと値のペアを選択することはできません。デフォルトでは、すべてのキーと値のペアが選択されています。説明一度に最大 100 個の環境変数を追加できます。
構成アイテム	ドロップダウンリストから ConfigMap を選択します。
参照環境変数	env モードで構成するキーと値のペアを選択します。

説明

環境変数を追加した後、必要に応じて環境変数の名前を設定する必要があります。

[アプリケーションの作成] をクリックします。
[作成完了] ページで、[基本情報]、[構成]、および [詳細設定] セクションの情報を確認します。次に、[アプリケーションの作成] をクリックします。
[アプリケーションの概要] ページの上部にある [詳細の表示] をクリックします。 [変更リスト] ページで、アプリケーションの変更プロセスを表示します。アプリケーションがデプロイされるまで数分待ちます。アプリケーションの変更プロセスが完了したら、[アプリケーションの概要] ページの [基本情報] セクションでインスタンスのステータスを表示します。ステータスに Pod が実行中であると表示されている場合、アプリケーションはデプロイされています。

アプリケーションの更新時に環境変数を構成する

アプリケーションの作成時に環境変数を構成しない場合は、アプリケーションのデプロイ時に構成できます。

EDAS コンソールにログインします。
左側のナビゲーションペインで、[アプリケーション管理] > [アプリケーション] をクリックします。上部のナビゲーションバーで、リージョンを選択します。ページの上部で、名前空間を選択します。 [コンテナサービスまたはサーバーレス Kubernetes クラスター] を [クラスタータイプ] ドロップダウンリストから選択します。次に、デプロイするアプリケーションを見つけ、アプリケーション名をクリックします。
[概要] または [基本情報] ページで、右上隅にある [デプロイ] > [デプロイ] を選択します。
[デプロイモードの選択] ページで、デプロイモードを選択し、指定されたデプロイモードセクションの右上隅にある [デプロイの開始] をクリックします。

アプリケーションのランタイム環境とデプロイパッケージを設定し、[環境変数] をクリックし、必要に応じて構成を完了して、[OK] をクリックします。

一度に 1 つの環境変数を追加します。
- 環境変数をカスタマイズします。
  説明
  - Java 仮想マシン (JVM) ヒープメモリ、JVM プロパティ、および Java エージェントのパラメーターを指定する場合は、この手順でパラメーターを追加します。
    変数名: CATALINA_OPTS
    変数値: [追加するパラメーター] $(EDAS_CATALINA_OPTS)
  - MySQL イメージを使用している場合は、次の環境変数を構成できます。
    MYSQL_ROOT_PASSWORD: 必須。 MySQL ルートパスワードを設定できます。
    MYSQL_USER および MYSQL_PASSWORD: オプション。ルートアカウントに加えてアカウントを作成し、パスワードを設定できます。
    MYSQL_DATABASE: オプション。コンテナの生成時に作成するデータベースを指定できます。
  - 別のタイプのイメージを使用している場合は、必要に応じて環境変数を構成します。
- ConfigMap を使用して環境変数を構成します。
  [変数値/変数参照] ドロップダウンリストから ConfigMap を選択します。 ConfigMap には複数のキーと値のペアが含まれている場合があります。必要に応じて、キーと値のペアを選択します。
- Secret を使用して環境変数を構成します。
  [変数値/変数参照] ドロップダウンリストから Secret を選択します。 Secret には複数のキーと値のペアが含まれている場合があります。必要に応じて、キーと値のペアを選択します。

複数の環境変数を追加します

パラメーター	説明
タイプ	環境変数のタイプ。必要に応じて、[構成アイテム] または [secret] を選択します。 [カスタム] はサポートされていません。この例では、構成アイテムを選択します。
構成モード	環境変数を構成するモード。有効な値: [env] および [envfrom]。 env: ConfigMap を選択した後、ConfigMap 内のキーと値のペアも選択する必要があります。 envFrom: ConfigMap を選択した後、ConfigMap 内のキーと値のペアを選択することはできません。デフォルトでは、すべてのキーと値のペアが選択されています。説明一度に最大 100 個の環境変数を追加できます。
構成アイテム	ドロップダウンリストから ConfigMap を選択します。
参照環境変数	env モードで構成するキーと値のペアを選択します。

説明

環境変数を追加した後、必要に応じて環境変数の名前を設定する必要があります。

重要

[OK] をクリックすると、アプリケーションが再起動されます。オフピーク時に環境変数を構成することをお勧めします。

結果の確認

方法 1
アプリケーション詳細ページの左側のナビゲーションペインで、[変更レコード] をクリックして、アプリケーションの変更の詳細を表示します。 [変更ステータス] 列の値が [成功] の場合、アプリケーションはデプロイされ、構成が有効になります。
方法 2
[アプリケーションの概要] ページで、[実行ステータス] の横にある [実行中の Pod (表示をクリック)] をクリックします。 [アプリの構成] パネルの [pod] セクションで、Pod の [ステータス] 列を確認します。緑色のドットが表示されている場合、アプリケーションは実行中状態です。これは、アプリケーションが想定どおりにデプロイされ、構成が有効になっていることを意味します。