cpd-cli service-instance create コマンドを使用した Db2 Data Management Console 用のサービス・インスタンスの作成

このタスクを完了するために必要な情報

Db2 Data Management Console のサービス・インスタンスを作成する前に、以下の情報を確認してください。

バージョンの要件

IBM Software Hub のインスタンスに関連付けられているすべてのコンポーネントは、同じリリースでインストールまたは作成する必要があります。 たとえば、がバージョン で 5.3.1 インストール Db2 Data Management Console されている場合、サービスインスタンスはバージョン で作成する必要があります 5.3.1。

環境変数

このタスクのコマンドでは環境変数を使用するため、記載されているとおりにコマンドを実行できます。

• 環境変数を定義するスクリプトがない場合は、 インストール環境変数の設定 を参照してください。
• スクリプトから環境変数を使用するには、このタスクでコマンドを実行する前に環境変数をsourceする必要があります。 例えば、以下のコマンドを実行します。

  source ./cpd_vars.sh

始める前に

このタスクでは、以下の前提条件が満たされていることを前提としています。

手順

サービス・インスタンスを作成するには、以下のタスクを実行します。

1. サービス・インスタンスの作成
2. サービス・インスタンスが作成されたことを検証しています
3. 次に行うこと

サービス・インスタンスの作成

サービス・インスタンスを作成するには、以下の手順を実行します。

1. サービス・インスタンス・ペイロードを定義する JSON ファイルを作成する、ワークステーション上のディレクトリーに移動します。
2. サービス・インスタンスの JSON ペイロードにデータを取り込むために使用される環境変数を設定します。
   1. INSTANCE_NAME 環境変数を、サービス・インスタンスの表示名として使用する固有の名前に設定します。

      export INSTANCE_NAME="<display-name>"

      この名前は、 IBM Software Hub Web クライアントの「 インスタンス 」ページに表示されます。

      表示名は string で、英数字 (a から z 、 A から Z 、 0 から 9)、スペース ( )、ダッシュ (-)、下線 (_)、およびピリオド (.) を使用できます。 上記の export コマンドに示されているように、表示名を引用符で囲んでください。

   2. INSTANCE_DESCRIPTION 環境変数を、サービス・インスタンスに使用する記述に設定します。

      export INSTANCE_DESCRIPTION="<description>"

      この説明は、 IBM Software Hub Web クライアントの「 インスタンス 」ページに表示されます。

      説明は string であり、英数字、スペース、ダッシュ、下線、およびピリオドを含めることができます。 上記の export コマンドに示されているように、表示名を引用符で囲んでください。

   3. INSTANCE_VERSION 環境変数を、クラスター上の IBM Software Hub のバージョンに対応するバージョンに設定します。

      export INSTANCE_VERSION=<version>

      以下の表を使用して、適切な値を判別してください。

      IBM Software Hub バージョン	サービス・インスタンス・バージョン
      5.3.1	5.3.1
      5.3.0	5.3.0

   4. ログのサイズに基づいて、 STORAGE_SIZE 環境変数を設定します。

      export STORAGE_SIZE=<integer>

      10 Gi から 512 Gi までの値を指定します。 値は整数として指定します。 計測単位を省略してください。

      デフォルトのログ構成には 10 Gi で十分です。

   5. INSTANCE_SIZE 環境変数を設定します。 このサイズによって、サービス・インスタンスに割り振られるリソースが決まります。

      export INSTANCE_SIZE=<size>

      有効な値は以下のとおりです。

      • small
      • medium
      • large

      各サイズに関連付けられたリソースについて詳しくは、 IBM Entitled Registry からダウンロードできる コンポーネント・スケーリングのガイダンス PDF を参照してください。

3. data-management-console-instance.json ペイロード・ファイルを作成します。

   cat << EOF > ./data-management-console-instance.json
   {
       "addon_type":"dmc",
       "display_name":"${INSTANCE_NAME}",
       "description":"${INSTANCE_DESCRIPTION}",
       "namespace":"${PROJECT_CPD_INST_OPERANDS}",
       "addon_version": "${INSTANCE_VERSION}",
       "parameters":{
           "storageClass":"${STG_CLASS_FILE}",
           "storageSize":"${STORAGE_SIZE}Gi"
       },
       "create_arguments":{
           "metadata":{
               "storageClass":"${STG_CLASS_FILE}",
               "storageSize":"${STORAGE_SIZE}Gi",
               "scaleConfig":"${INSTANCE_SIZE}"
           }
       },
       "pre_existing_owner":false
   }
   EOF

   以下の環境変数は、インストール環境変数スクリプトで既に定義されている値を使用します。

   • ${PROJECT_CPD_INST_OPERANDS}
   • ${STG_CLASS_FILE}
4. PAYLOAD_FILE 環境変数を、ワークステーション上の JSON ペイロード・ファイルの完全修飾名に設定します。

   export PAYLOAD_FILE=<fully-qualified-JSON-file-name>

5. ペイロード・ファイルからサービス・インスタンスを作成します。

   cpd-cli service-instance create \
   --profile=${CPD_PROFILE_NAME} \
   --from-source=${PAYLOAD_FILE}

サービス・インスタンスが作成されたことの検証

サービス・インスタンスが作成されたことを確認するには、以下のコマンドを実行します。

cpd-cli service-instance status ${INSTANCE_NAME} \
--profile=${CPD_PROFILE_NAME} \
--output=json

• コマンドが PROVISIONED を返した場合、サービス・インスタンスは正常に作成されました。
• コマンドが PROVISION_IN_PROGRESS を返した場合は、数分待ってからコマンドを再実行してください。
• コマンドが FAILED を返した場合は、 zen-core-api ポッドと zen-watcher ポッドのポッド・ログで考えられる原因を確認します。

次のタスク