カスタム パイプライン ホストを使用してパイプラインを作成する
Power Platform 管理者は 1 つ以上のパイプラインを作成し、任意の数の環境を関連付けて、パイプラインを管理または実行する人々とアクセスを共有できます。
カスタム パイプライン ホストの前提条件
- 4 つの環境が推奨されますが、パイプラインを作成するには 3 つまで Power Platform 環境を使用できます。
- パイプラインで使用されるすべての環境には、Microsoft Dataverse データベースが必要です。
- パイプライン アプリケーションをインストールするには、Power Platform 管理者 または Dataverse システム管理者ロールが必要です。
- パイプラインで使用されるすべてのターゲット環境は、マネージド環境 として有効にする必要があります。
パイプラインの環境を作成または選択する
始める前に、パイプラインに参加する環境を特定する必要があります。 すべてのターゲット環境を マネージド環境 として有効にしてください。 マネージド環境は、パイプラインのホスト環境や開発環境には必要ありません。
環境 をホストします。 この専用環境は、すべてのパイプライン構成、セキュリティ、および実行履歴の ストレージ および管理プレーンとして機能します。
- この設定は、開発環境やターゲット環境とは別の 専用の実稼働環境 として保持することをお勧めします。
- 必要に応じて、異なるビジネス組織や地理的な場所のパイプラインを個別に管理する場合など、テナント内に複数の異なるホストを構成できます。 すべての環境が同じ地理的な場所にある限り、テナント全体に対して 1 つのホストも許容されます。
重要
ホスト環境を削除すると、すべてのパイプラインと実行データが削除されます。 データや設定の損失、環境にホストされているパイプラインへのメーカーアクセスの影響を理解した上で、慎重に使用してください。
開発 環境。 この環境はソリューションを開発する場所です。 パイプラインは、それにリンクされた任意の開発 環境 内から実行できます。
ターゲットは環境です。 パイプラインを展開する先の環境。 たとえば、統合テスト、ユーザー支援テスト (UAT)、実稼働などです。
チップ
目的を示す環境名を使用します。 たとえば、 Contoso ホスト、 Contoso 開発、 Contoso QA など。
パイプライン アプリケーションをホスト環境にインストールする
このステップは、最初のホストのセットアップにのみ必要です。 パイプラインを作成するホスト環境にすでにアクセスできる場合は、次のセクションに進んでください。
- Power Platform 管理センターにログインし、 環境>新規に移動して、Dataverse データベースのある新しい環境を作成します。 開発、QA、本番環境が作成されているのと同じリージョンを選択してください。
- ホスト環境に Power Platform パイプライン アプリケーションをインストールするには、ホスト環境を選択し、リソース>、Dynamics 365 アプリ を選択します。
- アプリのインストール を選択し、 Power Platform パイプラインが見つかるまで右側のパネル内を下にスクロールします。
- 次へを選択し、同意する場合は承諾を選択して、インストールを選択します。
重要
ホスト環境に展開パイプライン アプリケーションをインストールするだけで済みます。 パイプラインに関連付けられる開発、QA、または実稼働環境など、他の環境にインストールする必要はありません。
インストールすると、展開パイプライン構成アプリケーションが、インストールされているアプリのリストに表示されます。
展開パイプラインの構成
パイプラインにリンクされるすべての開発環境とターゲット マネージド環境 の環境 ID をコピーします。 これらの ID は後で必要になります。 詳細情報: 環境と組織の ID を検索する
展開パイプライン パッケージのインストールが完了したら、Power Apps に移動し、専用ホスト環境 (アプリケーションをインストールした場所) を選択します。
展開パイプライン 構成 アプリをプレイします。
左側のペインで、管理センター、新規 を選択し、Dataverse で環境のレコードを作成します:
- 名前: 環境 レコードの名前を入力します。 Contoso Dev など、実際の環境と同じ名前を含めることをお勧めします。
- 環境 タイプ: 選択 または 開発 環境 or Target環境。 アンマネージド ソリューションが開発されるすべてのソース環境に対して、開発環境 を選択します。 管理ソリューション アーティファクトがデプロイされる QA 環境および運用環境の ターゲット環境 を選択します。
- 環境Id: 必ず正しいIDを 選択 してください。 現在の環境の環境 ID は、make.powerapps.com 内で確認できます。 コマンド バーの 設定 アイコンを選択してから、開発者向けリソース を選択します。 詳細情報: 環境と組織の ID を検索する
保存 を選びます。
フォームを更新して、 検証ステータス が 成功 になっていることを確認します。
パイプラインに参加するすべての環境に環境レコードが作成されるまで、手順 4 ～ 6 を繰り返します。
左側のナビゲーション ペインで パイプライン を選択し、新規 を選択して新しい展開パイプラインを作成します:
- 名前: パイプラインの名前を入力します (例: Contoso Standard展開パイプライン または Contoso Hotfix Pipeline)。
- 説明: 必要に応じて、パイプラインのわかりやすい説明を入力します。
リンクされた開発環境 グリッド内で、 既存の開発環境を追加を選択し、1 つ以上の開発環境を関連付けます。 パイプラインを実行するには、少なくとも1つの開発 環境 と1つのステージが必要です。
展開ステージ グリッド内で、 新しい展開ステージを選択して、クイック作成ペインを表示します。
各ステージの詳細を入力し、保存して閉じるを選択します:
- 名前: ステージの名前。
- 説明 (オプション): ステージのオプションの説明。
- 前のデプロイメント ステージ (オプション): 現在のステージにデプロイする前にデプロイする必要があるデプロイメント ステージを指定します。 たとえば、本番ステージを作成するときに、テスト ステージを 前の展開ステージとして追加できます。 最初のステージ、または 1 つのステージのみを含むパイプラインの場合、このステージは空白のままにする必要があります。
- ターゲット デプロイメント 環境: これは、このステージがデプロイされるターゲット 環境 です。
- 事前デプロイメント 手順 必須 (オプション): デプロイメント要求は、カスタム ビジネス ロジックによって承認されるまで保留になります。 追加構成が必要です。 詳細: Power Platform でパイプラインを拡張する
パイプラインに追加するステージごとに、前の 2 つの手順を繰り返します。 少なくとも 1 つのステージが必要です。 最大 7 つのステージを追加できます。
パイプラインを編集または実行するためのアクセスを付与する
パイプライン セキュリティは、セキュリティ ロールを割り当てることによって、ホスト環境内で管理されます。 さらに、ユーザーは現在、パイプラインを作成または実行するために、パイプラインに関連付けられているすべての環境にアクセスできる必要があります。
Power Platform パイプライン アプリケーションをインストールすると、次の2つのセキュリティ ロールが追加されます。
- 展開パイプライン ユーザー: 共有されているパイプラインを実行する権限を持ちます。
- 展開パイプライン 管理者: システムの 管理者 セキュリティ ロール メンバーシップを必要とせずに、すべてのパイプライン構成を完全に制御できます。
パイプラインを作成者と共有する
展開パイプラインのユーザー セキュリティ ロール は、1つ以上のパイプラインを実行するためのアクセスを許可します。 パイプラインを作成、編集、削除するためのアクセス権は付与されません。 展開パイプライン ユーザー セキュリティ ロール を持つユーザーは、 Power Apps または Power Automateの 環境 ピッカー内でホスト 環境 を表示できないため、その点に注意する必要があります。
パイプラインを共有する方法:
- ホスト環境内で作成者に 展開パイプライン ユーザー セキュリティ ロール を割り当てます。 この セキュリティ ロールは、Power Platform パイプライン アプリケーションと共にインストールされます。 詳細: ユーザーにセキュリティ ロールを割り当てる
- 展開パイプライン構成アプリで、パイプライン レコードを作成者 (または Microsoft Entra グループ) と 共有 します。 開発 環境 内からパイプラインを表示および実行するには、読み取り 権限で十分です。 詳細情報: ユーザーまたはチームと行を共有する
- また、開発環境からソリューションをエクスポートする権限と、パイプラインの展開先であるテスト環境と本番環境にソリューションをインポートする権限も必要です。 既定では、システム カスタマイザーと環境作成者のロールにはこれらの権限があります。
パイプライン管理者と共有する
展開パイプラインの管理者セキュリティ ロール は、ホスト環境内のすべてのパイプライン (およびパイプライン情報を格納するテーブル) に完全な権限を付与します。 このロールは、現在のホストに関連付けられているすべてのパイプラインを実行するためのアクセス権も付与します。 展開パイプラインの管理者セキュリティ ロール は、ホスト環境内で他のアクティビティを実行する権限を付与しません。
重要
パイプライン管理者は、作成または実行するパイプラインに関連付けられているすべての開発、テスト、および実稼働環境にもアクセスできる必要があります。
ホスト環境内のユーザーまたは Microsoft Entra グループに、展開パイプライン管理者 のセキュリティロールを割り当てます。 このセキュリティ ロールは、Power Platform パイプライン アプリケーションと共にインストールされます。 詳細: ユーザーにセキュリティ ロールを割り当てる
展開パイプライン 構成アプリでセキュリティ チームを介してパイプライン ロールを割り当てる
展開パイプライン 管理者 のように、 展開パイプライン 構成 アプリですぐに使用できるPipelinesロールを簡単に割り当てることができます。
- 展開パイプライン 構成 アプリをプレイします。
- 選択 セキュリティ チーム は、左側のナビゲーション ペインの 設定 の下にあります。
チームは3つあります:
- 展開パイプライン 管理者。 これらのユーザーはすべてのパイプラインにフルアクセスでき、展開パイプライン 構成アプリを操作できます。
- 展開パイプライン メーカー。 これらのユーザーは、カスタム ホストで管理される個人用パイプラインを作成して使用できます。 作成者が共有パイプラインを使用する必要がある場合は、共有アーティファクトと共有ステージ実行にアクセスできるように、ユーザーに 展開パイプライン ユーザー ロールを割り当てることをお勧めします。
- 展開パイプライン ユーザー。 これらのユーザーは、共有されているパイプラインを トリガー できます。 展開パイプライン ユーザーには、同じビジネス ユニット内のすべてのデプロイメント ステージ実行に対する読み取りアクセス権もあります。
まだ関連付けられていない他の開発環境でパイプラインを使用する
ユーザーが特定のパイプラインに 書き込みアクセス権 を持っている場合、Pipelinesエクスペリエンスで他の開発環境をそのパイプラインに関連付けることができます。
ドロップダウン メニューから作成したパイプラインを選択します。 デプロイメント構成プロセスの最初の 手順 で 選択 次へ を実行すると、現在の 環境 が開発 環境 としてパイプライン (およびまだリンクされていない場合はホスト) にリンクされます。
これは、追加の開発 環境 に同じパイプライン プロセスがある場合に便利です。 たとえば、別のソース 環境 の場合、UAT環境と本番環境は同じです。 すでに作成したパイプラインや書き込みアクセス権が付与されているパイプラインを再利用できます。
展開を一元的に管理および監視する
パイプライン構成アプリとホスト環境には、次のような他の多くの利点があります:
- すべての展開アクティビティを一元的に表示します。 フィルター処理されたビューは、特定のパイプラインとソリューションの作成者エクスペリエンス内でもアクセスできます。
- 特定のソリューションのバージョンが展開されている場所と、誰が要求を開始したかを監査します。
- エラー ログ、検証結果、展開の設定を表示します。 環境変数と接続は、展開中に提供されます。
- バージョンごとにすべてのソリューション アーティファクトのバックアップを保持します。
- 一括削除ジョブをスケジュールして、不要なデータを削除し、データベース容量を節約します。 詳細情報: 大容量の特定の対象データを一括削除で削除する
- ダッシュボードを使用すると、展開のメトリックを視覚化できます。 ホスト内に保存されているデータを使用して独自のレポートを作成することもできます。
Power Apps から展開パイプラインの構成アプリにアクセスする
任意のソリューション内の パイプライン ページから、コマンド バーの パイプラインの管理 コマンドを使用して、現在の 環境 に関連付けられているパイプライン ホストの構成アプリに移動します。
- 現在の環境がカスタム パイプライン ホストに関連付けられている場合、ボタンは専用ホスト環境内の展開パイプライン構成アプリにリンクします。
- 現在の環境がプラットフォーム ホストに関連付けられている場合、ボタンは、Power Apps に組み込まれた展開パイプライン構成アプリにリンクします。
展開パイプライン 構成アプリには、カスタム ホストを使用している場合は 展開パイプライン 管理者 ロールを持つすべてのユーザーがアクセスできます。また、プラットフォーム ホストに関連付けられているアプリのテナント 管理者 もアクセスできます。
あるホストから環境の関連性を手動で解除し、別のホストに関連付ける
- Power Apps (make.powerapps.com) から、関連付けを解除したい環境で開始し、ソリューションを選択します。
- アクセスできるソリューションを選択し、そこを選択します。
- 左側のナビゲーション ペインから パイプライン ページを選択し、コマンドバーにある パイプラインの管理 を選択します。 カスタム ホストから始める場合は、専用ホスト環境に直接移動して、そこから 展開パイプラインの構成 アプリを実行します。
- これで、 展開パイプライン 構成 アプリに移動しました。左側のナビゲーション ペインから 環境 に移動します。
- デフォルトで表示される 追加された展開環境 テーブルで、このホストとの関連付けを解除する環境の環境レコードを選択します。
- フォームを選択し、コマンド バーで 削除 を選択して、削除を確認します。
- 削除された環境を新しいホストに関連付けるには、環境を関連付ける目的のホストのコンテキストで手順1 ～ 4を繰り返します。
- デフォルトで表示される 追加されたデプロイメント環境 テーブルで、コマンド バーに 選択 新規 が表示されます。
- 名前、タイプ、環境 ID、およびオプションの説明を割り当てて、環境レコードを作成します。
これで、新しいホストのパイプラインに環境をリンクできるようになりました。
強制リンクを使用して環境を新しいホストに関連付ける
展開パイプライン構成アプリで環境レコードを作成した後、「この環境は既に別のパイプライン ホストに関連付けられています」というエラー メッセージが表示される場合があります。関連付けを引き継いで、以前のホストの環境のリンクを解除し、新しいホストへのリンクを正常に確立するには、コマンド バーで 強制リンク を選択します。
重要
- 開発 (ソース) 環境でこのアクションを実行すると、メーカーは、その環境内でアクセス可能だった以前のホストのすべてのパイプラインにアクセスできなくなります。
- このアクションは、前のホストで 強制リンク を実行することで元に戻すことができます。
- 以前のホストの環境レコードは、更新されるまで古い検証ステータスになります。そのため、更新されない限り、成功 と表示されます。