Azure Pipelines から Azure Container Apps にデプロイする

[アーティクル]
10/20/2024

Azure Container Apps を使用すると、Azure Pipelines を使用してコンテナーアプリにリビジョンを発行できます。コミットが Azure DevOps リポジトリにプッシュされると、コンテナーレジストリ内のコンテナーイメージを更新するパイプラインがトリガーされます。 Azure Container Apps によって、更新されたコンテナーイメージに基づいて新しいリビジョンが作成されます。

リポジトリ内の特定のブランチへのコミットによって、パイプラインがトリガーされます。パイプラインを作成する際、トリガーとなるブランチを決定します。

Container Apps の Azure Pipelines タスク

このタスクは、次のシナリオをサポートします。

Dockerfile からビルドし、Container Apps にデプロイします
Dockerfile を使用せずにソースコードからビルドし、Container Apps にデプロイする。サポートされる言語には、.NET、Java、Node.js、PHP、Python が含まれる
既存のコンテナーイメージを Container Apps にデプロイする

運用リリースでは、このタスクは Azure DevOps に付属しており、明示的にインストールする必要はありません。完全なドキュメントについては、「AzureContainerApps@1 - Azure Container Apps デプロイ v1 タスク」を参照してください。

使用例

このタスクを使用するための一般的なシナリオを次に示します。詳細については、タスクのドキュメントを参照してください。

Container Apps をビルドしてデプロイする

次のスニペットは、コンテナーイメージをソースコードからビルドし、Container Apps にデプロイする方法を示しています。

steps:
- task: AzureContainerApps@1
  inputs:
    appSourcePath: '$(Build.SourcesDirectory)/src'
    azureSubscription: 'my-subscription-service-connection'
    acrName: 'myregistry'
    containerAppName: 'my-container-app'
    resourceGroup: 'my-container-app-rg'

タスクでは、appSourcePath 内の Dockerfile を使用してコンテナーイメージがビルドされます。 Dockerfile が見つからない場合、タスクは、appSourcePath 内のソースコードからコンテナーイメージをビルドすることを試みます。

既存のコンテナーイメージを Container Apps にデプロイする

次のスニペットは、既存のコンテナーイメージを Container Apps にデプロイする方法を示しています。タスクは、サービス接続を使用してレジストリで認証します。サービス接続の ID にレジストリの AcrPush ロールが割り当てられていない場合は、acrUsername と acrPassword 入力パラメーターを使用してレジストリの管理者資格情報を指定します。

steps:
  - task: AzureContainerApps@1
    inputs:
      azureSubscription: 'my-subscription-service-connection'
      containerAppName: 'my-container-app'
      resourceGroup: 'my-container-app-rg'
      imageToDeploy: 'myregistry.azurecr.io/my-container-app:$(Build.BuildId)'

重要

別の手順でコンテナーイメージを構築する場合は、latest のような安定したタグではなく、ビルド ID などの一意のタグを使用してください。詳細については、「イメージタグのベストプラクティス」を参照してください。

Azure Container Registry での認証

コンテナーイメージをプッシュするには、Azure Container Apps タスクを Azure Container Registry で認証する必要があります。コンテナーイメージをプッシュするには、コンテナーアプリケーションを Container Registry で認証する必要もあります。

イメージをプッシュするために、タスクは、azureSubscription で提供されるサービス接続を使用して、acrName で指定されたコンテナーレジストリで自動的に認証されます。サービス接続の ID にレジストリの AcrPush ロールが割り当てられていない場合は、acrUsername と acrPassword を使用してレジストリの管理者資格情報を指定します。

イメージをプルするために、Azure Container Apps はマネージド ID (推奨) または管理者資格情報を使用して、Azure Container Registry で認証を行います。マネージド ID を使用するには、タスクのターゲットコンテナーアプリを、マネージド ID を使用するように構成する必要があります。レジストリの管理者資格情報で認証するには、タスクの acrUsername と acrPassword 入力を設定します。

構成

Azure Container Apps にデプロイするように Azure DevOps パイプラインを構成するには、次の手順を行います。

アプリ用の Azure DevOps リポジトリを作成する
マネージド ID が有効になっているコンテナーアプリを作成する
コンテナーアプリのマネージド ID に Azure Container Registry の AcrPull ロールを割り当てる
Azure DevOps Marketplace から Azure Container Apps タスクをインストールする
Azure サブスクリプションの Azure DevOps サービス接続を構成する
Azure DevOps パイプラインを作成する

前提条件

要件	手順
Azure アカウント	お持ちでない場合は、無料のアカウントを作成してください。続行するには、Azure サブスクリプションの "共同作成者" または "所有者" のアクセス許可が必要です。詳細については、「Azure portal を使用して Azure ロールを割り当てる」を参照してください。
Azure DevOps プロジェクト	Azure DevOps に移動し、[無料で開始する] を選択します。次に、新しいプロジェクトを作成します。
Azure CLI	Azure CLI をインストールします。

Azure DevOps リポジトリを作成し、ソースコードを複製する

パイプラインを作成する前に、アプリのソースコードがリポジトリ内に存在している必要があります。

Azure DevOps にサインインし、お使いのプロジェクトに移動します。
[リポジトリ] ページを開きます。
上部のナビゲーションバーで、[リポジトリ] ドロップダウンを選択し、[リポジトリのインポート] を選択します。
次の情報を入力し、[インポート] を選択します。

フィールド値

リポジトリの種類 Git

クローン URL https://github.com/Azure-Samples/containerapps-albumapi-csharp.git

名前 my-container-app
[複製] を選択してリポジトリの URL を表示し、コピーします。
ターミナルを開き、次のコマンドを実行します。
```
git clone <REPOSITORY_URL> my-container-app
```
<REPOSITORY_URL> を、コピーした URL に置き換えます。

フィールド	値
リポジトリの種類	Git
クローン URL	`https://github.com/Azure-Samples/containerapps-albumapi-csharp.git`
名前	`my-container-app`

コンテナーアプリを作成し、マネージド ID を構成する

次の手順で az containerapp up コマンドを使用してコンテナーアプリを作成します。このコマンドは、Azure リソースの作成、コンテナーイメージのビルド、レジストリへのイメージの格納、コンテナーアプリへのデプロイを行います。

アプリを作成したら、マネージド ID をアプリに追加し、その ID に AcrPull ロールを割り当てて、ID でレジストリからイメージをプルできるようにすることができます。

クローンされたレポジトリの src フォルダーに移動します。
```
cd my-container-app
cd src
```
Azure リソースを作成し、az containerapp up コマンドを使用してコンテナーアプリをデプロイします。
```
az containerapp up \
  --name my-container-app \
  --source . \
  --ingress external 
```
コマンド出力に示されている Azure Container Registry の名前をメモします。
コンテナーレジストリの完全なリソース ID を取得します。
```
az acr show --name <ACR_NAME> --query id --output tsv
```
<ACR_NAME> は自分のレジストリの名前に置き換えます。
コンテナーアプリのマネージド ID を有効にします。
```
az containerapp identity assign \
  --name my-container-app \
  --resource-group my-container-app-rg \
  --system-assigned
```
コマンド出力に示されているマネージド ID のプリンシパル ID をメモします。
Azure Container Registry の AcrPull ロールをコンテナーアプリのマネージド ID に割り当てます。
```
az role assignment create \
  --assignee <MANAGED_IDENTITY_PRINCIPAL_ID> \
  --role AcrPull \
  --scope <ACR_RESOURCE_ID>
```
<MANAGED_IDENTITY_PRINCIPAL_ID> をマネージド ID のプリンシパル ID に置き換え、<ACR_RESOURCE_ID> を Azure Container Registry のリソース ID に置き換えます。
マネージド ID を使用してイメージを Azure Container Registry からプルするようにコンテナーアプリを構成します。
```
az containerapp registry set \
  --name my-container-app \
  --resource-group my-container-app-rg \
  --server <ACR_NAME>.azurecr.io \
  --identity system
```
<ACR_NAME> を Azure Container Registry の名前に置き換えます。

Azure DevOps サービス接続を作成する

Azure Container Apps をデプロイするには、お使いの Azure サブスクリプションの Azure DevOps サービス接続を作成する必要があります。

Azure DevOps で、プロジェクト設定 を選択します。
[サービス接続] を選択します。
[新しいサービス接続] を選択します。
[Azure Resource Manager] を選択します。
[サービスプリンシパル (自動)] を選択し、[次へ] を選択します。

次の情報を入力して、 [保存] を選択します。

フィールド	値
サブスクリプション	Azure サブスクリプションを選択します。
リソースグループ	コンテナーアプリとコンテナーレジストリが含まれているリソースグループ (`my-container-app-rg`) を選択します。
サービス接続名	`my-subscription-service-connection`

サービス接続の詳細については、「Microsoft Azure に接続する」を参照してください。

Azure DevOps YAML パイプラインを作成する

Azure DevOps プロジェクトで、[パイプライン] を選択します。
[新しいパイプライン] を選択します。
[Azure Repos Git] を選択します。
ソースコードが含まれているリポジトリ (my-container-app) を選択します。
[スタートパイプライン] を選択します。

エディターで、ファイルの内容を次の YAML に置き換えます。

trigger:
  branches:
    include:
      - main

pool:
  vmImage: ubuntu-latest

steps:
  - task: AzureContainerApps@1
    inputs:
      appSourcePath: '$(Build.SourcesDirectory)/src'
      azureSubscription: '<AZURE_SUBSCRIPTION_SERVICE_CONNECTION>'
      acrName: '<ACR_NAME>'
      containerAppName: 'my-container-app'
      resourceGroup: 'my-container-app-rg'

<AZURE_SUBSCRIPTION_SERVICE_CONNECTION> を、前の手順で作成した Azure DevOps サービス接続の名前 (my-subscription-service-connection) に置き換え、<ACR_NAME> を Azure Container Registry の名前に置き換えます。

[保存および実行] を選択します。

Azure Pipelines の実行によって、コンテナーアプリのビルドとデプロイが開始されます。その進行状況を確認するには、[パイプライン] に移動し、[実行] を選択します。初めてパイプラインを実行するとき、パイプラインによるサービス接続の使用の認可を求められる場合があります。

アプリの新しいリビジョンをデプロイするには、新しいコミットを メイン ブランチにプッシュします。

次の方法で共有

Azure Pipelines から Azure Container Apps にデプロイする

Container Apps の Azure Pipelines タスク

使用例

Container Apps をビルドしてデプロイする

既存のコンテナーイメージを Container Apps にデプロイする

Azure Container Registry での認証

構成

前提条件

Azure DevOps リポジトリを作成し、ソースコードを複製する

コンテナーアプリを作成し、マネージド ID を構成する

Azure DevOps サービス接続を作成する

Azure DevOps YAML パイプラインを作成する

フィードバック

その他のリソース

次の方法で共有

Azure Pipelines から Azure Container Apps にデプロイする

Container Apps の Azure Pipelines タスク

使用例

Container Apps をビルドしてデプロイする

既存のコンテナー イメージを Container Apps にデプロイする

Azure Container Registry での認証

構成

前提条件

Azure DevOps リポジトリを作成し、ソース コードを複製する

コンテナー アプリを作成し、マネージド ID を構成する

Azure DevOps サービス接続を作成する

Azure DevOps YAML パイプラインを作成する

フィードバック

その他のリソース

既存のコンテナーイメージを Container Apps にデプロイする

Azure DevOps リポジトリを作成し、ソースコードを複製する

コンテナーアプリを作成し、マネージド ID を構成する