構成データのアップロード
最初に新しい CDM アプリケーション構造を作成してから、既存の構成データをその構造にアップロードします。
仕組み:CDM データテーブルへの既存の構成データの初期アップロード
- CDM ユーザーインターフェイスを開き、新しいアプリケーションを作成します。たとえば、オンライン書店をサポートする Bookstore アプリケーションを作成しましょう。 CDM 内のアプリケーションは、CMDB 内のアプリケーションサービス、アプリケーションモデル、または ダイナミック CI グループ [インフラストラクチャ] の構成データの完全なコレクションです。
- 次に、Bookstore アプリケーションを開き、新しい変更セットを生成して、データ構造の配置を開始できるようにします。(このプロセスの詳細な概要については、「構成データをアップロードするためのアプリケーションの準備」を参照してください。)
変更セットで、アップロードする構成データのセットごとにノードを含むデータ構造を定義します。このプロセスは 、データのモデリングと呼ばれます。必要に応じて、コンポーネント、コレクション、展開可能項目、および CDI を追加します。これらの各アイテムの詳細については、「CDM データモデル」を参照してください。アプリケーションへのノードの追加の詳細については、「構成データをアップロードするためのアプリケーションの準備」を参照してください。
この例では、2 つのコンポーネントと 2 つのコレクションが追加されています。これで、PaymentSvc-1.0 コンポーネントが Release-1.0 コレクションに含まれるようになりました。これは、すべてのコレクションと同様に、PaymentSvc-1.0 コンポーネント内のすべてのデータが Release-1.0 コレクションに含まれるようになったことを意味します。
構造に満足したら (いつでも更新できます)、REST Explorer を開いて、ソース構成データを CDM データテーブルにアップロードするプロセスを開始します。変更セットをコミットしないでください。データをアップロードできるように開いたままにします。
- REST API または構成データエディターを使用して、アップロードするアプリケーションの名前、データを配置する CDM アプリケーションデータ構造内のパス、ソースデータの形式 (この例では JSON) などを指定するパラメーター値を設定します。注:XML ファイルから既存の構成をアップロードし、ignoreAttributes が false に設定されている場合、CDM XML パーサーは識別子を使用して JSON に属性を保持します。詳細については、「CDM での XML ファイルの解析」を参照してください。
わかりやすくするために、この例は REST API エクスプローラープラットフォームユーティリティを示しています。これは、PaymentSvc-1.0 コンポーネントに dbProperties.json ノードを作成し、ソースデータを新しいノードに追加する コンポーネントへのアップロード REST POST 要求を作成する方法の例です。(アップロードするソースデータは別のフィールドで指定します)。API については、CdmApplicationsApi、CdmChangesetsApi、および CdmSnapshotApi で説明されています。
- [送信] を選択すると、API は元の構成データを読み取り、アップロードして、CDM データ構造に配置します。注:アップロードされたデータ項目は、特定の項目をすばやく見つけることができるように、構造フォルダー内でアルファベット順に並べ替えられます。構成データアイテム (CDI) の数には、次の制限があります。
- アプリケーションには、最大合計 100,000 の CDI を含めることができます。
- 1 つの 展開可能 には、最大 10,000 個の CDI を含めることができます。
重要:POST 要求を送信するたびに、API は POST を実行し、アップロードスクリプトも生成します。いくつかのスクリプト言語のうちの 1 つを指定できます。目的は、パイプラインシステムのコードを使用して、将来のアップロードでこのアプリケーションのアップロードプロセスを自動化することです。 - CDM に戻る:構成データをアップロードするためのアプリケーションの準備 の説明に従って構成データを確認して更新します。
- アプリケーションが構成データの完全かつ正確な表現であることを確認したら、変更セットをコミットできます。コミットアクションにより、それぞれの展開可能な項目のスナップショットが生成され、API がデータを CDM テーブルに格納します。
アプリケーションが完全に準備できたので、必要に応じてデータを管理できます:構成設定の更新、データを検証するためのポリシーの適用、構成データの有効なスナップショットのエクスポートなどを行います。
スナップショットのエクスポート中に、システムはエクスポートプロセスを自動化するために使用できる API コードを生成できます。詳細は、「エクスポーターの API 呼び出しコードの生成」を参照してください。