Microsoft Power Platformビルド ツールを使用して、Microsoft Power Platform上に構築されたアプリに関連する一般的なビルドタスクとデプロイ タスクを自動化します。 これらのタスクには以下の内容が含まれます。
- 次のようなさまざまなプラットフォーム コンポーネントを含むソリューション メタデータ (ソリューションとも呼ばれます) を同期します。
- 顧客エンゲージメント アプリ: Dynamics 365 Sales、カスタマー サービス、フィールド サービス、マーケティング、Project Service Automation
- キャンバス アプリ
- モデル駆動型アプリ
- UI flows
- 仮想オペレーター
- AI Builder モデル
- 開発環境とソース管理間のコネクタ
- ビルド アーティファクトを生成する
- ダウンストリーム環境への展開
- 環境のプロビジョニング、またはプロビジョニング解除
- Power Apps チェッカー サービスを使用したソリューションに対する静的分析チェックの実行
Microsoft Power Platform ビルド ツール タスクを他の使用可能なAzure DevOps タスクと共に利用し、ビルド パイプラインとリリース パイプラインを構成します。 一般的にチームが導入するパイプラインには、開始、開発からのエクスポート、ビルド、リリースがあります。
注意
Microsoft Power Platform ビルド ツールは、データベースを使用するMicrosoft Dataverse環境でのみサポートされます。 詳細情報: データベースのある環境の作成
Microsoft Power Platformビルド ツールは、GCC および GCC High リージョンで使用できるようになりました。
Microsoft Power Platform ビルド ツールとは
Microsoft Power Platform ビルド ツールは、Power Platform 固有のAzure DevOps ビルド タスクのコレクションであり、カスタム ツールとスクリプトを手動でダウンロードして、Microsoft Power Platform上に構築されたアプリのアプリケーション ライフサイクルを管理する必要がなくなります。
このタスクは、ダウンストリーム環境へのソリューション インポートなどの実行に個別使用することもできますが、パイプラインで一緒に使用して、環境構築アーティファクトの生成 や テストの展開、作成者変更の取り込み などのシナリオを調整することもできます。 構築タスクは大きく分けて以下の4つの種類に分類できます:
- ヘルパー
- 品質のチェック
- ソリューション
- 環境管理
使用可能なタスクの詳細については、「Microsoft Power Platform Build Tools タスク」を参照してください。
Power Platform ビルド ツール バージョン 2.0 とは?
Power Platform ビルド ツールが提供する者に加えて、Power Platform ビルド ツールのバージョン 2.0 は Power Platform CLI ベースです。
Power Platform ビルド ツール バージョン 1.0 は PowerShell に基づいています。 Power Platform ビルド ツール 2.0 は、サービスが提供され、新しい機能が追加されるバージョンです。
Power Platform ビルド ツールの以前のバージョンについては、必要に応じて重要なセキュリティ更新が行われます。 Power Platform ビルド ツール バージョン 2.0 へとできるだけ早く移行することを強くお勧めします。
重要
自分のパイプラインで Power Platform ビルド ツールのタスク バージョンを混在させることはできません。
Microsoft Power Platform ビルドツールを取得する
Microsoft Power Platformビルド ツールは、Azure Marketplace からAzure DevOps組織にインストールできます。
インストール後、Microsoft Power Platform ビルド ツールに含まれるすべてのタスクを、新規または既存のパイプラインに追加できるようになります。 "Power Platform" を検索すると、これらを見つけることができます。
環境への接続
Microsoft Power Platform環境と対話するには、ビルド ツール タスクが必要なアクションを実行できるように接続を確立する必要があります。 接続の種類には次の 2 種類があります。
| 接続の種類 | 説明 |
|---|---|
| Workload Identity Federation経由のサービス プリンシパル (推奨) | フェデレーション資格情報を介してサービス プリンシパル ベースの認証を使用します。 多要素認証を必要とするテナントに推奨されます。 |
| サービスプリンシパルとクライアントシークレット | サービス プリンシパル ベースの認証を使用します。 |
| ユーザー名/パスワード | ユーザー名とパスワードを使用した汎用サービス接続。 多要素認証を必要とするユーザーはサポートされません。 |
サービス プリンシパルを使用してサービス接続を構成する
サービス プリンシパルを使用して接続を構成するには、まず Power Platform プロファイルを必要なアクセス許可で認証する必要があります。 dataverse 環境に、Microsoft Entra ID アプリケーションと関連付けられているアプリケーション ユーザーを追加する必要があります。
サービス プリンシパルとクライアント シークレットの作成
pac admin create-service-principal コマンドを使用して、Microsoft Power Platform Build Tools タスクで使用するサービス プリンシパルを作成および構成します。
このコマンドは、最初にアプリケーション オブジェクトと対応するサービス プリンシパル名 (SPN) をMicrosoft Entra IDに登録します。 次に、アプリケーションを管理者ユーザーとしてMicrosoft Power Platform テナントに追加します。
このコマンドには、2 つのパラメーターがあります。
| 名称 | 短い名前 | 必須 | 説明 |
|---|---|---|---|
environment |
env |
Yes | アプリケーション ユーザーを追加する環境の ID または URL。 |
role |
r |
いいえ | アプリケーション ユーザーに適用するセキュリティ ロールの名前または ID。 既定値は "システム管理者" です。
ソリューション チェッカーでは、msdyn_analysisjobテーブルに追加するために、prvAppendmsdyn_analysisjob権限を持つロールが必要です。 既定では、システム管理者ロールにはこの権限が含まれています。 |
以下のように使用できます。
C:\> pac admin create-service-principal --environment <environment id>
成功すると、次の 4 つの列が表示されます。
- Power Platform テナントID
- アプリケーション識別子
- クライアント シークレット (クリアテキスト)
- 有効期限
例:
PS C:\>pac admin create-service-principal --environment d3fcc479-0122-e7af-9965-bde57f69ee1d
Connected as admin@M365x57236726.onmicrosoft.com
Successfully assigned user adde6d52-9582-4932-a43a-beca5d182301 to environment d3fcc479-0122-e7af-9965-bde57f69eeld with security role System Administrator
Tenant ID Application ID Client Secret Expiration
2b0463ed-efd7-419d-927d-a9dca49d899c adde6d52-9582-4932-a43a-beca5d182301 beY8Q~JBZ~CBDgIKKBjbZ3g6BofKzoZkYj23Hbf 7/31/2024 4:27:03 PM
表示された情報を使用して、Power Platform サービス接続を構成します。
重要
クライアントシークレットを安全に保護します。 コマンド プロンプトが一度クリアされると、同じクライアント シークレットを再度取得できません。
アプリケーション ID を使用して環境を構成する
接続するMicrosoft Power Platform環境で、アプリケーション ID をアプリケーション ユーザーとして追加する必要があります。 これを行う方法は 2 つあります。
- 記事 アプリケーション ユーザーの作成 を参照する。
- Power Platform CLI を使用する。 例:
PS C:\>pac admin assign-user --user "adde6d52-9582-4932-a43a-beca5d182301" --role "System administrator" --environment d3fcc479-0122-e7af-9965-bde57f69ee1d --application-user
Connected to... SnDemoDev
Connected as admin@M365x57236726.onmicrosoft.com
Successfully assigned user adde6d52-9582-4932-a43a-beca5d182301 to environment d3fcc479-0122-e7af-9965-bde57f69ee1d with security role System Administrator
追加したアプリケーション ユーザーにシステム管理者ロールが割り当てられていることを確認します (アプリケーション ユーザーのセキュリティ設定の [ロールの管理] から利用可能)。
よく寄せられる質問 (FAQ)
古い Microsoft Power Platform ビルド ツール パイプラインは引き続き動作しますか?
古いパイプラインは引き続き動作しますが、新しい機能は古いタスクに追加されません。 新しい機能を試してみたい場合は、パイプラインのタスクのバージョンを変更することを強くお勧めします。
新しい タスク をPowerShellではなく Power Platform CLIに基づいて作成したのはなぜですか?
Power Platform CLI タスクは、Linux ランナーでの動作も含め、柔軟性の高いマルチプラットフォームです。 これらは、power Platform Actions for GitHub で使用できるタスクと同じです。 これで、Azure DevOpsとGitHubの間で一貫したエクスペリエンスが得られます。
ビルド ツールは、キャンバスとモデル駆動型の両方のアプリ (仮想エージェント、UI フロー、従来のフロー Microsoft Copilot Studio)、AI Builder、カスタム コネクタ、データフローの両方で機能します。これらはすべてソリューションに追加できるようになりました。 この一覧には、顧客エンゲージメント アプリ (Dynamics 365 Sales、カスタマー サービス、フィールド サービス、マーケティング、Project Service Automation) も含まれます。 財務と運用アプリでは、個別のビルド タスクを使用できます。
一般提供リリースでは破壊的変更を導入する必要があるため、プレビュー バージョンからアップグレードすることはできません。 プレビュー バージョンから移行するには、Microsoft Power Platformビルド ツールをインストールし、パイプラインを再構築するか、新しいビルド ツール タスクを使用するように既存のパイプラインを再構成する必要があります。 また、新しいサービス接続も作成する必要があります。
フロー アプリやキャンバス アプリを含めることができますか?
はい、フローとキャンバス アプリはソリューションに対応しているため、これらのコンポーネントをソリューションに追加すると、アプリのライフサイクルに参加できます。 ただし、一部の手順では手動構成が必要です。 手動設定の必要性については、今年後半に環境変数とコネクターを導入する際に対応する予定です。 現在の制限事項の一覧については、既知の制限 をご覧ください。
Microsoft Power Platform ビルド ツールはどのくらいの費用がかかりますか?
ビルド ツールは無償で提供されます。 ただし、ビルド ツールを利用するには、Azure DevOpsの有効なサブスクリプションが必要です。 詳細については、pricing for Azure DevOps を参照してください。
拡張機能は表示されますが、インストールするオプションがないのはなぜですか?
install オプションが表示されない場合は、Azure DevOps組織で必要なインストール特権が不足している可能性が最も高くなります。 詳細については、拡張機能のアクセス許可の管理 を参照してください。
開発者はCheckerタスク の結果をどのように活用できますか?
チェッカー タスクの出力は Sarif ファイルで、VS Code と Visual Studio の両方の拡張子を使用して Sarif ファイルの表示とアクションを実行できます
参照
Power Platform Build Tools for Azure DevOps リリース ノート
ビルドツールタスク
Microsoft Power Platform Build Tools labs