カスタム パイプライン ホストを使用してパイプラインを作成する
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 など、実際の環境と同じ名前を含めることをお勧めします。
- 環境タイプ: 開発環境 または ターゲット環境 のいずれかを選択します。 アンマネージド ソリューションが開発されるすべてのソース環境に対して、開発環境 を選択します。 管理ソリューション アーティファクトがデプロイされる QA 環境および運用環境の ターゲット環境 を選択します。
- 環境 Id: 正しい ID を選択してください。 現在の環境の環境 ID は、make.powerapps.com 内で確認できます。 コマンド バーの 設定 アイコンを選択してから、開発者向けリソース を選択します。 詳細情報: 環境と組織の ID を検索する
保存 を選びます。
フォームを更新して、 検証ステータス が 成功 になっていることを確認します。
パイプラインに参加するすべての環境に環境レコードが作成されるまで、手順 4 ~ 6 を繰り返します。
左側のナビゲーション ペインで パイプライン を選択し、新規 を選択して新しい展開パイプラインを作成します:
- 名前: Contoso 標準展開パイプライン または Contoso ホットフィックス パイプライン など、パイプラインの名前を入力します。
-
説明: オプションで、パイプラインの意味のある説明を入力します。
リンクされた開発環境 グリッド内で、 既存の開発環境を追加を選択し、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 パイプライン アプリケーションと共にインストールされます。 詳細: ユーザーにセキュリティ ロールを割り当てる
展開パイプライン構成アプリでのセキュリティ チームを介したパイプライン ロールの割り当て
展開パイプラインの管理者は、展開パイプラインの構成アプリで既成のパイプラインの役割を簡単に割り当てることができます。
- 展開パイプラインの構成アプリを実行します。
- 左側のナビゲーション ペインで設定の下にあるセキュリティ チームを選択します。
3 つのチームがあります:
- 展開パイプライン管理者。 これらのユーザーは、すべてのパイプラインへのフル アクセスを持ち、展開パイプライン構成アプリを操作できます。
- 展開パイプライン作成者。 これらのユーザーは、カスタム ホストで管理される個人用パイプラインを作成して使用できます。 作成者が共有パイプラインを使用する必要がある場合は、共有アーティファクトと共有ステージ実行にアクセスする展開パイプライン ユーザーのロールをユーザーに割り当てておくことをお勧めします。
- 展開パイプライン ユーザー。 これらのユーザーは、共有されているパイプラインをトリガーできます。 展開パイプライン ユーザーは、同じ部署内のすべての展開ステージの実行に対する読み取りアクセス権も持っています。
まだ関連付けられていない他の開発環境でパイプラインを使用する
ユーザーが特定のパイプラインに対する 書き込みアクセス を持っている場合、パイプライン エクスペリエンスで他の開発環境をそのパイプラインに関連付けることができます。
ドロップダウン メニューから作成したパイプラインを選択します。 展開構成プロセスの最初のステップで 次へ を選択すると、現在の環境が開発環境としてパイプライン (およびまだない場合はホスト) にリンクされます。
これは、追加の開発環境に同じパイプライン プロセスがある場合に便利です。 たとえば、UAT 環境と運用環境が別のソース環境で同じであるとします。 既に作成したパイプライン、または書き込みアクセス権を付与されたパイプラインを再利用できます。
展開を一元的に管理および監視する
パイプライン構成アプリとホスト環境には、次のような他の多くの利点があります:
- すべての展開アクティビティを一元的に表示します。 フィルター処理されたビューは、特定のパイプラインとソリューションの作成者エクスペリエンス内でもアクセスできます。
- 特定のソリューションのバージョンが展開されている場所と、誰が要求を開始したかを監査します。
- エラー ログ、検証結果、展開の設定を表示します。 環境変数と接続は、展開中に提供されます。
- バージョンごとにすべてのソリューション アーティファクトのバックアップを保持します。
- 一括削除ジョブをスケジュールして、不要なデータを削除し、データベース容量を節約します。 詳細情報: 大容量の特定の対象データを一括削除で削除する
- ダッシュボードを使用すると、展開のメトリックを視覚化できます。 ホスト内に保存されているデータを使用して独自のレポートを作成することもできます。
Power Apps から展開パイプラインの構成アプリにアクセスする
任意のソリューション内のパイプライン ページで、コマンド バーのパイプラインの管理コマンドをクリックすると、現在の環境に関連付けられているパイプライン ホストの構成アプリに移動します。
- 現在の環境がカスタム パイプライン ホストに関連付けられている場合、ボタンは専用ホスト環境内の展開パイプライン構成アプリにリンクします。
- 現在の環境がプラットフォーム ホストに関連付けられている場合、ボタンは、Power Apps に組み込まれた展開パイプライン構成アプリにリンクします。
展開パイプライン構成アプリには、カスタム ホストを使用している場合は展開パイプライン 管理者 ロールを持つユーザー、プラットフォーム ホストに関連付けられたアプリのテナント 管理者 を持つユーザーは誰でもアクセスできます。
あるホストから環境の関連性を手動で解除し、別のホストに関連付ける
- Power Apps (make.powerapps.com) から、関連付けを解除したい環境で開始し、ソリューションを選択します。
- アクセスできるソリューションを選択し、そこを選択します。
- 左側のナビゲーション ペインから パイプライン ページを選択し、コマンドバーにある パイプラインの管理 を選択します。 カスタム ホストから始める場合は、専用ホスト環境に直接移動して、そこから 展開パイプラインの構成 アプリを実行します。
- 展開パイプラインの構成 アプリが表示されたので、左側のナビゲーション ウィンドウから 環境 に移動します。
- デフォルトで表示される 追加された展開環境 テーブルで、このホストとの関連付けを解除する環境の環境レコードを選択します。
- フォームを選択し、コマンド バーで 削除 を選択して、削除を確認します。
- 削除された環境を新しいホストに関連付けるには、環境を関連付ける目的のホストのコンテキスト内で手順 1 ~ 4 を繰り返します。
- 既定で表示される 追加された展開環境 テーブルで、コマンド バーの 新規 を選択します。
- 名前、タイプ、環境 ID、およびオプションの説明を割り当てて、環境レコードを作成します。
これで、新しいホストのパイプラインに環境をリンクできるようになりました。
強制リンクを使用して環境を新しいホストに関連付ける
展開パイプライン構成アプリで環境レコードを作成した後、「この環境は既に別のパイプライン ホストに関連付けられています」というエラー メッセージが表示される場合があります。関連付けを引き継いで、以前のホストの環境のリンクを解除し、新しいホストへのリンクを正常に確立するには、コマンド バーで 強制リンク を選択します。
重要
- 開発 (ソース) 環境でこのアクションを実行すると、メーカーは、その環境内でアクセス可能だった以前のホストのすべてのパイプラインにアクセスできなくなります。
- このアクションは、前のホストで 強制リンク を実行することで元に戻すことができます。
- 以前のホストの環境レコードは、更新されるまで古い検証ステータスになります。そのため、更新されない限り、成功 と表示されます。