Azure Pipelines を使用した資産のデプロイ
Microsoft Azure DevOps の Dynamics Lifecycle Services (LCS) 資産の配置 タスクを使用して、Microsoft Dynamics Lifecycle Services の資産ライブラリに保存されている資産の配置を特定の環境に自動的に配置できます。 ただし、このタスクには、次のような考慮すべき制限があります。
- このタスクは、リリース パイプラインでのみ使用できます。
- ソフトウェア配置可能パッケージの運用環境への配置を自動化することはできません。
- ソフトウェア配置可能パッケージをビルド環境に配置することはできません。
- Commerce Cloud Scale Unit (CSU) 拡張機能パッケージ、および eコマース パッケージは、オンプレミスのローカル ビジネス データ環境には展開できません。
注意
Commerce Cloud Scale Unit (CSU) 拡張機能または電子商取引パッケージは、Dynamics Lifecycle Services 資産の配置 を使用して、運用、UAT、またはサンドボックス環境に展開できます
この記事は、Azure Pipelines の実用的な知識があることを前提としています。
注意
これらのステップをパイプラインに追加する前に、Azure DevOps の Dynamics 365 Finance and Operations Tools 拡張機能が有効になっていて、Azure DevOps アカウントにインストールされている必要があります。 組織に拡張機能をインストールする方法の詳細については、拡張機能のインストールを参照してください。
注意
Azure DevOps パイプラインは、対応するDynamics Lifecycle Services プロジェクトで 環境マネージャーロール を持つユーザーが実行する必要があります。
Dynamics 365 for Finance + Operations (on-premises) パッケージ展開
Dynamics 365 Finance and Operations Tools 拡張のバージョン 0.2.1239020 から、オンプレミスのローカル ビジネス データ環境にパッケージを展開することが可能になりました。 少なくとも Dynamics Lifecycle Services (LCS) アセット配置タスクのバージョン 3.* を使用する必要があります。 その後、資産のタイプ フィールドでオンプレミス環境のソフトウェア配置可能パッケージを選択できます。
注意
パイプラインの実行全体には 1 時間以上かかるので、Microsoft がホストしている無料のエージェントはタイムアウトになりますので使用すべきではありません。
Dynamics 365 Commerce Cloud Scale Unit (CSU) 拡張機能および eコマース パッケージの展開
バージョン 3.* から、Dynamics Lifecycle Services (LCS) アセット配置タスクがコマース パッケージの展開に対応しています。 コマース パッケージの配置タイプを選択するために、資産のタイプという新しいフィールド タイプが追加されました。 以下の値は、このフィールドで使用できます:
- ソフトウェア配置可能パッケージ - 財務と運用の環境配置 (既定値)
- Commerce Cloud Scale Unit 拡張機能 - CSU 拡張機能パッケージの展開
- eコマース パッケージ - eコマース環境の配置
Commerce Cloud Scale Unit 拡張機能n - CSU 拡張機能パッケージまたは eコマース パッケージ - eコマース環境の配置オプションのいずれかを選択すると、以前の展開より優先されます。 複数の CSU 拡張機能パッケージがある場合は、すべての CSU パッケージを配置用の 1 つのパッケージとしてマージする必要があります。
MSAL.PS がインストールされていることを確認する
配置タスクのバージョン 2.* 以降では、MSAL.PS PowerShell ライブラリが使用可能である必要があります。 タスクは、パイプラインの実行中にツールを自動的にインストールするために使用できます。 このタスクは、配置タスクの前にステージの任意の場所に追加できます。 詳細については、MSAL.PS インストール タスクをパイプラインに追加 を参照してください。
パイプラインへのタスクの追加
YML または Classic パイプラインのビルドにタスクを追加するには、Dynamics Lifecycle Services (LCS) アセット配置 のタスク リストを検索します。 ターゲット環境にセルフサービス環境が含まれている場合は、必ずタスク バージョン 1.* 以降を選択してください。
次のテーブルに、このタスクで使用可能なオプションを示します。
入力名 | 必須 | 説明 |
---|---|---|
LCS 接続 | はい | Dynamics Lifecycle Services へのサービス接続を選択または作成します。 詳細については、Azure パイプラインで Dynamics Lifecycle Services 接続を作成する を参照してください。 |
LCS プロジェクト ID | はい | 配置する資産およびターゲット環境の両方を含むプロジェクトの ID を Dynamics Lifecycle Services に入力します。 プロジェクト ID は、プロジェクトのダッシュボードの URL の末尾に記載できます。 |
LCS 環境 ID | はい | ターゲット環境の ID を入力します。 環境 ID はグローバル一意識別子 (GUID) であり、環境詳細ページの環境詳細>環境 ID で検索できます。 |
LCS ファイル資産 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 の環境履歴に表示される更新プログラムの名前を入力します。 |
完了まで待機する | 清算済 (いいえ) | このチェック ボックスをオンにして、資産の配置が成功または失敗するまで待機するようタスクに指示します。 清算済 (いいえ) の場合、タスクは配置のみを開始します。 タスクが待機するように指示されている場合、実行時間の長い配置中にパイプラインのタイムアウトが発生することがあります。 タイムアウト オプションの詳細については、タイムアウト を参照してください。 |
注記
LCS ファイル アセット ID は、Dynamics Lifecycle Services アセット アップロード タスクから出力変数を使用して動的に取得できます。 LCS ファイル アセット ID を取得するには、FileAssetId を使用します。 例: $(.FileAssetId)。 詳細については、タスクからの出力変数を使用する を参照してください。