APM 統合と CA 証明書を構成する方法

この記事の適用対象: ❎ Basic/Standard ✅ Enterprise

この記事では、Azure Spring Apps Enterprise プランでアプリケーション パフォーマンス モニター (APM) 統合と証明機関 (CA) 証明書を構成する方法について説明します。

Azure Springs Apps Enterprise プランのインスタンスでは、Tanzu Build Service を有効または無効にできます。 詳細については、「Tanzu Build Service を使用する」のセクション「オンデマンドでサービスを構築する」を参照してください。

前提条件

• Azure Spring Apps Enterprise プランのインスタンスが既にプロビジョニングされている。 詳細については、「クイック スタート: Enterprise プランを使用してアプリをビルドし Azure Spring Apps にデプロイする」をご覧ください。
• Azure CLI バージョン 2.49.0 以降。 コマンド az extension add --name spring を使用して、Azure Spring Apps をインストールします。

サポートされているシナリオ - APM および CA 証明書の統合

Tanzu Build Service では、Tanzu Partner Buildpacks と、その他のクラウド ネイティブ ビルドパック (GitHub の ca-certificates ビルドパックなど) を統合するためにビルドパックのバインディングを使用します。

現在、Azure Spring Apps がサポートしている APM の種類は次のとおりです。

• ApplicationInsights
• Dynatrace
• AppDynamics
• New Relic
• Elastic APM

Azure Spring Apps は、すべての言語ファミリのビルドパックに対する CA 証明書をサポートしていますが、サポートされている APM のすべてではありません。 次の表は、Tanzu 言語ファミリ ビルドパックでサポートされるバインディングの種類を示しています。

Web サーバーの使用については、「Web 静的ファイルをデプロイする」を参照してください。

Tanzu Build Service は、Azure Spring Apps Enterprise では既定で有効化されています。 ビルド サービスを無効にすると、アプリケーションのデプロイはできますが、カスタム コンテナー イメージの使用が必要になります。 このセクションでは、ビルド サービスが有効なシナリオと無効なシナリオに関するガイダンスを示します。

サポートされる APM の種類

このセクションでは、統合に使用できる APM でサポートされている言語と必要な環境変数のリストを示します。

• Application Insights

  サポートされている言語:

  • Java

  ビルドパックのバインディングに必要な環境変数:

  • connection-string

  その他のサポートされている環境変数については、「Application Insights の概要」を参照してください。

• DynaTrace

  サポートされている言語:

  • Java
  • .NET
  • Go
  • Node.js
  • Web サーバー
  • PHP

  ビルドパックのバインディングに必要な環境変数:

  • api-url または environment-id (ビルド ステップで使用)
  • api-token (ビルド ステップで使用)
  • TENANT
  • TENANTTOKEN
  • CONNECTION_POINT

  その他のサポートされている環境変数については、「Dynatrace」を参照してください

• New Relic

  サポートされている言語:

  • Java
  • .NET
  • Node.js
  • PHP

  ビルドパックのバインディングに必要な環境変数:

  • license_key
  • app_name

  その他のサポートされている環境変数については、「New Relic」を参照してください

• Elastic

  サポートされている言語:

  • Java
  • Node.js
  • PHP

  ビルドパックのバインディングに必要な環境変数:

  • service_name
  • application_packages
  • server_url

  その他のサポートされている環境変数については、「Elastic」を参照してください

• AppDynamics

  サポートされている言語:

  • Java
  • Node.js

  ビルドパックのバインディングに必要な環境変数:

  • agent_application_name
  • agent_tier_name
  • agent_node_name
  • agent_account_name
  • agent_account_access_key
  • controller_host_name
  • controller_ssl_enabled
  • controller_port

  その他のサポートされている環境変数については、「AppDynamics」を参照してください

ビルダーのバインディングは非推奨です

Azure CLI を使用してサービス インスタンスを作成すると、エラー メッセージ Buildpack bindings feature is deprecated, it's not available when your own container registry is used for build service or build service is disabled が表示されることがあります。 このメッセージは、古いバージョンの Azure CLI を使用していることを示しています。 この問題の解決のために、Azure CLI をアップグレードしてください。 詳細については、「Azure CLI を更新する方法」を参照してください。

アプリのビルドとデプロイ用に APM 統合を構成する

Azure Spring Apps では、次の 2 つの方法で APM を構成できます。

• サービス インスタンス レベルで APM の構成を管理し、その構成を参照してアプリのビルドとデプロイにバインドします。 この方法は、APM を構成する際に推奨される方法です。

• ビルダーのバインディングによって APM の構成を管理し、そのビルダーを参照してアプリのビルドとデプロイにバインドします。

サービス インスタンス レベルで APM の構成を管理し、その構成を参照してアプリのビルドとデプロイにバインドすることで、Azure Spring Apps で APM を構成できるようになりました。 この方法は、APM を構成する際に推奨される方法です。

次のセクションでは、これらの両方の方法に関するガイダンスを示します。

サービス インスタンス レベルで APM を構成する (推奨)

次のセクションで説明するように、APM 構成を作成して、アプリのビルドとデプロイにバインドできます。

Azure Spring Apps で APM 構成を管理する

APM 統合は、Azure portal または Azure CLI を使用して APM 構成のプロパティまたはシークレットを構成することで管理できます。

ビルドパックのパラメーター properties と secrets の詳細については、「サポートされているシナリオ - APM と CA 証明書の統合」のセクションを参照してください。

アプリのビルドとデプロイにバインドする

マネージド Azure Container Registry を使用するビルド サービスの場合は、次のコマンドを使用してデプロイに APM を統合します。

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --builder <builder-name> \
    --apms <APM-name> \
    --artifact-path <path-to-your-JAR-file>

グローバルに APM 構成を有効にすると、それ以降のすべてのビルドとデプロイで、その構成が自動的に使用され、--apms パラメーターの指定が不要になります。 グローバルに有効な APM 構成をデプロイの際にオーバーライドする場合は、--apms パラメーターを使用して APM 構成を指定します。

独自のコンテナー レジストリを使用するビルド サービスの場合は、アプリケーションをコンテナー イメージにビルドして、現行または別の Azure Spring Apps Enterprise サービス インスタンスに、そのイメージをデプロイします。

独自のコンテナー レジストリを用意することで、ビルドとデプロイが分離されます。 build コマンドは、ビルダーでビルドを作成または更新する場合に使用できます。その後で、deploy コマンドを使用すると、コンテナー イメージをサービスにデプロイできます。

次のコマンドを使用して、イメージをビルドし、AMP を構成します。

az spring build-service build <create|update> \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --builder <builder-name> \
    --apms <APM-name> \
    --artifact-path <path-to-your-JAR-file>

グローバルに APM 構成を有効にすると、それ以降のすべてのビルドとデプロイで、その構成が自動的に使用され、--apms パラメーターの指定が不要になります。 グローバルに有効な APM 構成をビルドの際にオーバーライドする場合は、--apms パラメーターを使用して APM 構成を指定します。

次のコマンドを使用して、以前にビルドしたコンテナー イメージでアプリケーションをデプロイし、APM を構成します。 グローバルに有効な APM 構成を使用することも、--apms パラメーターを使用して APM 構成を指定することもできます。

az spring app deploy \
   --resource-group <resource-group-name> \
   --service <Azure-Spring-Apps-instance-name> \
   --name <app-name> \
   --container-image <your-container-image> \
   --container-registry <your-container-registry> \
   --registry-password <your-password> \
   --registry-username <your-username> \
   --apms <your-APM>

ビルド サービスを無効にすると、アプリケーションはコンテナー イメージによってのみデプロイできるようになります。 詳細については、「カスタム コンテナー イメージを使用してアプリケーションをデプロイする」を参照してください。

Azure Spring Apps Enterprise の複数のインスタンスを使用して、一部のインスタンスではイメージをビルドしてデプロイし、その他のインスタンスではイメージのみをデプロイできます。 以下のシナリオについて考えてみます。

インスタンスが 1 つの場合は、ユーザー コンテナー レジストリでビルド サービスを有効にできます。 その後で、APM または CA 証明書を使用して成果物ファイルまたはソース コードからコンテナー イメージにビルドします。 そうすることで、現在の Azure Spring Apps インスタンスまたはその他のサービス インスタンスにデプロイできます。 詳細については、「Azure Spring Apps Enterprise で多言語アプリをデプロイする方法」のセクション「ポリグロット アプリケーションをビルドしてデプロイする」を参照してください。

ビルド サービスが無効になっている別の例では、レジストリのコンテナー イメージでアプリケーションをデプロイし、APM も利用します。

このシナリオでは、次の例に示すように、APM 構成を指定するために、グローバルに有効な APM 構成を使用することも、--apms パラメーターを使用することもできます。

az spring app deploy \
   --resource-group <resource-group-name> \
   --service <Azure-Spring-Apps-instance-name> \
   --name <app-name> \
   --container-image <your-container-image> \
   --container-registry <your-container-registry> \
   --registry-password <your-password> \
   --registry-username <your-username> \
   --apms <your-APM>

ビルダーのバインディングによって APM を管理する (非推奨)

ビルド サービスで Azure Spring Apps マネージド コンテナー レジストリを使用する場合は、アプリケーションをイメージにビルドしてからデプロイできますが、それは現在の Azure Spring Apps サービス インスタンス内でのみ可能です。

ビルダーのバインディングによって APM 構成を管理する

APM 構成は、ビルダーのバインディングによって管理できます。 詳細については、「Azure Spring Apps でビルダーのバインディングを管理する (非推奨)」のセクションを参照してください。

アプリのビルドとデプロイにバインドする

次のコマンドを使用して、デプロイに APM を統合します。 APM は、ビルダーのバインディングによって構成されます。

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

サービス インスタンスの作成時に Application Insights を有効にする

サービス インスタンスの作成時に Application Insights を有効にする場合は、次の条件が適用されます。

• ビルド サービスにマネージド Azure Container Registry を使用する場合、Application Insights は既定のビルダーのバインディングにバインドされます。
• ビルド サービスに独自のコンテナー レジストリを使用する場合や、ビルド サービスを無効にしている場合は、Application Insights の既定の APM 構成が作成されます。 既定の APM はグローバルに有効になっていて、それ以降のすべてのビルドとデプロイで自動的に使用されます。

アプリのビルドとデプロイ用に CA 証明書を構成する

Azure Spring Apps では、次の 2 つの方法で CA 証明書を構成できます。

• TLS/SSL 設定でパブリック証明書を管理して、その証明書を参照することでアプリのビルドとデプロイにバインドできます。 この方法は、CA 証明書を構成する際に推奨される方法です。
• TLS/SSL 設定でパブリック証明書を管理して、ビルダーのバインディングによって CA 証明書をバインドできます。 詳細については、「Azure Spring Apps でビルダーのバインディングを管理する (非推奨)」のセクションを参照してください。

TLS/SSL 設定でパブリック証明書を管理して、その証明書を参照することでアプリのビルドとデプロイにバインドできるようになりました。 この方法は、CA 証明書を構成する際に推奨される方法です。

サービス インスタンス レベルでパブリック証明書を管理する場合は、「Azure Spring Apps のアプリケーションで TLS/SSL 証明書を使用する」のセクション「証明書をインポートする」を参照してください。 その後で、次のセクションで説明するいずれかの方法に従って、アプリのビルドとデプロイに CA 証明書をバインドします。

CA 証明書をアプリのビルドとデプロイにバインドする

CA 証明書をデプロイにバインドする方法の詳細は、「Azure Spring Apps のアプリケーションで TLS/SSL 証明書を使用する」のセクション「証明書を読み込む」を参照してください。 その後で、次の手順を使用してアプリのビルドにバインドします。

ビルド サービスを有効にしてマネージド Azure Container Registry を使用する場合は、次のコマンドを使用して、デプロイに CA 証明書を統合します。

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --builder <builder-name> \
    --build-certificates <CA certificate-name> \
    --artifact-path <path-to-your-JAR-file>

ビルド サービスに独自のコンテナー レジストリを使用する場合や、ビルド サービスを無効にする場合は、次のコマンドを使用してビルドに CA 証明書を統合します。

az spring build-service build <create|update> \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --builder <builder-name> \
    --certificates <CA certificate-name> \
    --artifact-path <path-to-your-JAR-file>

アプリのビルドにバインドされた CA 証明書を表示する

ビルドにバインドされた CA 証明書は、次の手順を使用して表示します。

1. 目的のビルドのページに移動します。

   

2. ナビゲーション ウィンドウの ［設定］ セクションで、［証明書のバインディング］ を選択します。

3. ［証明書のバインディング］ ページで、ビルドにバインドされた CA 証明書を表示します。

   

ビルダーのバインディングによって CA 証明書をバインドする (非推奨)

CA 証明書は、ca-certificates ビルドパックを使用して、ビルド時と実行時にシステム信頼ストアへの CA 証明書の提供をサポートします。

Azure Spring Apps Enterprise プランでは、次のスクリーンショットに示すように、CA 証明書は、Azure portal の ［TLS/SSL 設定］ ページの [公開キー証明書] タブを使用します。

CA 証明書は、[バインドの編集] ページで構成できます。 succeeded 証明書は、[CA 証明書] リストに表示されます。

Azure Spring Apps でビルダーのバインディングを管理する (非推奨)

このセクションは、ビルド サービスが有効な Azure Spring Apps Enterprise サービス インスタンスにのみ適用されます。 ビルド サービスを有効にすると、1 つのビルドパックのバインディングは、1 つの APM の種類に対する資格情報の構成か、CA 証明書の種類に対する CA 証明書の構成を意味します。 APM 統合の場合は、前述の手順に従って、APM に必要な環境変数またはシークレットを構成します。

Azure portal または Azure CLI でビルドパックのバインドを管理できます。

az spring build-service builder buildpack-binding list \
    --resource-group <your-resource-group-name> \
    --service <your-service-instance-name> \
    --builder-name <your-builder-name>

az spring build-service builder buildpack-binding create \
    --resource-group <your-resource-group-name> \
    --service <your-service-instance-name> \
    --name <your-buildpack-binding-name> \
    --builder-name <your-builder-name> \
    --type <your-binding-type> \
    --properties a=b c=d \
    --secrets e=f g=h

az spring build-service builder buildpack-binding show \
    --resource-group <your-resource-group-name> \
    --service <your-service-instance-name> \
    --name <your-buildpack-binding-name> \
    --builder-name <your-builder-name>

az spring build-service builder buildpack-binding set \
    --resource-group <your-resource-group-name> \
    --service <your-service-instance-name> \
    --name <your-buildpack-binding-name> \
    --builder-name <your-builder-name> \
    --type <your-binding-type> \
    --properties a=b c=d \
    --secrets e=f2 g=h

az spring build-service builder buildpack-binding delete \
    --resource-group <your-resource-group-name> \
    --service <your-service-instance-name> \
    --name <your-buildpack-binding-name> \
    --builder-name <your-builder-name>

ビルダーのバインディングから APM と CA 証明書を移行する

ビルダーのバインディング機能は非推奨になっていて、今後削除される予定です。 ビルダーのバインドは移行するようにお勧めします。

APM と CA 証明書をバインディングで構成して、次のセクションを使用するとそれらを移行できます。

バインディングで構成した APM を移行する

ほとんどのユース ケースでは、既定のビルダーのバインディングで構成された APM は 1 つのみです。 バインディングで同じ構成の新しい APM 構成を作成して、この APM 構成をグローバルに有効にできます。 それ以降のすべてのビルドとデプロイでは、この構成が自動的に使用されます。 移行には、次の手順を使用します。

1. 次のコマンドを使用して、APM 構成を作成します。

   az spring apm create \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-instance-name> \
       --name <your-APM-name> \
       --type <your-APM-type> \
       --properties a=b c=d \
       --secrets e=f g=h
   

2. 次のコマンドを使用して、APM 構成をグローバルに有効にします。

   az spring apm enable-globally \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-instance-name> \
       --name <your-APM-name> \
   

3. 次のコマンドを使用して、新しいグローバルに有効な APM 構成を使用するように、すべてのアプリケーションを再デプロイします。

   az spring app deploy \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-instance-name> \
       --name <app-name> \
       --builder <builder-name> \
       --artifact-path <path-to-your-JAR-file>
   

4. すべてのアプリケーションで新しい APM 構成が機能することを確認します。 すべてが順調に機能している場合は、次のコマンドを使用して、ビルダーの APM バインディングを削除します。

   az spring build-service builder buildpack-binding delete \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-instance-name> \
       --name <your-APM-buildpack-binding-name> \
       --builder-name <your-builder-name>
   

バインディングに複数の APM が構成されている場合は、バインディングで同じ構成の複数の APM 構成を作成して、それが適切な場合は、その APM 構成をグローバルに有効にすることができます。 次のコマンドに示すように、--apms パラメーターはグローバルに有効な APM をオーバーライドするときに、デプロイメントに APM 構成を指定するために使用します。

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --builder <builder-name> \
    --apms <APM-name> \
    --artifact-path <path-to-your-JAR-file>

移行プロセス中に、APM はバインディングと APM 構成の両方で構成されます。 この場合は、APM 構成が有効になり、バインディングは無視されます。

バインディングで構成した CA 証明書を移行する

CA 証明書は、次の手順を使用して移行します。

1. バインディングで構成した CA 証明書が実行時に使用される場合は、その証明書をアプリケーションに読み込むことができます。 詳細については、「Azure Spring Apps のアプリケーションで TLS/SSL 証明書を使用する」のセクション「証明書を読み込む」を参照してください。

2. 次のコマンドを使用して、CA 証明書を使用するすべてのアプリケーションを再デプロイします。 ビルド時に証明書を使用する場合は、--build-certificates パラメーターを使用して、デプロイのビルド時に使用する CA 証明書を指定します。

   az spring app deploy \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-instance-name> \
       --name <app-name> \
       --builder <builder-name> \
       --build-certificates <CA certificate-name> \
       --artifact-path <path-to-your-JAR-file>
   

3. CA 証明書が、それを使用するすべてのアプリケーションで機能するかどうかを確認します。 すべてが順調に機能している場合は、次のコマンドを使用して、ビルダーの CA 証明書バインディングを削除します。

   az spring build-service builder buildpack-binding delete \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-instance-name> \
       --name <your-CA-certificate-buildpack-binding-name> \
       --builder-name <your-builder-name>
   

次のステップ

• Azure Spring Apps Enterprise で多言語アプリをデプロイする方法