チュートリアル: Azure Container Apps でマネージド Config Server for Spring に接続する (プレビュー)

Config Server for Spring は、構成データを複数のアプリケーションで使用できるようにするための一元的な場所を提供します。 この記事では、Azure Container Apps でホストされているアプリを Java Config Server for Spring インスタンスに接続する方法を紹介します。

Config Server for Spring コンポーネントは、構成設定のソースとして GitHub リポジトリを使用します。 構成値は、コンポーネントとコンテナー アプリの間のバインドを介して、コンテナー アプリで利用できるようになります。 構成サーバーで値を変更すると、その値は自動的にアプリケーションに反映され、アプリケーションを再コンパイルしたり再デプロイしたりする必要はありません。

このチュートリアルで学習する内容は次のとおりです。

前提条件

このプロジェクトを完了するには、次の項目が必要です:

考慮事項

Azure Container Apps の Config Server for Spring で実行する場合は、次の詳細に注意してください。

セットアップ

Config Server for Spring の操作を開始する前に、まず、必要なリソースを作成する必要があります。

次のコマンドを実行して、リソース グループと Container Apps 環境を作成します。

1. アプリケーション構成をサポートする変数を作成します。 これらの値は、このレッスンのために提供されています。

   export LOCATION=eastus
   export RESOURCE_GROUP=my-spring-cloud-resource-group
   export ENVIRONMENT=my-spring-cloud-environment
   export JAVA_COMPONENT_NAME=myconfigserver
   export APP_NAME=my-config-client
   export IMAGE="mcr.microsoft.com/javacomponents/samples/sample-service-config-client:latest"
   export URI="https://github.com/Azure-Samples/azure-spring-cloud-config-java-aca.git"
   

   変数	説明
   LOCATION	コンテナー アプリと Java コンポーネントを作成する Azure リージョンの場所。
   ENVIRONMENT	デモ アプリケーションの Azure Container Apps 環境名。
   RESOURCE_GROUP	デモ アプリケーションの Azure リソース グループ名。
   JAVA_COMPONENT_NAME	コンテナー アプリ用に作成された Java コンポーネントの名前。 この場合、Config Server for Spring の Java コンポーネントを作成します。
   IMAGE	コンテナー アプリで使用されるコンテナー イメージ。
   URI	URI を Git リポジトリの URL に置き換えることができます。非公開の場合は、spring.cloud.config.server.git.username や spring.cloud.config.server.git.password などの関連する認証の構成を追加します。

2. Azure CLI を使用して Azure にログインします。

   az login
   

3. リソース グループを作成する。

   az group create --name $RESOURCE_GROUP --location $LOCATION
   

4. コンテナー アプリ環境を作成します。

   az containerapp env create \
     --name $ENVIRONMENT \
     --resource-group $RESOURCE_GROUP \
     --location $LOCATION
   

   この環境は、Config Server for Spring コンポーネントとコンテナー アプリの両方をホストするために使用されます。

Config Server for Spring の Java コンポーネントを使用する

Container Apps 環境が準備できたので、コンテナー アプリを作成し、Config Server for Spring コンポーネントにバインドできます。 コンテナー アプリをバインドすると、構成値は自動的に Config Server コンポーネントからアプリケーションに同期されます。

1. Config Server for Spring の Java コンポーネントを作成します。

   az containerapp env java-component config-server-for-spring create \
     --environment $ENVIRONMENT \
     --resource-group $RESOURCE_GROUP \
     --name $JAVA_COMPONENT_NAME \
     --configuration spring.cloud.config.server.git.uri=$URI
   

2. Config Server for Spring の Java コンポーネントを更新します。

   az containerapp env java-component config-server-for-spring update \
     --environment $ENVIRONMENT \
     --resource-group $RESOURCE_GROUP \
     --name $JAVA_COMPONENT_NAME \
     --configuration spring.cloud.config.server.git.uri=$URI spring.cloud.config.server.git.refresh-rate=60
   

   ここでは、uri プロパティを介して構成情報を保持するリポジトリの場所をコンポーネントに指示しています。 refresh-rate プロパティは、Container Apps で Git リポジトリの変更をチェックする頻度を指示します。

3. 構成データを消費するコンテナー アプリを作成します。

   az containerapp create \
     --name $APP_NAME \
     --resource-group $RESOURCE_GROUP \
     --environment $ENVIRONMENT \
     --image $IMAGE \
     --min-replicas 1 \
     --max-replicas 1 \
     --ingress external \
     --target-port 8080 \
     --query properties.configuration.ingress.fqdn
   

   このコマンドは、構成データを消費するコンテナー アプリの URL を返します。 次の手順で使えるように URL をテキスト エディターにコピーします。

   ブラウザーでアプリにアクセスした場合、返される connectTimeout の値は既定値の 0 です。

4. Config Server for Spring にバインドします。

   これで、コンテナー アプリと Config Server が作成されたので、update コマンドと共にコンテナー アプリにバインドします。

   az containerapp update \
     --name $APP_NAME \
     --resource-group $RESOURCE_GROUP \
     --bind $JAVA_COMPONENT_NAME
   

   --bind $JAVA_COMPONENT_NAME パラメーターは、コンテナー アプリと構成コンポーネントの間のリンクを作成します。

   コンテナー アプリと Config Server コンポーネントがバインドされると、構成の変更がコンテナー アプリに自動的に同期されます。

   アプリの URL にもう一度アクセスすると、connectTimeout の値が 10000 になります。 この値は、元々構成コンポーネントのソースとして設定されていた $URI 変数に設定されている Git リポジトリから取得します。 具体的には、この値はリポジトリの application.yml ファイルの connectionTimeout プロパティから取得されます。

   バインド要求は、構成の設定を環境変数としてアプリケーションに注入します。 これらの値は、構成サーバーから構成の設定をフェッチする場合に、アプリケーション コードに使用できるようになりました。

   この場合、アプリケーションでは次の環境変数を使用できます。

   SPRING_CLOUD_CONFIG_URI=http://$JAVA_COMPONENT_NAME:80
   SPRING_CLOUD_CONFIG_COMPONENT_URI=http://$JAVA_COMPONENT_NAME:80
   SPRING_CONFIG_IMPORT=optional:configserver:$SPRING_CLOUD_CONFIG_URI
   

   独自の SPRING_CONFIG_IMPORT をカスタマイズする場合は、環境変数 SPRING_CLOUD_CONFIG_COMPONENT_URI を参照できます。たとえば、Java -Dspring.config.import=optional:configserver:${SPRING_CLOUD_CONFIG_COMPONENT_URI}?fail-fast=true などのコマンド ライン引数でオーバーライドできます。

   バインディングは、アプリケーションから削除することもできます。

5. Config Server for Spring の Java コンポーネントのバインドを解除します。

   コンテナー アプリからバインドを削除するには、--unbind オプションを使用します。

   az containerapp update \
     --name $APP_NAME \
     --unbind $JAVA_COMPONENT_NAME \
     --resource-group $RESOURCE_GROUP
   

   アプリの URL にもう一度アクセスすると、connectTimeout の値が 0 に戻ります。

リソースをクリーンアップする

このチュートリアルで作成したリソースは、Azure の請求書に影響します。 これらのサービスを長期間使用しない場合は、次のコマンドを実行して、このチュートリアルで作成したすべてのものを削除してください。

az group delete \
  --resource-group $RESOURCE_GROUP

次のステップ