カスタム コンテナー イメージを使用してアプリケーションをデプロイする

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

この記事では、カスタム コンテナー イメージを使用して Azure Spring Apps に Spring Boot アプリケーションをデプロイする方法について説明します。 カスタム コンテナーを使用してアプリケーションをデプロイすると、JAR アプリケーションをデプロイする場合と同様に、ほとんどの機能がサポートされます。 その他の Java アプリケーションや Java 以外のアプリケーションも、コンテナー イメージを使用してデプロイできます。

前提条件

• アプリケーションを含むコンテナー イメージ。
• イメージはイメージ レジストリにプッシュされます。 詳細については、Azure Container Registry に関するページを参照してください。

アプリケーションをデプロイする

カスタム コンテナー イメージにアプリケーションをデプロイするには、次の手順に従います。

    --container-command "java" \
    --container-args "-jar /app.jar -Dkey=value"

    --disable-probe true

機能のサポート マトリックス

次の表は、アプリケーションの種類ごとにサポートされている機能を示します。

カスタム コンテナーを使用してデプロイする際の一般的な注意点

次の点は、カスタム イメージを使用してデプロイする際によくある状況に対処するために役立ちます。

証明機関を信頼する

証明機関を信頼するには、2 つのオプションがあります。

オプション 1: Azure Spring Apps 経由でアップロードする

CA 証明書をアプリに読み込むには、「Azure Spring Apps のアプリケーションで TLS/SSL 証明書を使用する」をご覧ください。 その後、証明書は場所 /etc/azure-spring-cloud/certs/public/ にマウントされます。

オプション 2: イメージへの手動インストール

イメージ内で CA を信頼するには、環境に応じて次の変数を設定します。

• Dockerfile に次の行を追加して、信頼ストアに Java アプリケーションをインポートする必要があります。

  ADD EnterpriseRootCA.crt /opt/
  RUN keytool -keystore /etc/ssl/certs/java/cacerts -storepass changeit -noprompt -trustcacerts -importcert -alias EnterpriseRootCA -file /opt/EnterpriseRootCA.crt
  

• Node.js アプリケーションの場合は、NODE_EXTRA_CA_CERTS 環境変数を設定します。

  ADD EnterpriseRootCA.crt /opt/
  ENV NODE_EXTRA_CA_CERTS="/opt/EnterpriseRootCA.crt"
  

• Debian または Ubuntu イメージ上の、Python またはシステム CA ストアに依存する他の言語の場合は、次の環境変数を追加します。

  ADD EnterpriseRootCA.crt /usr/local/share/ca-certificates/
  RUN /usr/sbin/update-ca-certificates
  

• CentOS または Fedora ベース イメージ上の、Python またはシステム CA ストアに依存する他の言語の場合は、次の環境変数を追加します。

  ADD EnterpriseRootCA.crt /etc/pki/ca-trust/source/anchors/
  RUN /usr/bin/update-ca-trust
  

イメージの変更時の予期しない動作を回避する

アプリケーションが再起動またはスケールアウトされるとき、常に最新のイメージがプルされます。 イメージが変更された場合、新しく起動されたアプリケーション インスタンスは新しいイメージを使用しますが、古いインスタンスは引き続き古いイメージを使用します。

VNet 内のコンテナー レジストリに接続できなくなることを回避する

インスタンスを VNet にデプロイした場合は、NSG または Azure Firewall (使用されている場合) 内のコンテナー レジストリへのネットワーク トラフィックを許可してください。 詳細について「VNet で実行するための顧客の責任」を参照し、必要なセキュリティ規則を追加します。

APM をイメージに手動でインストールする

インストール手順は、アプリケーション パフォーマンス モニター (APM) と言語によって異なります。 次の手順は、Java アプリケーションを含む New Relic の場合です。 次の手順を使用して Dockerfile を変更する必要があります。

1. Dockerfile に次を追加して、エージェント ファイルをダウンロードしてイメージにインストールします。

   ADD newrelic-agent.jar /opt/agents/newrelic/java/newrelic-agent.jar
   

2. APM で必要な環境変数を追加します。

   ENV NEW_RELIC_APP_NAME=appName
   ENV NEW_RELIC_LICENSE_KEY=newRelicLicenseKey
   

3. java -javaagent:/opt/agents/newrelic/java/newrelic-agent.jar を追加して、イメージ エントリ ポイントを変更します。

他の言語のエージェントをインストールするには、他のエージェントの公式ドキュメントを参照してください。

New Relic:

• Python: Python エージェントのインストール
• Node.js: Node.js エージェントのインストール

Dynatrace:

• Python: OpenTelemetry による Python アプリケーションのインストルメント化
• Node.js: OpenTelemetry による Node.js アプリケーションのインストルメント化

AppDynamics:

• Python: Python エージェントのインストール
• Node.js: Node.js エージェントのインストール

コンテナー ログの表示

コンテナー アプリケーションのコンソール ログを表示するには、次の CLI コマンドを使用できます。

az spring app logs \
    --resource-group <your-resource-group> \
    --name <your-app-name> \
    --service <your-service-name> \
    --instance <your-instance-name>

Azure Monitor でコンテナー イベント ログを表示するには、クエリを入力します。

AppPlatformContainerEventLogs
| where App == "hw-20220317-1b"

イメージの脆弱性をスキャンする

イメージの脆弱性を回避するために、ACR と共に Microsoft Defender for Cloud を使用することをお勧めします。 詳しくは、Microsoft Defender for Cloud に関するページをご覧ください

JAR デプロイとコンテナー デプロイを切り替える

次のコマンドを使って再デプロイすることで、デプロイの種類を JAR デプロイからコンテナー デプロイに直接切り替えることができます。

az spring app deploy \
    --resource-group <your-resource-group> \
    --name <your-app-name> \
    --container-image <your-container-image> \
    --service <your-service-name>

または、逆にすることもできます。

az spring app deploy \
    --resource-group <your-resource-group> \
    --name <your-app-name> \
    --artifact-path <your-jar-file> \
    --service <your-service-name>

既存の JAR デプロイを使用して別のデプロイを作成する

次のコマンドを使用すると、既存の JAR デプロイを使用して別のデプロイを作成できます。

az spring app deployment create \
    --resource-group <your-resource-group> \
    --name <your-deployment-name> \
    --app <your-app-name> \
    --container-image <your-container-image> \
    --service <your-service-name>

CI/CD

Azure Pipelines タスクまたは GitHub Actions を使ったデプロイの自動化が、サポートされるようになりました。 詳しくは、「Azure Spring Apps へのアプリケーション デプロイを自動化する」および「GitHub Actions で Azure Spring Apps の CI/CD を使用する」をご覧ください。

次のステップ

• ダンプをキャプチャする方法