クイック スタート: リポジトリから Azure Container Apps へのビルドとデプロイ

この記事では、選択したプログラミング言語を使用し、マイクロサービスをビルドして、GitHub リポジトリから Azure Container Apps にデプロイする方法について説明します。 このクイック スタートでは、音楽アルバムの静的コレクションを返すバックエンド Web API サービスであるサンプル マイクロサービスを作成します。

このサンプル アプリケーションは、2 つのバージョンで利用できます。 1 つのバージョンにはコンテナーが含まれており、ソースには Dockerfile が含まれています。 もう一方のバージョンには Dockerfile がありません。 ご自分のソース コードに最も適したバージョンを選択してください。 コンテナーを初めてお使いになる場合は、上部にある [Dockerfile なし] オプションを選択してください。

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

前提条件

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

セットアップ

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

az login

Connect-AzAccount

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

az upgrade

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

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

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

az extension add --name containerapp --upgrade

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

Install-Module -Name Az.App

Update-Module -Name Az.App

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

az provider register --namespace Microsoft.App

az provider register --namespace Microsoft.OperationalInsights

Register-AzResourceProvider -ProviderNamespace Microsoft.App

Register-AzResourceProvider -ProviderNamespace Microsoft.OperationalInsights

環境変数を作成する

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

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

export ACR_NAME="acaalbums"$GITHUB_USERNAME

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

$ACR_NAME="acaalbums"+$GITHUB_USERNAME

GitHub リポジトリを準備する

コンテナーアプリ をビルドしてデプロイする

containerapp up コマンドを使用して、フォークされた GitHub リポジトリから最初のコンテナー アプリを ビルドしてデプロイします。 このコマンドは次の操作を行います:

新しいコードをリポジトリにプッシュすると、GitHub アクションによって次の処理が行われます。

az containerapp up \
  --name $API_NAME \
  --resource-group $RESOURCE_GROUP \
  --location $LOCATION \
  --environment $ENVIRONMENT \
  --context-path ./src \
  --repo <YOUR_GITHUB_REPOSITORY_NAME>

az containerapp up \
  --name $API_NAME \
  --resource-group $RESOURCE_GROUP \
  --location $LOCATION \
  --environment $ENVIRONMENT \
  --context-path ./src \
  --ingress external \
  --target-port 8080 \
  --repo <YOUR_GITHUB_REPOSITORY_NAME>
  --branch buildpack
  --

az containerapp up `
    --name $API_NAME `
    --resource-group $RESOURCE_GROUP `
    --location $LOCATION `
    --environment $ENVIRONMENT `
    --context-path ./src `
    --repo <YOUR_GITHUB_REPOSITORY_NAME>

az containerapp up `
    --name $API_NAME `
    --resource-group $RESOURCE_GROUP `
    --location $LOCATION `
    --environment $ENVIRONMENT `
    --context-path ./src `
    --ingress external `
    --target-port 8080 `
    --repo <YOUR_GITHUB_REPOSITORY_NAME>
    --branch buildpack

ターミナルに表示される URL とユーザー コードを使用して、ブラウザーで GitHub デバイスのアクティブ化ページに移動し、ページにユーザー コードを入力します。 プロンプトに従って、Azure CLI が GitHub リポジトリにアクセスすることを承認します。

up コマンドにより、リポジトリの .github/workflows フォルダーに GitHub アクション ワークフローが作成されます。 リポジトリに変更をプッシュすると、コンテナー アプリをビルドしてデプロイするワークフローがトリガーされます。

デプロイの確認

containerapp up により返されたドメイン名を Web ブラウザーにコピーします。 Web ブラウザーから、URL の /albums エンドポイントにアクセスします。

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

フロントエンドのデプロイ に関するチュートリアルに進まない場合は、次のコマンドを使用して、このクイックスタートで作成した Azure リソースを削除できます。

az group delete --name $RESOURCE_GROUP

az group delete --name $RESOURCE_GROUP

次のステップ

このクイックスタートを完了したら、チュートリアル: Azure Container Apps でのマイクロサービス間の通信 に進み、API を呼び出すフロントエンド アプリケーションをデプロイする方法を学習できます。