構成データのアップロード

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：4分

    • 最初に新しい CDM アプリケーション構造を作成してから、既存の構成データをその構造にアップロードします。

    重要:
    Washington DC リリース以降、DevOps コンフィグ は将来の廃止に備えて準備されます。これは非表示になり、新しいインスタンスにはインストールされなくなりますが、引き続きサポートされます。詳細については、Now Support ナレッジベースの「Deprecation Process (廃止プロセス) [KB0867184]」の記事を参照してください。

    仕組み:既存の構成データを CDM データテーブルにアップロードする

    新しいCDMアプリケーションへの構成データのアップロード

    1. CDM ユーザーインターフェイスを開き、新しいアプリケーションを作成します。たとえば、オンライン書店をサポートする Bookstore アプリケーションを作成しましょう。 CDM 内のアプリケーションは、CMDB内のアプリケーションサービス、アプリケーションモデル、またはダイナミック CI グループ [インフラストラクチャ] の構成データの完全なコレクションです。

      CDMアプリケーションの作成

    2. 次に、Bookstore アプリケーションを開き、新しい変更セットを生成して、データ構造の配置を開始できるようにします。(このプロセスの詳細な概要については、 構成データをアップロードするためのアプリケーションの準備を参照してください)。

      変更セットの作成

      変更セットで、アップロードする構成データのセットごとにノードを含むデータ構造を定義します。このプロセスは 、データのモデリングと呼ばれます。必要に応じて、コンポーネント、コレクション、展開可能項目、および CDI を追加します。これらの各項目の詳細については、「 CDMデータモデル」を参照してください。アプリケーションへのノードの追加の詳細については、「 構成データをアップロードするためのアプリケーションの準備」を参照してください。

      この例では、2 つのコンポーネントと 2 つのコレクションが追加されています。これで、 PaymentSvc-1.0 コンポーネントが Release-1.0 コレクションに含まれるようになりました。これは、すべてのコレクションと同様に、 PaymentSvc-1.0 コンポーネント内のすべてのデータが Release-1.0 コレクションに含まれるようになったことを意味します。

      変更セットの作成

      構造に満足したら (いつでも更新できます)、REST Explorer を開いて、ソース構成データを CDM データテーブルにアップロードするプロセスを開始します。変更セットをコミットしないでください。データをアップロードできるように開いたままにします。

    3. REST API または構成データエディターを使用して、アップロードするアプリケーションの名前、データを配置する CDM アプリケーションデータ構造内のパス、ソースデータの形式 (この例では JSON) などを指定するパラメーター値を設定します。
      注:
      XML ファイルから既存の構成をアップロードし、 ignoreAttributes が false に設定されている場合、CDM XML パーサーは識別子を使用して JSON に属性を保持します。詳細については、「での XML ファイルの解析 CDM」を参照してください。

      わかりやすくするために、この例は REST API Explorer プラットフォームユーティリティを示しています。これは、PaymentSvc-1.0 コンポーネントに dbProperties.json ノードを作成し、ソース データを新しいノードに追加する Upload to components REST POST 要求を作成する方法の例です。(アップロードするソースデータは別のフィールドで指定します。API については、 CdmApplicationsApi、 CdmChangesetsApi、および CdmSnapshotApi で説明されています。

      REST API Explorer フォーム。

    4. [ 送信] を選択すると、API は元の構成データを読み取り、アップロードして、 CDM データ構造に配置します。
      注:
      アップロードされたデータ項目は、特定の項目をすばやく見つけることができるように、構造フォルダー内でアルファベット順に並べ替えられます。
      構成データアイテム (CDI) の数には、次の制限があります。
      • アプリケーションには、最大合計 100,000 の CDI を含めることができます。
      • 1 つの 展開可能 には、最大 10,000 個の CDI を含めることができます。
      sn_cdm.max_allowed_cdi_per_applicationおよびsn_cdm.max_allowed_cdi_per_deployableプロパティ設定の構成については、CDM のシステムプロパティを参照してください。
      重要:
      POST 要求を送信するたびに、API は POST を実行し、アップロードスクリプトも生成します。いくつかのスクリプト言語のうちの 1 つを指定できます。目的は、パイプラインシステムのコードを使用して、将来のアップロードでこのアプリケーションのアップロードプロセスを自動化することです。
    5. CDMに戻る:構成データをアップロードするためのアプリケーションの準備の説明に従って構成データを確認して更新します。
    6. アプリケーションが構成データの完全かつ正確な表現であることを確認したら、変更セットをコミットできます。コミットアクションにより、各展開可能項目のスナップショットが生成され、API がデータを CDM テーブルに格納します。

      アプリケーションが完全に準備できたので、必要に応じてデータを管理できます:構成設定の更新、データを検証するためのポリシーの適用、構成データの有効なスナップショットのエクスポートなど。

      スナップショットのエクスポート中に、エクスポートプロセスの自動化に使用できる API コードを生成できます。詳細については、「エクスポーターの API 呼び出しコードの生成」を参照してください。