チュートリアル: Microsoft Power PlatformのGitHub Actionsを使用してソリューションのデプロイを自動化する

このチュートリアルでは、以下の内容を学習します。

  • 新しい GitHub リポジトリを作成
  • Microsoft Power PlatformのGitHub Actionsを使用して 2 つのGitHub ワークフローを作成する

ワークフローを使用して、開発環境からアプリを (アンマネージド ソリューションとして) 自動的にエクスポートし、ビルド アーティファクト (マネージド ソリューション) を生成し、アプリを運用環境にデプロイできます。 このチュートリアルでは、前回のチュートリアルで構築した ALMLab ソリューション と環境を使用します。

関連チュートリアル: はじめる、モデル駆動型アプリを構築する。

GitHub アカウントを作成する

  1. https://github.comに移動し、[サインアップ] または [無料試用版の開始] を選択します (または、既存のアカウントがある場合はサインインします)。

    アカウントを作成する

  2. アカウントを作成したら、[リポジトリの作成] または [新規] を選択してリポジトリを作成します。

    リポジトリを作成する

    次の別の起動画面が表示される場合があります。

    新しいレポジトリを作成する

  3. 新しいリポジトリを作成し、poweractionslab という名前を付けます。 README ファイルの追加 を必ず選択してリポジトリを初期化し、リポジトリの作成 を選択してください。

    リポジトリを初期化する。

サービス プリンシパル認証の新しいシークレットの作成

  1. リポジトリに移動し 、[設定] を選択します。 [ シークレット] を展開し、[アクション] を選択します。

  2. [シークレット] ページで、シークレットに PowerPlatformSPNという名前を付けます。 Microsoft Entraで作成したアプリケーション登録のクライアント シークレットを[値]フィールドに入力し、[シークレットの追加]を選択します。 このチュートリアルの後の方で、GitHubワークフローを定義するYMLファイル内でクライアントシークレットを参照します。

    サービス プリンシパル シークレットを作成する

    クライアント シークレットは GitHub シークレットとして安全に保存されるようになりました。

ソリューション ファイルをエクスポートして展開し、新しいブランチを作成するワークフロー

  1. [アクション] を選択し、次に [ワークフローを自分で設定する] を選択します。 または、このリポジトリ向けの推奨項目セクションにあるシンプルなワークフローボックスで、設定を選択します。

    ワークフローの設定。

  2. GitHubアクションの開始に役立つ基本的なワークフローを含む新しい YAML ファイルが表示されます。

    YML ファイルのサンプル

  3. 事前に作成したコンテンツを削除し、export-and-branch-solution-with-spn-auth.yml ファイルからコンテンツを貼り付けてください。 ファイルの名前を export-and-branch-solution.yml に変更します。

    名前を変更して内容を置き換える。

  4. <ENVIRONMENTURL> を、エクスポート元として使用する開発環境の URL に更新します(例えば: https://poweractionsdev.crm.dynamics.com)。

  5. <APPID> と <TENANT ID> をお使いの値で更新してください。

    • 資格情報を使用する場合は、export-and-branch-solution.yml ファイルの内容ではなく、export-and-branch-solution-with-spn-auth.yml ファイルの内容の代わりに貼り付けます。 <USERNAME> を、環境への接続に使用するユーザー名で更新します。

      コンテンツの名前変更と置換

    チップ

    GitHub Actionsに詳しくなく、さらに詳しく知りたい場合は、https://docs.github.com/en/actionsの公式ドキュメントを参照してください。

  6. これで、変更をコミットする準備ができました。 コミットを開始を選択して、タイトル フィールドでエクスポート yml を作成と入力し、説明 (オプション) を追加します。 次に、新しいファイルをコミットするを選択します。

    コミットを開始。

おめでとうございます。次のアクションを使用して、最初のGitHubワークフローを作成しました。

  • Who Am I: エクスポート元の環境に正常に接続できることを確認します。
  • ソリューションのエクスポート: 開発 環境 からソリューション ファイルをエクスポートします。
  • ソリューションの展開: サーバーがエクスポートするソリューション ファイルは、1 つにまとめられた構成ファイルを含む圧縮(zip)ファイルです。 これらの初期ファイルは、ソース コード管理システムがファイルの差分を適切に行い、ソース管理にコミットしたい変更を適切に記録できるようにするために構造化されていないため、ソース コード管理には適していません。 ソリューション ファイルをソース管理で保存および処理できるようにするには、アンパックする必要があります。
  • ブランチ ソリューション: エクスポートされたソリューションを保存するための新しいブランチを作成します。

エクスポートを確認し、ワークフローを展開します

  1. 次に、ワークフローが実行されることを確認します。 [アクション] に移動し、[ワークフローの実行] を選択し、[ワークフローの実行] を選択します。 ALMLabとは異なるソリューション名を使用する場合は、ここで値を変更しますが、他の値は同じのままにします。

    ワークフローを実行します。

  2. 5 ~ 10 秒後、ワークフローが開始されます。 実行中のワークフローを選択して進行状況を監視できます。

    クリックしてワークフローを表示します。

    ワークフローを選択して表示します。

  3. ワークフローが完了したら、ソリューションが solutions/ALMLab フォルダーにアンパックされた新しいブランチが作成されていることを確認します。 [コード] タブに移動し、[ブランチ] ドロップダウンを展開します。

  4. アクションが作成したブランチを選択します。

  5. solutions/ALMLab フォルダーが新しいブランチに作成されていることを確認します。 次に、変更をメイン ブランチにマージするためのプル リクエストを作成します。 共同作業 を選択し、フライアウトで プル リクエストを開く を選択します。

  6. [Pull request を開く] 画面で、必要に応じてタイトルと説明を追加し、[pull request の作成] を選択します。

  7. 画面が更新され、新しいプル リクエストが表示されます。 pull request を作成すると、ブランチがメイン ブランチと競合していないことが確認されます。 この確認は、変更をメインブランチに自動的にマージできることを意味します。 Pull request をマージ を選択し、次に マージを確認する を選択します。 必要に応じて、[ブランチを削除] を選択して、不要になったブランチを削除します。

    ブランチの表示

  8. デフォルト(メイン)ブランチに戻り、そこに解決策があることを確認します。

再利用可能なワークフローを作成して、ビルド成果物を生成し、本番環境に取り込みます

このセクションでは、次のことを行う追加のワークフローを1つ作成します。

  • 管理ソリューションを作成し、GitHub アーティファクトとして公開する
  • ビルド成果物を運用環境にインポートする
  1. [アクション] に移動し、[新しいワークフロー] を選択します。

    ワークフローを新規作成する。

  2. [自分でワークフローを設定する] を選択します。

    ワークフローを設定する。

  3. ワークフローのタイトルをrelease-solution-to-prod-with-inputsに変更します。 release-solution-to-prod-with-inputs.yml ファイルからコンテンツをコピーし、[新しいファイルの編集] 画面に貼り付けます。

    名前を変更してコードを貼り付けます。

  4. 変更をコミットしてください。 コミットを開始するを選択してからタイトルと説明を追加します (オプション)。 次に、Commit new file を選択します。

    変更をコミットします。

リリース イベントで再利用可能なワークフローを呼び出す

このセクションでは、release eventに対して再利用可能なワークフローを呼び出します。

  1. [操作] に移動し、[新規ワークフロー] を選択します。

    ワークフローを新規作成する。

  2. ワークフローを自分でセットアップするを選択します。

    ワークフローを設定する。

  3. ワークフローのタイトルをrelease-action-callに変更します。 release-action-call.yml ファイルからコンテンツをコピーし、新しいファイルの編集 画面に貼り付けます。

    コードを名前変更して貼り付ける。

  4. 新しいワークフロー ファイルで次の変数を更新してください。

    • マネージド ソリューションの生成に使用しているビルド環境の URL で <BUILD_ENVIRONMENT> を更新します。 たとえば: https://poweractionsbuild.crm.dynamics.com。
    • デプロイする運用環境の URL で <PROD_ENVIRONMENT> を更新します。 例: https://poweractionsprod.crm.dynamics.com。
    • このチュートリアルで前に作成した登録を選択して、<APP_ID>にあるアプリケーション (クライアント) ID でを更新します。
    • このチュートリアルで先ほど作成した登録を選択して、<TENANT_ID>にあるディレクトリ (テナント) ID で を更新します。
  5. 変更をコミットする。 コミットを開始するを選択してからタイトル (オプション) と説明 (オプション) を追加します。 次に、新しいファイルをコミットするを選択します。

    変更をコミットします。

本番環境へのリリース ワークフローをテストする

これで、最後のワークフローをテストする準備ができました。 このワークフローは、新しいリリースが本番環境にデプロイされるとトリガーされます。

  1. リリース に移動します。

    リリースへ移動。

  2. 新しいリリースの下書き を選択します。

  3. リリース タグとタイトルを追加して、リリースを公開するを選択します。

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

    選択するとワークフローが表示されます。

  5. 実行中のワークフローを選択すると、実行中のアクションを表示できます。

    ワークフローを表示。

  6. 各アクションの完了を待機します。

    ブランチを表示

  7. ワークフローが完了したら、運用環境にサインインし、ソリューションがマネージド ソリューションとしてデプロイされていることを検証します。

更新をデプロイし、本番リリース前に変更を確認してください

エンドツーエンドのプロセスをテストし、その後、運用環境にデプロイする前にアプリへの変更を表示して検証する方法を確認します。

  1. 開発環境で ALMLab ソリューションを開き、編集 を選択するか、ソリューションの表示名を選択します。

    ソリューションを編集する。

  2. 休暇申請テーブルを選択し、表示します。

    テーブルを表示。

  3. + 列の追加 を選択し、次の図に示すように新しい列を作成します。

    列を追加します。

    更新されたフィールド値:**

    • 表示名: 承認済み
    • データ型: はい/いいえ
  4. 完了 を選択します。

  5. テーブルの保存を選択します。 列を追加。

  6. GitHub リポジトリの [アクション] タブに戻り、[ワークフローの実行] を選択して、[ワークフローの実行] ボタンを選択します。

    ワークフローを実行する

  7. 5 ~ 10 秒後、ワークフローが開始されます。 実行中のワークフローを選択して、進行状況を監視します。

    ワークフローを選択する。

    ワークフローを表示します。

  8. ワークフローの完了後、コード を選択し、次に ブランチ を選択して、新しいブランチに移動します。

    ブランチに移動する。

  9. [ contribute ] を展開して [ pull request を開く ] を選択し、作成したブランチを選択します。

  10. タイトル (省略可能) を追加し、プル リクエストの作成 を選択します。

  11. コンテンツが更新されたら、変更されたファイル タブを選択します。

  12. ソリューションへの変更が緑色で強調表示されているのは、メイン ブランチにある同じファイルと比較したときに、ファイルのこのセクションが追加されたことを示しています。

  13. 会話 タブに戻ります。プル リクエスト を選択し、前に作成したプル リクエストを選択します。

  14. Pull request ページで、スカッシュしてマージ を選択して、更新されたソリューション ファイルをメイン ブランチにマージします。 必要に応じて、メインにマージされたそれを削除します。

    新しいブランチのプル リクエストを開き、変更を表示して既定のブランチにマージする

  15. 「 実稼働ワークフローへのリリースをテストする 」セクションの手順に従って、新しいリリースを作成し、更新されたソリューションが運用環境にデプロイされていることを確認します。

おめでとうございます。これで、GitHub Actionsを使用してサンプル CI/CD ワークフローを正常に設定できました。

関連情報

アイデアから本番まで、ワークフローを自動化