Db2uInstance カスタム・リソースを使用した Db2 のデプロイ

YAML スクリプトを使用して Db2uInstance CR コマンドを実行することにより、 Db2 をデプロイします。 これは、次のようないくつかの方法で実行できます。

• Red Hat® OpenShift® コンソールを使用します。
• Red Hat OpenShift コマンド・ライン・ツールを使用します。
• Kubernetes クラスターのコマンド・ライン・ツールを使用する。

Red Hat OpenShift コンソールを使用するには、 「インストール済みオペレーター (Installed Operators)」 > IBM Db2 に移動し、 Db2uInstance タブをクリックします。 このタブ・ページを使用して、 db2uCluster API (YAML ビュー) または Db2uInstance CR を介して Db2 を作成し、 Db2をデプロイします。

インストールされている Db2に基づいて Db2のバージョンを指定します

spec:
  version: "s11.5.9.0<container layer release number>"

以下の例は、データベース名を構成する方法を示しています。

spec: 
  environment:
    dbType: db2oltp
    databases:
      - name: BLUDB

以下の例は、専用ノードをデプロイする方法を示しています。

spec:
  affinity:
    nodeAffinity:
      requiredDuringSchedulingIgnoredDuringExecution:
        nodeSelectorTerms:
        - matchExpressions:
          - key: database
            operator: In
            values:
            - db2u-affinity
  tolerations:
  - key: "database"
    operator: "Equal"
    value: "db2u-affinity"
    effect: "NoSchedule"

以下の例は、 Db2 インスタンスのメモリーと CPU の制限を設定する方法を示しています。

spec:
  podTemplate:
    db2u:
      resource:
        db2u:
          limits:
            cpu: 5
            memory: 8Gi

以下のストレージ・カテゴリーに対して別個のストレージ域を構成します。

• db2 メタデータ用の meta 共有ストレージ・ボリューム。
• データベース・ストレージ用の data 非共有ストレージ・ボリューム。 
• データベースをバックアップするための backup 共有ストレージ・ボリューム (オプション)。
• トランザクション・ログ用の activelogs 非共有ストレージ・ボリューム (オプション)。 これは、単一モード (SMP) デプロイメントでのみサポートされ、MPP ではサポートされません。 詳細については、データベース・トランザクション・ログ用に別のストレージを作成するを参照してください。
• TEMPORARY 表スペースの tempts 非共用ストレージ・ボリューム (オプション)。 詳細については、一時的なテーブル・スペース用に別のストレージを作成するを参照してください。
• アーカイブ・ログ用の archivelogs 非共有ストレージ・ボリュームは 必須です。 詳しくは、「データベース・アーカイブ・ログ用の別個のストレージの作成」を参照してください。

例えば、以下の CR 呼び出しを使用して、新規または既存のストレージを構成できます。

spec:
  storage:
  - name: meta
    spec:
      accessModes:
      - ReadWriteMany
      resources:
        requests:
          storage: 100Gi
      storageClassName: ocs-storagecluster-cephfs
    type: create
  - name: backup
    spec:
      accessModes:
      - ReadWriteMany
      resources:
        requests:
          storage: 100Gi
      storageClassName: ocs-storagecluster-cephfs
    type: create
  - name: archivelogs
    spec:
      accessModes:
      - ReadWriteMany
      resources:
        requests:
          storage: 100Gi
      storageClassName: ocs-storagecluster-cephfs
    type: create

data、 activelogs、または temptsのテンプレート・ストレージを構成する場合は、 databases セクションの下に以下の CR 呼び出しを追加する必要があります。

    databases:
      - name: BLUDB
        storage:
          - name: data
            type: template
            spec:
              accessModes:
                - ReadWriteOnce
              resources:
                requests:
                  storage: 100Gi
              storageClassName: ocs-storagecluster-ceph-rbd
          - name: activelogs
            type: template
            spec:
              accessModes:
                - ReadWriteOnce
              resources:
                requests:
                  storage: 10Gi
              storageClassName: ocs-storagecluster-ceph-rbd

以下の例は、6 つの既存のボリューム・クレームと別個のボリューム・クレームの追加を示しています。

storage:
  - claimName: <meta-pvc-name>
    name: meta
    spec:
      resources: {}
    type: existing
  - claimName: <data-pvc-name>
    name: data
    spec:
      resources: {}
    type: existing
  - claimName: <backup-pvc-name>
    name: backup
    spec:
      resources: {}
    type: existing
  - claimName: <activelogs-pvc-name>
    name: activelogs
    spec:
      resources: {}
    type: existing
  - claimName: <tempts-pvc-name>
    name: tempts
    spec:
      resources: {}
    type: existing
  - claimName: <archivelogs-pvc-name>
    name: archivelogs
    spec:
      resources: {}
    type: existing

以下のコード例は、 ONに設定された 4K サポートを示しています。

spec:
  environment:
    ...
    instance:
      registry:
        DB2_4K_DEVICE_SUPPORT: "ON"

LDAP ディレクトリー・サービスはデフォルトで有効になっています。 内部 LDAP ユーザーを追加および管理する方法については、 「内部 LDAP」 を参照してください。 以下の例は、LDAP を無効にする方法を示しています。

spec:
  environment:
    authentication:
      ldap:
        enabled: false

次の例は、外部 LDAP を構成する方法を示しています。

spec:
  environment:
    authentication:
       ldap:
          enabled: true
          admin: bluadmin
          externalLdap: 
            server: "my-ldap-server.example.com"
            port: "389"
            userGroup: usergrp
            adminGroup: admingrp

デフォルトでは、 Db2 インスタンスを作成すると、外部データをクラスターに移動するために nodeport サービスがアクティブ化されます。 以下の例は、この動作を無効にする方法を示しています。

environment:
  disableNodePortService: true

CRでパラメータを設定することで、 制限付きの権限を持つ Db2を作成することができます。 このオプションにより、セキュリティーが向上します。 次の例は、制限された権限を設定する方法を示しています。unsafe sysctls :

spec:
  account: 
    securityConfig:                                                             
      privilegedSysctlInit: false
      

次の例では、ノードのIPCカーネルパラメータを設定することで、制限付きの権限を設定する方法を示しています

spec:
  account: 
    securityConfig:                                                             
      privilegedSysctlInit: false
  advOpts:
    hostIPC: true

以下の例は、作成したカスタム・サービス・アカウントと同じ名前にカスタム・サービス・アカウントを設定する方法を示しています。

spec:
  account:
    serviceAccountName: ${SERVICE_ACCOUNT}

Db2 インスタンスのデフォルト・データベース設定をオーバーライドできます。以下の例は、 Db2 インスタンスのデータベース値を設定する方法を示しています。

spec:
 environment:
   databases:
    - name: BLUDB
      settings:
        dftTableOrg: "COLUMN"
        dftPageSize: "32768"
        encrypt: "NO"
        codeset: "UTF-8"
        territory: "US"
        collation: "IDENTITY"   

Db2 インスタンスのデフォルトのデータベース構成設定をオーバーライドできます。

以下の例は、 Db2 インスタンスの dbConfig 値を設定する方法を示しています。

spec:
  environment:
    databases:
      - name: BLUDB
        dbConfig:
          LOGPRIMARY: "50"
          LOGSECOND: "35"
          APPLHEAPSZ: "25600"
          STMTHEAP: "51200 AUTOMATIC"

Db2 インスタンスのデフォルトの Db2 レジストリー変数値をオーバーライドできます。

以下の例は、 Db2 インスタンスの Db2 レジストリー変数値を設定する方法を示しています。

spec:
  environment:
    instance:
      registry:
        DB2_ATS_ENABLE: "NO"
        DB2_OBJECT_STORAGE_SETTINGS: "OFF"
        DB2_DISPATCHER_PEEKTIMEOUT: "2"
        DB2_COMPATIBILITY_VECTOR: "ORA"

以下の例は、 Db2 クラスターをデプロイするための CR コードを示しています。 CR は、以下の構成で Db2 インスタンスを作成します。

• データベース名: BLUDB。
• 4 個の CPU。
• 16 GB のメモリー。
• 5 つのストレージ・ボリューム (meta、 data、 backup、 archivelogs、および tempts)。
• DB2 4K SUPPORT が使用可能になりました。
• LDAP が無効になりました。
• 特権インスタンス。

apiVersion: db2u.databases.ibm.com/v1
kind: Db2uInstance
metadata:
  name: db2-example
spec:
  account:
    privileged: true
  environment:
    authentication:
      ldap:
        enabled: false
    databases:
    - dbConfig:
        APPLHEAPSZ: "25600"
        LOGPRIMARY: "50"
        LOGSECOND: "35"
        STMTHEAP: 51200 AUTOMATIC
      name: BLUDB
      storage:
        - name: data
          type: template
          spec:
            accessModes:
              - ReadWriteOnce
            resources:
              requests:
                storage: 100Gi
            storageClassName: ocs-storagecluster-ceph-rbd
        - name: activelogs
          type: template
          spec:
            accessModes:
              - ReadWriteOnce
            resources:
              requests:
                storage: 10Gi
            storageClassName: ocs-storagecluster-ceph-rbd           
    dbType: db2oltp 
    instance:
      dbmConfig:
        DIAGLEVEL: "2"
      registry:
        DB2_4K_DEVICE_SUPPORT: "ON"
        DB2_ATS_ENABLE: "NO"
        DB2_DISPATCHER_PEEKTIMEOUT: "2"
        DB2_OBJECT_STORAGE_SETTINGS: "OFF"
    partitionConfig:
      dataOnMln0: true
      total: 1
      volumePerPartition: true
  license:
    accept: true
  nodes: 1
  podTemplate:
    db2u:
      resource:
        db2u:
          limits:
            cpu: 4
            memory: 16Gi
  storage:
  - name: meta
    spec:
      accessModes:
      - ReadWriteMany
      resources:
        requests:
          storage: 10Gi
      storageClassName: ocs-storagecluster-cephfs
    type: create
  - name: backup
    spec:
      accessModes:
      - ReadWriteMany
      resources:
        requests:
          storage: 10Gi
      storageClassName: ocs-storagecluster-cephfs
    type: create
  - name: archivelogs
    spec:
      accessModes:
      - ReadWriteMany
      resources:
        requests:
          storage: 100Gi
      storageClassName: ocs-storagecluster-cephfs
    type: create
  version: s11.5.9.0-cn2