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