Lifecycle Services (LCS) で、コード アップグレード サービスを構成する
この記事では、Lifecycle Services (LCS) の コード アップグレード タイルを構成して、ソリューションを最新バージョンの Dynamics 365 財務と運用アプリに移行する方法について説明します。
概要
コードのアップグレード ツールは、Azure DevOps プロジェクトに接続し、トランク\メイン ブランチを検索し、リリース\<バージョン番号>という名前の新しいブランチに分岐してから、コードのアップグレードを実行します。 このプロセスが完了した後、開発環境を、リリース\<バージョン番号>下の新しいブランチに同期させ、競合を解決できます。 アップグレード後のコードをコンパイルしてテストしたとき、新しいブランチを Visual Studio のソース管理エクスプ ローラーを使用して Trunk\Main にマージすると、プロセスが完了します。
Dynamics 365 for Finance and Operations バージョン 8.0 およびそれ以降では、Microsoft モデルをオーバーレイしてカスタマイズすることはできません。 アップグレードする前に、カスタマイズを拡張機能にリファクターする計画が必要です。 詳細については 拡張機能のホーム ページ および モデルの制限を緩和して、オーバレイを拡張機能にリファクタリングする を参照してください。
処理
トランク\メイン フォルダー構造を作成する
ソース コードを識別するコード アップグレード サービスについては、Azure DevOps プロジェクトには Team Foundation バージョン管理 (TFVC) コード リポジトリが含まれている必要があります。 さらに、コード リポジトリ フォルダー構造は、次の厳密なパターンに準拠している必要があります。
- コードおよびメタデータの場合:
/<DevOps project name>/Trunk/Main/Metadata - Visual Studio プロジェクトおよびソリューション ファイルの場合:
/<DevOps project name>/Trunk/Main/Projects
新しいフォルダーは、Azure DevOps Web インターフェイスの リポジトリ で直接作成できます。
メモ
- フォルダー名は大文字と小文字を区別していて、つまり、メインおよびメインでない、またはコードのアップグレード サービスはフォルダーを認識しません。
- Azure DevOps プロジェクトは、既定で Git バージョン管理を使用します。 TFVC リポジトリを追加する必要があります。
- プロジェクト設定へ移動し、リポジトリに移動します。
- [新しいリポジトリ] を選択します。
- [種類] フィールドで [TFVC] を選択し、[作成] をクリックします。
個人用アクセス トークンを作成する
Azure DevOps プロジェクトに接続するために、LCS は個人用アクセス トークンを使用して認証されます。 Azure DevOps で個人用アクセス トークンを作成するには、以下の手順に従います。 LCS プロジェクトを Azure DevOps プロジェクトへ接続できるように構成する場合、このセクションを省略できます。
visualstudio.com にログインし、Azure DevOps プロジェクトを見つけます。
右上隅で、名前をポイントするとメニューが表示され、セキュリティを選択します。
追加を選択して、新しい個人用アクセス トークンを作成し、名前を付けて、トークンが使用できる期間を入力します。 トークンの作成 を選択します。
トークンをクリップボードにコピーします。 このステップが完了したら、トークンの詳細情報を見つけることはできません。したがって、このページから移動する前に、かならずトークンをコピーしてください。
Lifecycle Services プロジェクトをコンフィギュレーションして Azure DevOps に接続する
LCS プロジェクトで、プロジェクト設定タイルに移動し、Visual Studio Team Services を選択してから、Visual Studio Team Services の設定ボタンを選択します。 この構成は多くの LCS ツールで必要になります。すでに Azure DevOps プロジェクトに接続するように LCS を設定している場合は、このセクションをスキップできます。
Azure DevOps 組織のルート URL および以前に作成したアクセス トークンを入力し、続行を選択します。
接続する Azure DevOps 組織内のプロジェクトを選択し、続行を選択します。
確認および保存ページで、保存を選択します。
ax7.version ファイルを作成します
メモ
AX 2012 から移行する場合は、この手順を省略できます。
LCS のコードのアップグレード タイルは、移行元のバージョンを自動的に検出します。ソース管理のメイン フォルダの ax7.version ファイルを参照してください。 以下に示すように、Visual Studio または Azure DevOps Web ポータルを通じて、このファイルを手動で作成する必要があります。 Dynamics AX 2012 R3 またはそれ以前のバージョンからコードを移行する場合、このファイルは必要ありません。 ここに入力するバージョン番号は、アプリケーションのバージョン (プラットフォームのバージョンではない) である必要があります。 このファイルに無効なバージョン番号を入力するとしてのコード アップグレードの実行に失敗する可能性があるため、ここには必ず正しいバージョン番号を入力してください。
どのアプリケーション バージョンを持っているか識別する方法の詳細については、Microsoft Dynamics AX ビルド番号の概要を参照してください。
コード アップグレード タイルを実行
LCS プロジェクトで、コードのアップグレード タイルを選択します。
画面の左下隅で、追加を選択してから名前と説明を入力します。 アップグレード元のバージョンとして Microsoft Dynamics AX 7 を選択し、作成を選択します。
- Dynamics AX 2012 R3 からコードをアップグレードする場合は、アップグレード元のバージョンを選択します。 圧縮バージョンの Dynamics AX 2012 R3 モデル ストア ファイルをアップロードするように要求されます。
- 見積のみチェック ボックスがオンになっている場合、ツールはレポートのみを生成し、チェックインや Azure DevOps の新しいコード分岐の作成を行いません。 実際のアップグレードをコミットする前に、アップグレードに必要な作業の潜在的なサイズを評価する場合、このオプションを使用する必要があります。
右下にあるコードの分析を選択します。 コードのアップグレード プロセスが開始されます。 このプロセスには、大規模なソリューションが完了するまでに通常 40 分かかります。 完了したら、LCS の コードのアップグレード タイルに戻り、結果を表示します。
コードのアップグレード サービスは、新しいブランチを作成し、アップグレードされたコードを Azure DevOps プロジェクトにチェックインします。 アップグレード プロセスが完了した後、コードはリリースフォルダ下の新しいブランチに存在します。 分岐名の後には、アップグレードの日時が付いています。
リリースを Trunk\Main にマージ
リリース\<バージョン番号>のアップグレードされたコードが正常にコンパイルされ、コード移行とテストを完了したら、このブランチをトランク\メインにマージする準備が整います。 マージするには、Visual Studio の開発環境で、ソース管理エクスプローラー ウィンドウを開き、リリース\<バージョン番号> ブランチで右クリックし、コンテキスト メニューでブランチとマージに移動し、サブメニューでマージを選択します。
Source Control Merge Wizard が開かれ、リリース\<バージョン番号>ブランチがをトランク\メインに戻すようマージする手順が示されます。