GitHub Actions を使用して Azure Container Apps にデプロイする

[アーティクル]
05/04/2023

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

GitHub リポジトリを変更すると、新しいリビジョンを作成するためのアクションがトリガーされます。

GitHub Actions ワークフローは、リポジトリ内の特定のブランチへのコミットによってトリガーされます。ワークフローを作成するときに、どのブランチがワークフローをトリガーするかを決定します。

この記事では、完全にカスタマイズ可能なワークフローを作成する方法について説明します。 Azure CLI を使用してスターター GitHub Actions ワークフローを生成するには、「Azure CLI を使用して GitHub Actions ワークフローを生成する」を参照してください。

Azure Container Apps GitHub アクション

コンテナーアプリをビルドしてデプロイするには、azure/container-apps-deploy-action アクションを GitHub Actions ワークフローに追加します。

このアクションでは次のシナリオをサポートします。

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

使用例

アクションを使用するための一般的なシナリオを以下に示します。詳細については、アクションの GitHub Marketplace ページを参照してください。

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

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

steps:

  - name: Log in to Azure
    uses: azure/login@v1
    with:
      creds: ${{ secrets.AZURE_CREDENTIALS }}

  - name: Build and deploy Container App
    uses: azure/container-apps-deploy-action@v1
    with:
      appSourcePath: ${{ github.workspace }}/src
      acrName: myregistry
      containerAppName: my-container-app
      resourceGroup: my-rg

アクションでは、appSourcePath の Dockerfile を使用してコンテナーイメージをビルドします。 Dockerfile が見つからない場合、アクションは appSourcePath のソースコードからコンテナーイメージをビルドしようとします。

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

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

steps:

  - name: Log in to Azure
    uses: azure/login@v1
    with:
      creds: ${{ secrets.AZURE_CREDENTIALS }}

  - name: Build and deploy Container App
    uses: azure/container-apps-deploy-action@v1
    with:
      acrName: myregistry
      containerAppName: my-container-app
      resourceGroup: my-rg
      imageToDeploy: myregistry.azurecr.io/app:${{ github.sha }}

重要

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

Azure Container Registry での認証

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

イメージをプッシュするには、azure/login アクションに指定された資格情報を使用して、acrName で指定されたコンテナーレジストリでアクションが自動的に認証されます。

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

構成

Azure Container Apps にデプロイするように GitHub Actions ワークフローを構成するには、次の手順を実行します。

アプリの GitHub リポジトリを作成する
マネージド ID が有効になっているコンテナーアプリを作成する
コンテナーアプリのマネージド ID に Azure Container Registry の AcrPull ロールを割り当てる
GitHub リポジトリにシークレットを構成する
GitHub Actions ワークフローを作成する

前提条件

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

GitHub リポジトリを作成し、ソースコードをクローンする

ワークフローを作成する前に、アプリのソースコードが GitHub リポジトリに存在する必要があります。

Azure CLI を使用して Azure にサインインします。
```
az login
```
次に、CLI 用の最新の Azure Container Apps 拡張機能をインストールします。
```
az extension add --name containerapp --upgrade
```
独自の GitHub リポジトリがない場合は、サンプルから作成します。
1. 次の場所に移動して、新しいリポジトリを作成します。
  - https://github.com/Azure-Samples/containerapps-albumapi-csharp/generate
2. リポジトリに my-container-app という名前を付けます。

ローカルコンピューターにリポジトリを複製します。

git clone https://github.com/<YOUR_GITHUB_ACCOUNT_NAME>/my-container-app.git

マネージド 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 の名前に置き換えます。

GitHub リポジトリにシークレットを構成する

GitHub ワークフローでは、Azure で認証を行うために AZURE_CREDENTIALS という名前のシークレットが必要です。シークレットには、コンテナーアプリとコンテナーレジストリを含むリソースグループに対する共同作成者ロールを持つサービスプリンシパルの認証情報が含まれています。

コンテナーアプリとコンテナーレジストリを含むリソースグループに対する共同作成者ロールを持つサービスプリンシパルを作成します。
```
az ad sp create-for-rbac \
  --name my-app-credentials \
  --role contributor \
  --scopes /subscriptions/<SUBSCRIPTION_ID>/resourceGroups/my-container-app-rg \
  --json-auth \
  --output json
```
<SUBSCRIPTION_ID> を Azure サブスクリプション ID に置き換えます。コンテナーレジストリが別のリソースグループにある場合は、--scopes パラメーターに両方のリソースグループを指定します。
コマンドからの JSON 出力をコピーします。
GitHub リポジトリで、[設定]>[シークレット]>[アクション] に移動し、[新しいリポジトリシークレット] を選択します。
名前として「AZURE_CREDENTIALS」と入力し、JSON 出力のコンテンツを値として貼り付けます。
[Add secret](シークレットの追加) を選択します。

GitHub Actions ワークフローを作成する

GitHub リポジトリで、[アクション] に移動し、[新しいワークフロー] を選択します。
[Set up a workflow yourself]\(ワークフローを自分でセットアップする\) を選択します。

エディターに次の YAML を貼り付けます。

name: Azure Container Apps Deploy

on:
  push:
    branches:
      - main

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v3

      - name: Log in to Azure
        uses: azure/login@v1
        with:
          creds: ${{ secrets.AZURE_CREDENTIALS }}

      - name: Build and deploy Container App
        uses: azure/container-apps-deploy-action@v1
        with:
          appSourcePath: ${{ github.workspace }}/src
          acrName: <ACR_NAME>
          containerAppName: my-container-app
          resourceGroup: my-container-app-rg

<ACR_NAME> を Azure Container Registry の名前に置き換えます。 branches の下のブランチ名と、appSourcePath、containerAppName、および resourceGroup の値が、リポジトリと Azure リソースの値と一致していることを確認してください。

メイン ブランチへの変更をコミットします。

GitHub Actions ワークフローの実行は、コンテナーアプリのビルドとデプロイを開始する必要があります。進行状況を確認するには、[アクション] に移動します。

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

次の方法で共有

GitHub Actions を使用して Azure Container Apps にデプロイする

Azure Container Apps GitHub アクション

使用例

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

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

Azure Container Registry での認証

構成

前提条件

GitHub リポジトリを作成し、ソースコードをクローンする

マネージド ID が有効になっているコンテナーアプリを作成する

GitHub リポジトリにシークレットを構成する

GitHub Actions ワークフローを作成する

フィードバック

その他のリソース

次の方法で共有

GitHub Actions を使用して Azure Container Apps にデプロイする

Azure Container Apps GitHub アクション

使用例

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

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

Azure Container Registry での認証

構成

前提条件

GitHub リポジトリを作成し、ソース コードをクローンする

マネージド ID が有効になっているコンテナー アプリを作成する

GitHub リポジトリにシークレットを構成する

GitHub Actions ワークフローを作成する

フィードバック

その他のリソース

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

GitHub リポジトリを作成し、ソースコードをクローンする

マネージド ID が有効になっているコンテナーアプリを作成する