標準環境変数は、Cloud Manager を介して設定および管理できます。これらは実行時環境に提供され、OSGi 設定で使用できます。環境変数には、環境固有の値または環境シークレットを変更内容に応じて指定できます。
環境変数は、AEM as a Cloud Service のユーザーに次のような多くの利点を提供します。
環境変数を使用した一般的なユースケースを次に示します。
環境変数を追加または変更するには、デプロイメントマネージャー 役割のメンバーである必要があります。
my.cloudmanager.adobe.com で Adobe Cloud Manager にログインします。
Cloud Manager に、使用可能な様々なプログラムのリストが表示されます。管理するものを選択します。
選択したプログラムの「環境」タブを選択し、左側のナビゲーションパネルで環境変数を作成する環境を選択します。
環境の詳細で「設定」タブを選択し、「追加」を選択して 環境設定 ダイアログを開きます。
変数の詳細を入力します。
新しい変数を入力した後、新しい変数を含む行の最後の列で「追加」を選択する必要があります。
「保存」を選択して、変数を保持します。
表の上部と新しく追加された変数の横に、ステータスが 更新中 のインジケーターが表示され、環境が設定で更新されていることを示します。完了すると、新しい環境変数がテーブルに表示されます。
複数の変数を追加する場合は、最初の変数を追加してから、環境設定ダイアログの「追加」ボタンを使用してその他の変数を追加することをお勧めします。これにより、1 回の更新で環境に追加できます。
環境変数を作成したら、「追加/更新」ボタンを使用して環境変数を更新すると、環境設定ダイアログを起動できます。
my.cloudmanager.adobe.com で Adobe Cloud Manager にログインします。
Cloud Manager に、使用可能な様々なプログラムのリストが表示されます。管理するものを選択します。
選択したプログラムの「環境」タブを選択し、左側のナビゲーションパネルで環境変数を作成する環境を選択します。
環境の詳細で「設定」タブを選択し、右上の「追加/更新」を選択して 環境設定 ダイアログを開きます。
変更する変数の行の最後の列にある省略記号ボタンを使用して、「編集」または「削除」を選択します。
必要に応じて環境変数を編集します。
必要な設定の変更をすべて行ったら、「保存」を選択します。
変数を追加する場合と同様に、 ステータスが 更新中 のインジケーターがテーブルの上部と新しく更新された変数の横に表示され、環境が設定で更新されていることを示します。完了すると、更新された環境変数がテーブルに表示されます。
複数の変数を更新する場合は、環境設定ダイアログを使用して、必要なすべての変数を一度に更新してから、「保存」をタップまたはクリックすることをお勧めします。これにより、1 回の更新で環境に追加できます。
環境変数を使用すると、pom.xml
設定の安全性と柔軟性を高めることができます。例えば、パスワードをハードコードする必要はなく、環境変数の値に基づいて設定を適応させることができます。
次のように、XML を使用して環境変数とシークレットにアクセスできます。
${env.VARIABLE_NAME}
pom.xml
ファイルで両方のタイプの変数を使用する方法の例については、プロジェクトの設定を参照してください。
詳しくは、Maven の公式ドキュメントを参照してください。
環境変数は、様々な場所で使用できます。
オーサー、プレビュー、パブリッシュの各環境では、通常の環境変数とシークレットの両方を使用できます。
通常の環境変数のみが、Dispatcher で使用できます。シークレットは使用できません。
ただし、環境変数は IfDefine
ディレクティブでは使用できません。
デプロイする前に、Dispatcher をローカルで使用して、環境変数の使用を検証する必要があります。
OSGi 設定では、通常の環境変数とシークレットの両方を使用できます。
環境変数に加えて、ビルドフェーズで公開されるパイプライン変数もあります。パイプライン変数について詳しくは、こちらを参照してください。