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

この記事の適用対象:❌ Basic または Standard ✔️ Enterprise

この記事では、Azure Spring Apps Enterprise プランでポリグロット アプリをデプロイする方法と、これらのポリグロット アプリで Buildpacks によって提供されるビルド サービス機能を使用する方法について説明します。

前提条件

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

サービス インスタンスにポリグロット アプリケーションをデプロイする

このセクションは、ビルド サービスが有効になっている場合の Polyglot アプリケーションのビルドとデプロイに適用されます。 ビルド サービスを無効にすると、カスタム コンテナー イメージのみを使用してアプリケーションをデプロイできます。 独自のイメージを作成することも、Azure Spring Apps Enterprise インスタンスによってビルドされたものを使用することもできます。 詳細については、「カスタム コンテナー イメージを使用してアプリケーションをデプロイする」を参照してください。

ビルダーを管理する

Azure Spring Apps Enterprise のインスタンスを作成するときは、次のサポートされている言語ファミリ ビルドパックのいずれかから既定のビルダーを選択する必要があります。

• VMware Tanzu 用 Java Azure ビルドパック
• VMware Tanzu 用 .NET Core ビルドパック
• VMware Tanzu 用 Go ビルドパック
• VMware Tanzu 用 Web Servers ビルドパック
• VMware Tanzu 用 Node.js ビルドパック
• VMware Tanzu 用 Python ビルドパック
• VMware Tanzu 用 Java ネイティブ イメージ ビルドパック
• VMware Tanzu 用 PHP ビルドパック

詳細については、「VMware Tanzu の言語ファミリ ビルドパック」を参照してください。

これらのビルドパックでは、Java、.NET Core、Go、Web 静的ファイル、Node.js、Python アプリのソース コードまたは成果物を使用したビルドがサポートされています。 ビルダーの作成または表示中に、ビルドパックのバージョンを表示することもできます。 また、ビルドパックとスタックを指定してカスタム ビルダーを作成できます。

Azure Spring Apps サービス インスタンスで構成されているすべてのビルダーは、次のスクリーンショットに示すように [サービスのビルド] ページに一覧表示されます。

[追加] を選択して、新しいビルダーを作成します。 次のスクリーンショットは、カスタム ビルダーの作成時に使用すべきリソースを示しています。 OS スタックには、Bionic Base、Bionic Full、Jammy Tiny、Jammy Base および Jammy Full が含まれます。 Bionic は Ubuntu 18.04 (Bionic Beaver) に基づいており、Jammy は Ubuntu 22.04 (Jammy Jellyfish) に基づいています。 詳細については、「OS スタックの推奨事項」セクションを参照してください。

VMware では Bionic OS Stack を非推奨としているため、Jammy OS Stack を使用してビルダーを作成することをお勧めします。

デプロイでビルダーが使用されていない場合は、カスタム ビルダーを編集することもできます。 ビルドパックや OS スタックは更新できますが、ビルダーの名前は読み取り専用です。

このビルダーは、デプロイに継続的に提供されるリソースです。 このビルダーでは、最新のランタイム イメージと最新のビルドパックを利用できます。

既存のアクティブなデプロイがビルダーによってビルドされている場合、そのビルダーを削除することはできません。 この状態のビルダーを削除するには、次の手順に従います。

1. 構成を新しいビルダーとして保存します。
2. 新しいビルダーを使用してアプリをデプロイします。 デプロイは新しいビルダーにリンクされます。
3. 以前のビルダーの下にあるデプロイを新しいビルダーに移行します。
4. 元のビルダーを削除します。

OS スタックの推奨事項

Azure Spring Apps では、Jammy OS Stack を使用してビルダーを作成することをお勧めします。これは、Bioinic OS Stack が VMware によって廃止される予定であるためです。 次の一覧では、使用可能なオプションについて説明します。

• Jammy Tiny: 可能な限り小さいサイズとセキュリティ フットプリントのために、最小限の画像をビルドするのに適しています。 Java ネイティブ イメージのビルドと同様に、最終的なコンテナー イメージを小さくできます。 統合ライブラリは制限されています。 たとえば、shell ライブラリがないため、トラブルシューティングのためにアプリ インスタンスに接続できません。

  • ほとんどの Go アプリ。
  • Java アプリ。 Tiny にはシェルがないため、bin/setenv.sh の設定などの一部の Apache Tomcat 構成オプションは使用できません。

• Jammy Base: ネイティブ拡張機能のないほとんどのアプリに適しています。

  • Java アプリと .NET Core アプリ。
  • 一部の C ライブラリを必要とする Go アプリ。
  • ネイティブ拡張機能のない Node.js、Python、または Web サーバー アプリ。

• Jammy Full: ほとんどのライブラリが含まれており、ネイティブ拡張機能を持つアプリに適しています。 たとえば、フォントのより完全なライブラリが含まれています。 アプリがネイティブ拡張機能に依存している場合は、Full スタックを使用します。

  • ネイティブ拡張機能を使った Node.js または Python アプリ。

詳細については、VMware のドキュメントに記載の Ubuntu スタックを参照してください。

コンテナー レジストリを管理する

このセクションでは、独自のコンテナー レジストリでビルド サービスを有効にした場合に、ビルド サービスで使用されるコンテナー レジストリを管理する方法について説明します。 Azure Spring Apps マネージド コンテナー レジストリを使用してビルド サービスを有効にする場合は、このセクションをスキップできます。

ビルド サービスでユーザー コンテナー レジストリを有効にした後は、Azure portal または Azure CLI を使用してレジストリを表示および構成できます。

az spring container-registry list \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> 

az spring container-registry show \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-container-registry-name>

az spring container-registry update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-container-registry-name> \
    --server <your-container-registry-login-server> \
    --username <your-container-registry-username> \
    --password <your-container-registry-password>

az spring container-registry delete \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-container-registry-name> 

ビルド サービスでは、コンテナー レジストリを使用できます。また、関連するコンテナー レジストリを変更することもできます。 このプロセスには時間がかかります。 変更が行われると、ビルド サービスのすべてのビルダーとビルド リソースがリビルドされ、最終的なコンテナー イメージが新しいコンテナー レジストリにプッシュされます。

az spring build-service show \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name>

az spring build-service update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --registry-name <your-container-registry-name> 

Polyglot アプリケーションをビルドしてデプロイする

コンテナー レジストリを使用して、次の方法で Polyglot アプリケーションをビルドしてデプロイできます。

• Azure Spring Apps マネージド コンテナー レジストリを使用するビルド サービスの場合は、イメージにアプリケーションをビルドし、それを現在の Azure Spring Apps サービス インスタンスにデプロイできます。 ビルドとデプロイは、az spring app deploy コマンドを使用して一緒に実行されます。

• ユーザーが管理するコンテナー レジストリを使用するビルド サービスの場合は、アプリケーションをコンテナー イメージにビルドし、現在の Azure Spring Apps Enterprise インスタンスやその他のインスタンスにイメージをデプロイできます。 ビルド コマンドと配置コマンドは別々です。 build コマンドは、ビルドを作成または更新する場合に使用できます。その後で、deploy コマンドを使用すると、コンテナー イメージをサービス インスタンスにデプロイできます。

詳細については、「Tanzu Build Service を使用する」のセクション「オンデマンドでサービスを構築する」を参照してください。

次の例は、便利なビルド コマンドを示しています。

az configure --defaults group=<resource-group-name> spring=<service-name>

az spring build-service build list
az spring build-service build show --name <build-name>
az spring build-service build create --name <build-name> --artifact-path <artifact-path>
az spring build-service build update --name <build-name> --artifact-path <artifact-path>
az spring build-service build delete --name <build-name>

次の Azure CLI の例は、2 つのコンテナー レジストリ シナリオの成果物ファイルのビルドとデプロイを示しています。

• Azure Spring Apps マネージド コンテナー レジストリ。
• ユーザーが管理するコンテナー レジストリ。

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>

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

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

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>

成果物ファイルを使用してアプリをデプロイする場合は、--artifact-path を使用してファイル パスを指定します。 JAR ファイルと WAR ファイルの両方を使用できます。

Azure CLI で WAR パッケージがシン JAR として検出された場合は、--disable-validation を使用して検証を無効にします。

次の例では、--source-path パラメーターを使用してソース コード フォルダーをアクティブなデプロイに展開し、フォルダーを指定します。

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --builder <builder-name> \
    --source-path <path-to-source-code>

az spring build-service build create \
   --resource-group <resource-group-name> \
   --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --builder <builder-name> \
    --source-path <path-to-source-code>

az spring build-service build update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --builder <builder-name> \
    --source-path <path-to-source-code>

アプリをビルドするようにビルド環境を構成することもできます。 たとえば、Java アプリケーションでは、BP_JVM_VERSION ビルド環境を使用して JDK のバージョンを指定できます。

ビルド環境を指定するには、次の例に示すように、--build-env を使用します。 使用可能なビルド環境変数については、この記事の後半で説明します。

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --build-env <key1=value1> <key2=value2> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

az spring build-service build create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --build-env <key1=value1> <key2=value2> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

az spring build-service build update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --build-env <key1=value1> <key2=value2> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

ビルドごとに、次の例に示すように、ビルド リソースを指定することもできます。

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --build-env <key1=value1> <key2=value2> \
    --build-cpu <build-cpu-size> \
    --build-memory <build-memory-size> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

az spring build-service build create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --build-env <key1=value1> <key2=value2> \
    --build-cpu <build-cpu-size> \
    --build-memory <build-memory-size> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

az spring build-service build update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --build-env <key1=value1> <key2=value2> \
    --build-cpu <build-cpu-size> \
    --build-memory <build-memory-size> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

既定のビルド CPU/メモリ リソースは 1 vCPU, 2 Gi です。 アプリケーションで、より少ない量のメモリが必要な場合、またはより多くの量のメモリが必要な場合は、--build-memory を使用してメモリ リソース (500Mi、1Gi、2Gi など) を指定します。 アプリケーションで、より少ない量の CPU リソースが必要な場合、またはより多くの量の CPU リソースが必要な場合は、--build-cpu を使用してメモリ リソース (500m、1、2 など) を指定します。 ビルドの CPU/メモリ リソースの上限は 8 vCPU, 16Gi です。

CPU リソースとメモリ リソースは、ビルド サービス エージェント プールのサイズによって制限されます。 詳細については、「Tanzu Build Service を使用する」の「ビルド エージェント プール」セクションを参照してください。 処理ビルド リソース クォータの合計がエージェント プールのサイズを超えることはできません。

ビルド タスクの並列番号は、エージェント プールのサイズと各ビルド リソースによって異なります。 たとえば、ビルド リソースが既定の 1 vCPU, 2 Gi で、エージェント プールのサイズが 6 vCPU, 12 Gi である場合、並列ビルド番号は 6 になります。

リソース クォータの制限により、その他のビルド タスクはしばらくブロックされます。

アプリケーションはポート 8080 でリッスンする必要があります。 Spring Boot アプリケーションは、8080 を自動的に使用するように SERVER_PORT をオーバーライドします。

デプロイでサポートされている言語

次の表は、各言語でサポートされている機能を示しています。

さまざまな言語アプリでサポートされている構成の詳細については、この記事の後半の対応するセクションを参照してください。

Java ネイティブ イメージの制限事項

ネイティブ イメージは、Java コードを事前にネイティブ実行可能ファイルにコンパイルするテクノロジです。 ネイティブ イメージは、インスタント スタートアップやメモリ消費量の削減など、さまざまな利点をもたらします。 ネイティブ イメージを軽量のコンテナー イメージにパッケージ化して、より迅速かつ効率的なデプロイを実現できます。 クローズド ワールド最適化のため、次の制限事項が適用されます。

• 次の Java 機能では、実行可能ファイルのビルド時に構成が必要です。
  • 動的クラスの読み込み
  • リフレクション
  • 動的プロキシ
  • JNI (Java ネイティブ インターフェイス)
  • シリアル化
• バイトコードは実行時に使用できなくなったため、JVMTI を対象とするツールを使用したデバッグと監視は実行できません。

Java ネイティブ イメージの制限のため、Azure Spring Apps では次の機能はサポートされていません。 Java ネイティブ イメージとコミュニティが制限を克服すると、Azure Spring Apps はこれらをサポートします。

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

Java アプリケーションをデプロイするためのビルドパックは、tanzu-buildpacks/java-azure です。

次の表に、Azure Spring Apps でサポートされている機能を示します。

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

.NET アプリケーションをデプロイするためのビルドパックは、tanzu-buildpacks/dotnet-core です。

次の表に、Azure Spring Apps でサポートされている機能を示します。

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

Python アプリケーションをデプロイするためのビルドパックは、tanzu-buildpacks/python です。

次の表に、Azure Spring Apps でサポートされている機能を示します。

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

Go アプリケーションをデプロイするためのビルドパックは、tanzu-buildpacks/go です。

次の表に、Azure Spring Apps でサポートされている機能を示します。

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

Node.js アプリケーションをデプロイするためのビルドパックは、tanzu-buildpacks/nodejs です。

次の表に、Azure Spring Apps でサポートされている機能を示します。

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

WebServer アプリケーションをデプロイするためのビルドパックは、tanzu-buildpacks/web-servers です。

詳細については、「Web 静的ファイルをデプロイする」を参照してください。

Java ネイティブ イメージ アプリケーションをデプロイする (プレビュー)

Java ネイティブ イメージ アプリケーションをデプロイするためのビルドパックは、tanzu-buildpacks/java-native-image です。

tanzu-buildpacks/java-native-image ビルドパックを使用して Spring Boot ネイティブ イメージ アプリケーションをデプロイできます。 Spring Native では、Spring Boot アプリケーションのネイティブ実行可能ファイルへのコンパイルがサポートされます。 ビルドパックでは、Liberica Native Image Kit (NIK) を使用して Spring Boot アプリケーションのネイティブ イメージを作成します。これらのアプリケーションは完全にサポートされています。

Java ネイティブ イメージをビルドするときは、ビルド環境 BP_NATIVE_IMAGE を true に設定し、ビルド メモリ リソースは 8Gi 未満にする必要があります。 ビルド サービス エージェント プールのサイズは、4 vCPU, 8 Gi 以下にする必要があります。 詳細については、「Tanzu Build Service を使用する」の「ビルド エージェント プール」セクションを参照してください。

ネイティブ イメージをより小さなサイズのコンテナー イメージにビルドする場合は、Jammy Tiny OS スタックでビルダーを使用することをお勧めします。 詳細については、「OS スタックの推奨事項」セクションを参照してください。

次の表に、Azure Spring Apps でサポートされている機能を示します。

Java ネイティブ イメージにはいくつかの制限があります。 詳細については、「Java ネイティブ イメージの制限事項」セクションを参照してください。

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

PHP アプリケーションをデプロイするためのビルドパックは、tanzu-buildpacks/php です。

Tanzu PHP ビルドパックは、フル OS スタックとのみ互換性があります。 Jammy Full OS スタックでビルダーを使用することをお勧めします。 詳細については、「OS スタックの推奨事項」セクションを参照してください。

次の表に、Azure Spring Apps でサポートされている機能を示します。

次のステップ

• Web 静的ファイルをデプロイする