次の方法で共有

Azure Pipelines を使用した資産のデプロイ

  • [アーティクル]

Microsoft Azure DevOps の Dynamics Lifecycle Services アセット配置 タスクを使用して、Microsoft Dynamics Lifecycle Services のアセット ライブラリに保存されているアセットの特定の環境への配置を自動化します。 ただし、このタスクには、次のような考慮すべき制限があります。

  • このタスクは、リリース パイプラインでのみ使用できます。
  • ソフトウェア配置可能パッケージの運用環境への配置を自動化することはできません。
  • ソフトウェア配置可能パッケージをビルド環境に配置することはできません。
  • Commerce Cloud Scale Unit (CSU) 拡張機能パッケージ、および eコマース パッケージは、オンプレミスのローカル ビジネス データ環境には展開できません。

メモ

Commerce Cloud Scale Unit (CSU) 拡張機能または eコマース パッケージは、Dynamics Lifecycle Services アセット配置 を使用して、運用、UAT、またはサンドボックス環境に展開できます。

この記事は、Azure Pipelines の実用的な知識があることを前提としています。

注意

これらのステップをパイプラインに追加する前に、Azure DevOps の Dynamics 365 Finance and Operations Tools 拡張機能が有効になっていて、Azure DevOps 組織にインストールされている必要があります。 組織に拡張機能をインストールする方法の詳細については、拡張機能のインストールを参照してください。

注意

Azure DevOps パイプラインは、対応するDynamics Lifecycle Services プロジェクトで 環境マネージャーロール を持つユーザーが実行する必要があります。

メモ

バージョン 3.* およびそれ以下のタスクは廃止されました。 タスクのバージョンを使用可能な最新バージョンに更新します。

Dynamics 365 for Finance + Operations (on-premises) パッケージ展開

Dynamics 365 Finance and Operations Tools 拡張機能のバージョン 0.2.1239020 から、オンプレミスのローカル ビジネス データ環境にパッケージを展開することが可能になりました。 少なくとも Dynamics Lifecycle Services アセット配置 タスクのバージョン 3.* を使用する必要があります。 資産のタイプ フィールドで オンプレミス環境のソフトウェア配置可能パッケージ を選択できます。

メモ

パイプライン全体の実行には 1 時間を超える時間がかかるので、Microsoft がホストしている無料のエージェントはタイムアウトするため使用しないでください。

Dynamics 365 Commerce Cloud Scale Unit (CSU) 拡張機能および eコマース パッケージの展開

バージョン 3.* から、Dynamics Lifecycle Services アセット配置 タスクが Commerce パッケージの展開に対応しています。 コマース パッケージ配置タイプを選択するために、資産のタイプ という新しいフィールド タイプが追加されました。 以下の値は、このフィールドで使用できます:

  • ソフトウェア配置可能パッケージ - 財務と運用の環境配置 (既定値)
  • Commerce Cloud Scale Unit 拡張機能 - CSU 拡張機能パッケージの展開
  • eコマース パッケージ - eコマース環境の配置

Commerce Cloud Scale Unit 拡張機能 - CSU 拡張機能パッケージの展開 または eコマース パッケージ - eコマース環境の配置 オプションのいずれかを選択すると、以前の展開より優先されます。 複数の CSU 拡張機能パッケージがある場合は、すべての CSU パッケージを展開用の 1 つのパッケージとしてマージする必要があります。

メモ

(バージョン 4.* 以降では必要ありません。) 展開タスクのバージョン 2.* と 3.* には、MSAL.PS PowerShell ライブラリが必要です。 タスクは、パイプラインの実行中にツールを自動的にインストールするために使用できます。 このタスクは、配置タスクの前にステージの任意の場所に追加できます。 詳細については、MSAL.PS インストール タスクをパイプラインに追加 を参照してください。

パイプラインへのタスクの追加

YML または Classic パイプラインのビルドにタスクを追加するには、Dynamics Lifecycle Services アセット配置 のタスク リストを検索します。 ターゲット環境にセルフサービス環境が含まれている場合は、必ずタスク バージョン 4.* 以降を選択してください。

次のテーブルに、このタスクで使用可能なオプションを示します。

入力名 必須 内容
Lifecycle Services 接続 はい Dynamics Lifecycle Services へのサービス接続を選択または作成します。 詳細については、Azure パイプラインで Dynamics Lifecycle Services 接続を作成する を参照してください。
Lifecycle Services プロジェクト ID はい 配置する資産およびターゲット環境の両方を含むプロジェクトの ID を Dynamics Lifecycle Services に入力します。 プロジェクト ID は、プロジェクトのダッシュボードの URL の末尾に記載できます。
Lifecycle Services 環境 ID はい ターゲット環境の ID を入力します。 環境 ID はグローバル一意識別子 (GUID) であり、環境詳細ページの環境詳細>環境 ID で検索できます。
Lifecycle Services ファイル アセット ID はい 配置するソフトウェア配置可能なパッケージの資産 ID を入力します。 資産 ID は、資産ライブラリで検索できる GUID です。 配置する資産の行を選択し、追加の詳細の下の資産 ID フィールドを検索します。 通常、この ID は、Dynamics Lifecycle Services 資産アップロード タスクなどの他のパイプライン ステップから動的に取得されます。
資産 タイプ はい Dynamics Lifecycle Services で環境に展開する資産のタイプを選択します。 オプションは、ソフトウェア配置可能パッケージ - 財務と運用環境の配置、オンプレミス環境のソフトウェア配置可能パッケージ - Finance + Operations (on-premises) 環境の配置、Commerce Cloud Scale Unit 拡張機能 - CSU 拡張パッケージの配置、および eコマース パッケージ - eコマース環境の配置 があります。
Commerce Cloud Scale Unit 名 いいえ Commerce Cloud Scale Unit 環境の名前を入力すると、環境機能>コマース>管理>コマースの展開と設定> Commerce scale units の下で、環境詳細ページに環境名が表示されます。 パッケージ タイプが Commerce Cloud Scale Unit 拡張機能 として選択されると、フィールド Commerce Cloud Scale Unit 名 の値は必須になります。
eコマース環境名 いいえ eコマース環境の名前を入力すると、環境名は、環境機能>コマース>管理>コマースの展開と設定>eコマース の下にある環境の詳細ページで環境名を見つけることができます。パッケージ タイプが eコマース パッケージ として選択されている場合、フィールド eコマース環境名 の値が必須になります。
更新プログラムの名前 はい Dynamics Lifecycle Services の環境履歴に表示される更新プログラムの名前を入力します。
完了まで待機する 清算済 (いいえ) このチェック ボックスを使用して、アセットの配置が成功または失敗するまで待機するようタスクに指示します。 清算済 (いいえ) の場合、タスクは配置のみを開始します。 タスクが待機するように指示されている場合、実行時間の長い配置中にパイプラインのタイムアウトが発生することがあります。 タイムアウト オプションの詳細については、タイムアウト を参照してください。

メモ

Lifecycle Services ファイル アセット ID は、Dynamics Lifecycle Services アセット アップロード タスクから出力変数を使用して動的に取得できます。 Lifecycle Services ファイル アセット ID を取得するには、FileAssetId を使用します。 例: $(<VARIABLENAME>.FileAssetId)。 詳細については、タスクからの出力変数を使用する を参照してください。