次の方法で共有

Azure Developer CLI を使用して GitHub Actions CI/CD パイプラインを作成する

この記事では、Azure Developer CLI (azd) を使用して、 azd テンプレート用の GitHub Actions CI/CD パイプラインを作成する方法について説明します。 このパイプラインを使用すると、テンプレートの更新をコード リポジトリにプッシュし、変更を Azure 環境に自動的にプロビジョニングしてデプロイすることができます。

Note

azd pipeline config コマンドはベータ版です。 詳細については、機能の バージョン管理とリリース戦略を参照してください。

Prerequisites

テンプレートを初期化する

この例では Hello-AZD テンプレートを使用しますが、パイプライン定義ファイル (通常は azd フォルダーまたは .github フォルダーにある) を含む任意の.azdo テンプレートに対して、次の手順に従うことができます。

  1. 空のディレクトリで、 hello-azd テンプレートを初期化します。

    azd init -t hello-azd

  2. メッセージが表示されたら、 helloazd などの環境の名前を入力します。

GitHub Actions を使用してパイプラインを作成する

パイプラインを作成して構成するには、次の手順に従います。

  1. テンプレートのルートにあるターミナルで、次のコマンドを実行します。

    azd pipeline config

  2. プロバイダーの選択を求められたら、 GitHub を選択します。

    ? Select a provider:  [Use arrows to move, type to filter]
> GitHub
  Azure DevOps

  3. 目的の Azure サブスクリプションとリージョンを選択します。

  4. リモート リポジトリの構成を求められたら、[ Create a new private GitHub repository]\(新しいプライベート GitHub リポジトリの作成\) を選択します。 使用する既存のプロジェクトがある場合は、[ 既存の GitHub プロジェクトの選択] を選択することもできます。

    ? How would you like to configure your git remote to GitHub?  [Use arrows to move, type to filter]
  Select an existing GitHub project
> Create a new private GitHub repository
  Enter a remote URL directly

  5. 新しいリポジトリの名前を入力します。

  6. ローカルの変更をコミットしてプッシュして新しい GitHub Actions の実行を開始するように求められたら、「 y」と入力します。

  7. ターミナルの出力を確認します。 azd pipeline config コマンドは、プロジェクトの GitHub リポジトリ名を表示します。

    Note

    既定では、azd pipeline config が OpenID Connect (OIDC)、フェデレーション資格情報とも呼ばれるものを構成します。 代わりにクライアント資格情報を使用するには、 azd pipeline config --auth-type client-credentialsを実行します。

    OIDC/フェデレーション資格情報は、Terraform ではサポート されていません 。

    azdでの OIDC サポートの詳細について説明します。

  8. ブラウザーで、プロジェクトの GitHub リポジトリを開きます。

  9. [アクション] を選択して、実行中のワークフローを表示します。

    実行中の GitHub ワークフローのスクリーンショット。

コードを変更してパイプラインをテストする

  1. プロジェクトの /src/components/pages ディレクトリで、 Home.razorを開きます。

  2. ファイルの上部付近にある Hello AZD! ヘッダー テキストを見つけます。

  3. テキストを Hello, pipeline! に変更します。

  4. ファイルを保存します。

  5. 変更をコミットしてプッシュする。 このアクションにより、GitHub Actions パイプラインがトリガーされ、更新プログラムがデプロイされます。

    テスト ファイルに変更を加えてコミットするために必要な手順のスクリーンショット。

  6. ブラウザーで、プロジェクトの GitHub リポジトリを開き、次の情報を表示します。

    • Your commit
    • GitHub Actions のセットアップからのコミット

    GitHub でのコミットされた変更のスクリーンショット。

  7. [ アクション] を選択すると、テストの更新がワークフローに反映されます。

    テストの更新後に実行されている GitHub ワークフローのスクリーンショット。

  8. デプロイされた更新プログラムを表示するには、 azd 出力で提供されている Web フロントエンド URL にアクセスします。

azdを GitHub アクションとして使用する

azdを使用して、を GitHub アクションとしてインストールできます。 これを使用するには、 .github/workflows/azure-dev.yml ファイルに次のコードを追加します。

on: [push]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Install azd
        uses: Azure/setup-azd@v1.0.0

Note

setup-azd リリースで最新バージョン番号を確認します。

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

この記事で作成した Azure リソースが不要になったら、次のコマンドを実行します。

azd down

このコマンドを実行すると、プロジェクトに関連付けられているすべての Azure リソースが削除されます。

Next steps

Azure Developer CLI (azd) を使用してアプリを監視する

  • Last updated on