次の方法で共有

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

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

Note

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

Prerequisites

  • Azure Developer CLI
  • Visual Studio Code (ファイルを編集する場合は省略可能)
  • GitHub アカウント
  • Azure サブスクリプション

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

この例では 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. リモート リポジトリの構成を求められたら、新しいプライベート 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 リポジトリを開き、次の情報を表示します。

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

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

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

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

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

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

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 releases で最新バージョン番号を確認します。

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

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

azd down

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

次のステップ

Azure Developer CLI (azd)

  • Last updated on