次の方法で共有


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

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

Note

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

Prerequisites

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

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

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

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

    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

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

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

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

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

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

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

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

  1. プロジェクトの ディレクトリで、 を開きます。

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

  3. テキストを に変更します。

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

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

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

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

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

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

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

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

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

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

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

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)