チュートリアル: アプリをビルドして Azure Container Apps にデプロイする

この記事では、選択したプログラミング言語を使用し、マイクロサービスをビルドして、ソース リポジトリから Azure Container Apps にデプロイする方法について説明します。

これは、Azure Container Apps のコア機能を使用する方法について説明する一連の記事の最初のチュートリアルです。 最初の手順では、音楽アルバムの静的コレクションを返すバックエンド Web API サービスを作成します。

注意

また、クイックスタート: リポジトリから Azure Container Apps にアプリをビルドしてデプロイするアーティクルの手順に従って、az containerapp up を使用してこのアプリをビルドしてデプロイすることもできます。 az containerapp up コマンドは、1 つのコマンドでアプリをビルドして Azure Container Apps にデプロイするための高速で便利な方法です。 ただし、コンテナー アプリのカスタマイズが同じレベルで提供されるわけではありません。

シリーズの次のチュートリアルでは、フロントエンド Web アプリケーションをビルドして Azure Container Apps にデプロイします。

次のスクリーンショットは、このチュートリアルでデプロイされるアルバム API の出力を示しています。

前提条件

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

要件	手順
Azure アカウント	お持ちでない場合は、無料のアカウントを作成してください。 続行するには、Azure サブスクリプションの "ユーザー アクセス管理者" または "所有者" のアクセス許可が必要です。 コンテキストに応じて最も制限の厳しいロールを使用してください。 詳細については、「Azure portal を使用して Azure ロールを割り当てる」と「Azure ロール、Microsoft Entra ロール、従来のサブスクリプション管理者ロール」を参照してください。
GitHub アカウント	無料試用版にサインアップします。
git	git をインストールします
Azure CLI	Azure CLI をインストールします。

要件	手順
Azure アカウント	お持ちでない場合は、無料のアカウントを作成してください。 続行するには、Azure サブスクリプションの "共同作成者" または "所有者" のアクセス許可が必要です。 詳細については、「Azure portal を使用して Azure ロールを割り当てる」を参照してください。
GitHub アカウント	無料試用版にサインアップします。
git	git をインストールします
Azure CLI	Azure CLI をインストールします。
Docker Desktop	Docker には、macOS、Windows、Linux 上で Docker 環境の構成を行うインストーラが用意されています。 コマンド プロンプトに「docker」と入力して、Docker が実行していることを確認します。

セットアップ

CLI から Azure にサインインするには、次のコマンドを実行し、プロンプトに従って認証プロセスを完了します。

Bash

az login

Azure PowerShell

Connect-AzAccount

最新バージョンの CLI を実行していることを確認するには、upgrade コマンドを実行します。

Bash

az upgrade

Azure PowerShell

Install-Module -Name Az -Scope CurrentUser -Repository PSGallery -Force

現在使用中のモジュールに関する警告は無視します。

次に、CLI 用の Azure Container Apps 拡張機能をインストールまたは更新します。

Azure CLI で az containerapp コマンドを実行したとき、または Azure PowerShell で Az.App モジュールからコマンドレットを実行したときに、パラメーターの不足に関するエラーが表示される場合は、最新バージョンの Azure Container Apps 拡張機能がインストールされていることを確認してください。

Bash

az extension add --name containerapp --upgrade

Note

2024 年 5 月以降、Azure CLI 拡張機能では、既定でプレビュー機能が有効になりません。 Container Apps のプレビュー機能にアクセスするには、--allow-preview true を使用して Container Apps 拡張機能をインストールします。

az extension add --name containerapp --upgrade --allow-preview true

Azure PowerShell

Install-Module -Name Az.App

Az.App モジュールを最新バージョンに更新するのを忘れないでください。

Update-Module -Name Az.App

最新の拡張機能またはモジュールがインストールされたので、Microsoft.App および Microsoft.OperationalInsights 名前空間を登録します。

Bash

az provider register --namespace Microsoft.App

az provider register --namespace Microsoft.OperationalInsights

Azure PowerShell

Register-AzResourceProvider -ProviderNamespace Microsoft.App

Register-AzResourceProvider -ProviderNamespace Microsoft.OperationalInsights

環境変数を作成する

Azure CLI のセットアップが完了したところで、この記事全体で使用される環境変数を定義できます。

Bash

bash シェルで次の変数を定義します。

RESOURCE_GROUP="album-containerapps"
LOCATION="canadacentral"
ENVIRONMENT="env-album-containerapps"
API_NAME="album-api"
FRONTEND_NAME="album-ui"
GITHUB_USERNAME="<YOUR_GITHUB_USERNAME>"

このコマンドを実行する前に、必ず <YOUR_GITHUB_USERNAME> を GitHub ユーザー名に置き換えてください。

次に、一意のコンテナー レジストリ名を定義します。

ACR_NAME="acaalbums"$GITHUB_USERNAME

Azure PowerShell

PowerShell コンソールで次の変数を定義します。

$ResourceGroup = "album-containerapps"
$Location = "canadacentral"
$Environment = "env-album-containerapps"
$APIName="album-api"
$FrontendName="album-ui"
$GITHUB_USERNAME = "<YOUR_GITHUB_USERNAME>"

このコマンドを実行する前に、必ず <YOUR_GITHUB_USERNAME> を GitHub ユーザー名に置き換えてください。

次に、一意のコンテナー レジストリ名を定義します。

$ACRName = "acaalbums"+$GITHUB_USERNAME

GitHub リポジトリを準備する

目的の言語のリポジトリに移動し、リポジトリをフォークします。

C#

アルバム API リポジトリの上部にある [フォーク] ボタンを選択して、リポジトリを自分のアカウントにフォークします。

これで、サンプル リポジトリのフォークをクローンできます。

次の git コマンドを使用して、フォークされたリポジトリを code-to-cloud フォルダーにクローンします。

git clone https://github.com/$GITHUB_USERNAME/containerapps-albumapi-csharp.git code-to-cloud

Go

アルバム API リポジトリの上部にある [フォーク] ボタンを選択して、リポジトリを自分のアカウントにフォークします。

これで、サンプル リポジトリのフォークをクローンできます。

次の git コマンドを使用して、フォークされたリポジトリを code-to-cloud フォルダーにクローンします。

git clone https://github.com/$GITHUB_USERNAME/containerapps-albumapi-go.git code-to-cloud

Java

アルバム API リポジトリの上部にある [フォーク] ボタンを選択して、リポジトリを自分のアカウントにフォークします。

これで、サンプル リポジトリのフォークをクローンできます。

次の git コマンドを使用して、フォークされたリポジトリを code-to-cloud フォルダーにクローンします。

git clone https://github.com/$GITHUB_USERNAME/containerapps-albumapi-java.git code-to-cloud

Note

この Java サンプルでは、実行可能な JAR ファイルが結果として作成される Maven ビルドのみがサポートされています。 環境変数での受け渡しはサポートされていないため、ビルドでは既定の設定が使用されます。

JavaScript

アルバム API リポジトリの上部にある [フォーク] ボタンを選択して、リポジトリを自分のアカウントにフォークします。

これで、サンプル リポジトリのフォークをクローンできます。

次の git コマンドを使用して、フォークされたリポジトリを code-to-cloud フォルダーにクローンします。

git clone https://github.com/$GITHUB_USERNAME/containerapps-albumapi-javascript.git code-to-cloud

Python

アルバム API リポジトリの上部にある [フォーク] ボタンを選択して、リポジトリを自分のアカウントにフォークします。

これで、サンプル リポジトリのフォークをクローンできます。

次の git コマンドを使用して、フォークされたリポジトリを code-to-cloud フォルダーにクローンします。

git clone https://github.com/$GITHUB_USERNAME/containerapps-albumapi-python.git code-to-cloud

次に、クローンされたリポジトリのルートにディレクトリを変更します。

cd code-to-cloud/src

Azure リソース グループの作成

コンテナー アプリのデプロイに関連するサービスを整理するためのリソース グループを作成します。

Bash

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

Azure PowerShell

New-AzResourceGroup -Location $Location -Name $ResourceGroupName

Azure Container Registry を作成する

アルバム API コンテナー イメージのビルド後、それを格納するため、Azure Container Registry (ACR) インスタンスをリソース グループに作成します。

Bash

az acr create \
  --resource-group $RESOURCE_GROUP \
  --name $ACR_NAME \
  --sku Basic \
  --admin-enabled true

Azure PowerShell

$acr = New-AzContainerRegistry -ResourceGroupName $ResourceGroup -Name $ACRName -Sku Basic -EnableAdminUser

アプリケーションをビルドする

ACR タスクを使用すると、Docker をローカルにインストールしなくても、アルバム API の Docker イメージをビルドしてプッシュできます。

ACR を使用してコンテナーをビルドする

次のコマンドを実行して、ACR を使用したイメージのビルドとプッシュのプロセスを開始します。 コマンドの末尾の . は Docker ビルド コンテキストを表します。つまり、このコマンドは Dockerfile が配置されている src フォルダー内で実行する必要があります。

Bash

az acr build --registry $ACR_NAME --image $API_NAME .

Azure PowerShell

az acr build --registry $ACRName --image $APIName .

az acr build コマンドの出力には、ソース コードの Azure へのアップロードの進行状況と docker build 操作および docker push 操作の詳細が表示されます。

アプリケーションをビルドする

次の手順は、Docker を使用してコンテナー イメージをローカルにビルドし、新しいコンテナー レジストリにイメージをプッシュする方法を示します。

Docker を使用してコンテナーをビルドする

次のコマンドでは、アルバム API のコンテナー イメージをビルドし、ACR ログイン サーバーの完全修飾名でタグ付けします。 コマンドの末尾の . は Docker ビルド コンテキストを表します。つまり、このコマンドは Dockerfile が配置されている src フォルダー内で実行する必要があります。

Bash

docker build --tag $ACR_NAME.azurecr.io/$API_NAME .

Azure PowerShell

docker build --tag "$ACRName.azurecr.io/$APIName" .

コンテナー レジストリにイメージをプッシュする

まず、Azure Container Registry にサインインします。

Bash

az acr login --name $ACR_NAME

Azure PowerShell

az acr login --name $ACRName

次に、レジストリにイメージをプッシュします。

Bash

docker push $ACR_NAME.azurecr.io/$API_NAME

Azure PowerShell

docker push "$ACRName.azurecr.io/$APIName"

Container Apps 環境を作成する

Azure Container Apps 環境は、コンテナー アプリのグループを囲むセキュリティ保護された境界として機能します。

次のコマンドを使用して、Container Apps 環境を作成します。

Bash

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

Azure PowerShell

Container Apps 環境には Log Analytics ワークスペースが必要です。 次のコマンドを実行すると、Log Analytics ワークスペースが作成され、ワークスペース ID とプライマリ共有キーが変数に保存されます。

$WorkspaceArgs = @{
    Name = 'my-album-workspace'
    ResourceGroupName = $ResourceGroup
    Location = $Location
    PublicNetworkAccessForIngestion = 'Enabled'
    PublicNetworkAccessForQuery = 'Enabled'
}
New-AzOperationalInsightsWorkspace @WorkspaceArgs
$WorkspaceId = (Get-AzOperationalInsightsWorkspace -ResourceGroupName $ResourceGroup -Name $WorkspaceArgs.Name).CustomerId
$WorkspaceSharedKey = (Get-AzOperationalInsightsWorkspaceSharedKey -ResourceGroupName $ResourceGroup -Name $WorkspaceArgs.Name).PrimarySharedKey

環境を作成するために、次のコマンドを実行します。

$EnvArgs = @{
    EnvName = $Environment
    ResourceGroupName = $ResourceGroup
    Location = $Location
    AppLogConfigurationDestination = 'log-analytics'
    LogAnalyticConfigurationCustomerId = $WorkspaceId
    LogAnalyticConfigurationSharedKey = $WorkspaceSharedKey
}

New-AzContainerAppManagedEnv @EnvArgs

コンテナー アプリにイメージをデプロイする

環境が作成されたところで、az containerapp create コマンドを使用してコンテナー アプリを作成してデプロイできます。

次のコマンドを使用して、コンテナー アプリを作成してデプロイします。

Bash

az containerapp create \
  --name $API_NAME \
  --resource-group $RESOURCE_GROUP \
  --environment $ENVIRONMENT \
  --image $ACR_NAME.azurecr.io/$API_NAME \
  --target-port 8080 \
  --ingress external \
  --registry-server $ACR_NAME.azurecr.io \
  --query properties.configuration.ingress.fqdn

• --ingress を external に設定すると、コンテナー アプリにパブリック インターネットからアクセスできるようになります。

• target-port が、コンテナーが要求をリッスンするポートと一致するように 8080 に設定されます。

• query プロパティなしで az containerapp create を呼び出すと、アプリケーションに関する多くの詳細情報を含む JSON 応答が返されます。 クエリ パラメーターを追加すると、出力がフィルター処理されて、アプリの完全修飾ドメイン名 (FQDN) のみが表示されます。

Azure PowerShell

コンテナー アプリを作成するには、New-AzContainerApp コマンドに引数として渡すテンプレート オブジェクトを作成します。

コンテナー イメージ パラメーターを定義するテンプレート オブジェクトを作成します。

$ImageParams = @{
    Name = $APIName
    Image = $ACRName + '.azurecr.io/' + $APIName + ':latest'
}
$TemplateObj = New-AzContainerAppTemplateObject @ImageParams

レジストリ資格情報を取得するには、次のコマンドを実行します。

$RegistryCredentials = Get-AzContainerRegistryCredential -Name $ACRName -ResourceGroupName $ResourceGroup

レジストリ情報を定義するレジストリ資格情報オブジェクトと、レジストリ パスワードを定義するシークレット オブジェクトを作成します。 PasswordSecretRef は シークレット オブジェクト内の Name を参照します。

$RegistryArgs = @{
    Server = $ACRName + '.azurecr.io'
    PasswordSecretRef = 'registrysecret'
    Username = $RegistryCredentials.Username
}
$RegistryObj = New-AzContainerAppRegistryCredentialObject @RegistryArgs

$SecretObj = New-AzContainerAppSecretObject -Name 'registrysecret' -Value $RegistryCredentials.Password

環境 ID を取得します。

$EnvId = (Get-AzContainerAppManagedEnv -EnvName $Environment -ResourceGroup $ResourceGroup).Id

コンテナー アプリを作成します。

$AppArgs = @{
    Name = $APIName
    Location = $Location
    ResourceGroupName = $ResourceGroup
    ManagedEnvironmentId = $EnvId
    TemplateContainer = $TemplateObj
    ConfigurationRegistry = $RegistryObj
    ConfigurationSecret = $SecretObj
    IngressTargetPort = 8080
    IngressExternal = $true
}
$MyApp = New-AzContainerApp @AppArgs

# show the app's fully qualified domain name (FQDN).
$MyApp.IngressFqdn

• IngressExternal を external に設定すると、コンテナー アプリにパブリック インターネットからアクセスできるようになります。
• IngressTargetPort パラメーターが、コンテナーが要求をリッスンするポートと一致するように 8080 に設定されます。

デプロイの確認

FQDN を Web ブラウザーにコピーします。 Web ブラウザーで、FQDN の /albums エンドポイントに移動します。

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

「マイクロサービス間の通信」チュートリアルに進まない場合は、このクイックスタートで作成した Azure リソースを削除できます。 次のコマンドを実行すると、リソース グループが、このチュートリアルで作成したすべてのリソースと共に削除されます。

Bash

az group delete --name $RESOURCE_GROUP

Azure PowerShell

Remove-AzResourceGroup -Name $ResourceGroup -Force

ヒント

問題がある場合は、 GitHub の Azure Container Apps リポジトリでイシューを開いて、お知らせください。

次のステップ

このクイックスタートは、Azure Container Apps 内のさまざまな機能を紹介する一連のプログレッシブ チュートリアルのスタート地点です。 続けて、この記事でデプロイした API を呼び出す Web フロントエンドからの通信を有効にする方法について学習します。

チュートリアル: マイクロサービス間の通信