概要

　業務でMicrosoft Power Platformを使用する機会があり、DevOpsのような開発フローを実現するために、アプリケーションライフサイクル管理(ALM)というドキュメントがあります。本記事では、ALMのデプロイ操作をGithub Actionsで実現します。

Power Platform

　Power Platformは、Microsoftが提供するローコード開発プラットフォームです。ローコードの製品として以下が存在します。

Power Apps
Power Automate
Power BI
Power Pages
Copilot Studio

これらの製品を使用することで、Web画面や自動化のパイプライン、可視化をプログラミング知識が乏しくても作成することができます。アプリケーションライフサイクルに関係があるのは、Power Apps、Power Automate、Microsoft Copilot Studioの3つです。

ALM

　ALMを実現するために、ソリューションという機能があります。ソリューションには１つのシステムを構成する Power Apps や Power Automate 、接続情報等の要素を含めてパッケージ化することができます。ALMでは環境を作成することができ、開発/テスト/運用の3種類の環境を作成することが推奨されています。ALMでは、ソリューションを各種環境にデプロイすることでDevOpsのような開発フローを実現しています。
　デプロイ操作はPower Platform側で提供される組み込みの機能や外部CI/CDサービスのGithub Actions, Azure DevOpsで実行することができます。今回業務では、ライセンスの問題で組み込みの機能が使用できなかったため、Github Actionsで実現することにしました。

Github Actions

作成したGithub Actionsのyamlを以下に提示します。

yaml

yaml deploy.yml

name: Deploy Power Platform Solution

on:
  workflow_dispatch:
    inputs:
      export_environment: 
        description: 'export environment'
        required: true
        type: environment
      import_environment: 
        description: 'import environment'
        required: true
        type: environment
  workflow_call:
    inputs:
      export_environment: 
        description: 'export environment'
        required: true
        type: string
      import_environment: 
        description: 'import environment'
        required: true
        type: string

permissions:
  id-token: write

jobs:
  export-solution:
    runs-on: ubuntu-latest
    environment: ${{ inputs.export_environment }}

    steps:
    - name: Install Power Platform Tools
      uses: microsoft/powerplatform-actions/actions-install@v1

    - name: who-am-i action
      uses: microsoft/powerplatform-actions/who-am-i@v1
      with:
        environment-url: ${{ vars.POWER_PLATFORM_ENVIRONMENT_URL }}
        app-id: ${{ vars.POWER_PLATFORM_AZURE_SERVICE_CLIENT_ID }}
        tenant-id: ${{ vars.POWER_PLATFORM_AZURE_TENANT_ID }}

    - name: Export Solution
      uses: microsoft/powerplatform-actions/export-solution@v1
      with:
        environment-url: ${{ vars.POWER_PLATFORM_ENVIRONMENT_URL }}
        app-id: ${{ vars.POWER_PLATFORM_AZURE_SERVICE_CLIENT_ID }}
        tenant-id: ${{ vars.POWER_PLATFORM_AZURE_TENANT_ID }}
        solution-name: ${{ vars.SOLUTION_NAME }}
        solution-output-file: ${{ vars.POWER_PLATFORM_SOLUTION_NAME }}.zip
    
    - name: Upload Github Artifact
      uses: actions/upload-artifact@v4
      with:
        name: ${{ vars.POWER_PLATFORM_SOLUTION_NAME }}_${{ github.run_id }}
        path: ${{ vars.POWER_PLATFORM_SOLUTION_NAME }}.zip
        overwrite: true

  import-solution:
    runs-on: ubuntu-latest
    needs: export-solution
    environment: ${{ inputs.import_environment }}

    steps:
    - name: Download Artifact
      uses: actions/download-artifact@v4
      with:
        name: ${{ vars.POWER_PLATFORM_SOLUTION_NAME }}_${{ github.run_id }}

    - name: Install Power Platform Tools
      uses: microsoft/powerplatform-actions/actions-install@v1

    - name: who-am-i action
      uses: microsoft/powerplatform-actions/who-am-i@v1
      with:
        environment-url: ${{ vars.POWER_PLATFORM_ENVIRONMENT_URL }}
        app-id: ${{ vars.POWER_PLATFORM_AZURE_SERVICE_CLIENT_ID }}
        tenant-id: ${{ vars.POWER_PLATFORM_AZURE_TENANT_ID }}
    
    - name: Import Solution
      uses: microsoft/powerplatform-actions/import-solution@v1
      with:
        environment-url: ${{ vars.POWER_PLATFORM_ENVIRONMENT_URL }}
        app-id: ${{ vars.POWER_PLATFORM_AZURE_SERVICE_CLIENT_ID }}
        tenant-id: ${{ vars.POWER_PLATFORM_AZURE_TENANT_ID }}
        solution-file: ${{ vars.POWER_PLATFORM_SOLUTION_NAME }}.zip
        publish-changes: true

Github Variables

名称	用途
`POWER_PLATFORM_AZURE_SERVICE_CLIENT_ID`	サービスプリンシパルのクライアントID
`POWER_PLATFORM_AZURE_TENANT_ID`	サービスプリンシパルのテナントID
`POWER_PLATFORM_ENVIRONMENT_URL`	環境URL
`POWER_PLATFORM_SOLUTION_NAME`	ソリューションの名称

yamlの特徴

Github Environmentの機能を使用し、ソリューションのエクスポート先/インポート先の環境を変数で分けています
- Github Artifactを使用して、ジョブ間でエクスポートされたzipファイルの受け渡しをしています
Github ActionsのOIDC
- https://github.com/microsoft/powerplatform-actions/discussions/576
- リポジトリのREADMEには整備されておらず、Discussionsの箇所に実現方法が記載されています
  - リポジトリが熱心に更新されているわけではないので、少々使用することに抵抗がある
筆者はこれをworkflow_callで呼び出し、ステージング環境/本番環境用のActionsを別途作成して、運用しています

まとめ

　本記事では、Microsoft Power PlatformのALMを実現するGithub Actionsのコードを提示しました。本コードは必要最低限なデプロイ機能しか持っていないので、ユースケースに合わせてアレンジしてください。一方で、Power Platform のGithub Actionsのリポジトリはあまり整備されていないようなので、使用するのに不安があります。もし、必要最低限なデプロイ機能で十分であればPower Platformの組み込みの機能を採用した方がお手軽です。