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

[アーティクル]
03/09/2023

イングレスが有効になっている場合、Azure Container Apps によりドメイン名を通して各コンテナーアプリが公開されます。外部環境内のコンテナーアプリのイングレスエンドポイントは、パブリックにアクセスできるか、同じ環境内の他のコンテナーアプリでのみ使用できます。

特定のコンテナーアプリの完全修飾ドメイン名がわかったら、共有環境内の他のコンテナーアプリからサービスを直接呼び出すことができます。

このチュートリアルでは、「Azure Container Apps にコードをデプロイする」クイックスタートでデプロイされた API に対して直接サービス呼び出しを行う 2 つ目のコンテナーアプリをデプロイします。

次のスクリーンショットは、この記事の最後にあるコンテナーアプリへの UI マイクロサービスのデプロイを示しています。

アルバムリスト UI マイクロサービスのスクリーンショット。

このチュートリアルで学習する内容は次のとおりです。

Azure Container Apps にフロントエンドアプリケーションをデプロイする
前のクイックスタートでデプロイした API エンドポイントにフロントエンドアプリをリンクする
フロントエンドアプリがバックエンド API と通信できることを確認する

前提条件

コードからクラウドへのクイックスタートでは、音楽アルバムの一覧を返すバックエンド Web API がデプロイされます。アルバム API マイクロサービスをデプロイしなかった場合は、Azure Container Apps へのコードのデプロイのクイックスタートに戻って続行します。

セットアップ

現在 Azure に対して認証されていて、クイックスタートから定義されている環境変数がある場合は、次の手順をスキップして、「GitHub リポジトリを準備する」セクションに直接進んでください。

Bash
Azure PowerShell

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

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

Azure CLI にサインインします。

Bash
Azure PowerShell

az login

Connect-AzAccount

Bash
Azure PowerShell

az acr login --name $ACR_NAME

az acr login --name $ACRName

GitHub リポジトリを準備する

新しいブラウザータブで、UI アプリケーションのリポジトリに移動し、ページの上部にある [フォーク] ボタンを選択して、リポジトリをアカウントにフォークします。

GitHub の指示に従ってリポジトリをフォークし、操作が完了したらここに戻ります。
code-to-cloud フォルダーの親に移動します。まだ code-to-cloud/src ディレクトリにいる場合は、次のコマンドを使用して親フォルダーに戻ることができます。
```
cd ../..
```
次の git コマンドを使用して、フォークされたリポジトリを code-to-cloud-ui フォルダーに複製します。
```
git clone https://github.com/$GITHUB_USERNAME/containerapps-albumui.git code-to-cloud-ui
```
注意

clone コマンドが失敗した場合は、リポジトリが正常にフォークされたことを確認します。
次に、複製されたリポジトリの src フォルダーにディレクトリを変更します。
```
cd code-to-cloud-ui/src
```

az acr build --registry $ACR_NAME --image albumapp-ui .

az acr build --registry $ACRName --image albumapp-ui .

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

次のコマンドでは、アルバム UI のコンテナーイメージをビルドし、ACR ログインサーバーの完全修飾名でタグ付けします。コマンドの末尾の . は Docker ビルドコンテキストを表します。つまり、このコマンドは Dockerfile が配置されている src フォルダー内で実行する必要があります。
- Bash
- Azure PowerShell
```
docker build --tag "$ACR_NAME.azurecr.io/albumapp-ui" . 
```
```
docker build --tag "$ACRName.azurecr.io/albumapp-ui" . 
```

イメージを ACR レジストリにプッシュする

まず、Azure Container Registry にサインインします。
- Bash
- Azure PowerShell
```
az acr login --name $ACR_NAME
```
```
az acr login --name $ACRName
```

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

Bash
Azure PowerShell


 docker push "$ACR_NAME.azurecr.io/albumapp-ui"


docker push "$ACRName.azurecr.io/albumapp-ui"

コンテナーアプリ間で通信する

前のクイックスタートでは、コンテナーアプリを作成し、外部イングレスを有効にすることで、アルバム API がデプロイされました。コンテナーアプリのイングレスを "外部" に設定すると、その HTTP エンドポイント URL が一般公開されました。

次の手順に従って、API エンドポイントを呼び出すフロントエンドアプリケーションを構成できます。

API アプリケーションの完全修飾ドメイン名 (FQDN) を照会します。
UI アプリがコード内でアルバム API 呼び出しのベース URL を設定できるように、API FQDN を環境変数として az containerapp create に渡します。

UI アプリケーションでは、提供されたエンドポイントを使用してアルバム API を呼び出します。次のコードは、routes > index.js ファイルで使用されるコードからの抜粋です。

const api = axios.create({
  baseURL: process.env.API_BASE_URL,
  params: {},
  timeout: process.env.TIMEOUT || 5000,
});

baseURL プロパティの値を API_BASE_URL 環境変数から取得する方法に注目してください。

次のコマンドを実行して、API エンドポイントアドレスを照会します。

Bash
Azure PowerShell

API_BASE_URL=$(az containerapp show --resource-group $RESOURCE_GROUP --name $API_NAME --query properties.configuration.ingress.fqdn -o tsv)

$APIBaseURL = (Get-AzContainerApp -Name $APIName -ResourceGroupName $ResourceGroup).IngressFqdn

これでアルバム API の FQDN で API_BASE_URL 変数が設定されたので、それをフロントエンドコンテナーアプリに環境変数として指定できます。

フロントエンドアプリケーションをデプロイする

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

Bash
Azure PowerShell

az containerapp create \
  --name $FRONTEND_NAME \
  --resource-group $RESOURCE_GROUP \
  --environment $ENVIRONMENT \
  --image $ACR_NAME.azurecr.io/albumapp-ui  \
  --target-port 3000 \
  --env-vars API_BASE_URL=https://$API_BASE_URL \
  --ingress 'external' \
  --registry-server $ACR_NAME.azurecr.io \
  --query properties.configuration.ingress.fqdn

引数 --env-vars "API_BASE_URL=https://$API_ENDPOINT" を az containerapp create に追加することで、フロントエンドアプリケーションの環境変数を定義します。この構文では、API_BASE_URL という名前の環境変数が API の FQDN に設定されます。

az containerapp create コマンドの出力は、フロントエンドアプリケーションの URL を示します。

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

コンテナーイメージパラメーターを定義するテンプレートオブジェクトを作成します。 API_BASE_URL という名前の環境変数が API の FQDN に設定されます。


$EnvVars = New-AzContainerAppEnvironmentVarObject -Name API_BASE_URL -Value https://$APIBaseURL

$ContainerArgs = @{
  Name = $FrontendName
  Image = $ACRName + '.azurecr.io/albumapp-ui'
  Env = $EnvVars
}
$ContainerObj = New-AzContainerAppTemplateObject @ContainerArgs

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

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

レジストリ情報を定義するレジストリ資格情報オブジェクトと、レジストリパスワードを定義するシークレットオブジェクトを作成します。 $RegistryObj の PasswordSecretRef は、$SecretObj の 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 = $FrontendName
    Location = $Location
    ResourceGroupName = $ResourceGroup
    ManagedEnvironmentId = $EnvId
    TemplateContainer = $ContainerObj
    ConfigurationRegistry = $RegistryObj
    ConfigurationSecret = $SecretObj
    IngressTargetPort = 3000
    IngressExternal = $true
}
$FrontEndApp = New-AzContainerApp @AppArgs

# show the app's FQDN

$FrontEndApp.IngressFqdn

Web サイトを表示する

コンテナーアプリの FQDN を使用して、Web サイトを表示します。ページは次のスクリーンショットのようになります。

アルバムリスト UI マイクロサービスのスクリーンショット。

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

このアプリケーションの使用を継続しない場合は、次のコマンドを実行して、このクイックスタートで作成したすべてのリソースと共にリソースグループを削除します。

注意事項

次のコマンドを実行すると、指定したリソースグループとそれに含まれるすべてのリソースが削除されます。指定したリソースグループにこのチュートリアルの範囲外のリソースが含まれている場合、それらも削除されます。

Bash
Azure PowerShell

az group delete --name $RESOURCE_GROUP

Remove-AzResourceGroup -Name $ResourceGroup -Force

ヒント

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

次のステップ

Azure Container Apps の環境