DBInstance カスタム リソース定義

仕様スキーマ

DBInstanceSpec は、DBInstance の選択された状態を定義します。

DBInstance:
  metadata:
    name: string
  spec:
    dbcParent:
      name: string
    instanceType: string
    nodeCount: integer
    readPoolPort: integer
    resources:
      cpu: integer or string
      memory: string or integer
      disks:
      - name: string
        path: string
        size: string

フィールド

タイプ
必須または省略可

 

説明
name
string
必須
DBInstance リソースの名前。
dbcParent
object
必須
この DBInstance が複製元とする親 DBCluster。
dbcParent.name
string
必須
参照先の DBCluster の名前。
instanceType
string
省略可
DBInstance のタイプを示します。ReadPool 型をサポートします。デフォルト値は ReadPool です。
nodeCount
integer
省略可
この DBInstance に作成する DBNodes の数を決定します。サポートされる値は 0 ~ 20 です。デフォルト値は 1 です。
readPoolPort
integer
省略可
ReadPool DBInstance の専用 HAProxy フロントエンド ポート。
resources
object
省略可
この DBInstance に属するインスタンス(DBNode)に使用されるコンピューティング リソースとストレージ リソースを指定します。省略した場合、インスタンスは DBCluster のプライマリ インスタンスと同じリソースを使用します。
resources.cpu
integer or string
必須
データベース プロセスに割り当てられる CPU の量(2 や "2" など)。
resources.memory
string or integer
必須
データベース プロセスに割り当てられるメモリ量("6Gi" など)。
resources.disks
list (object)
必須
データベース プロセスに割り当てられるディスクの仕様。
resources.disks[].name
string
必須
ディスクの名前。指定できる値は DataDisk と ObsDisk です。
resources.disks[].path
string
省略可
ディスクがホスト ファイル システムにマウントされるパス。
resources.disks[].size
string
省略可
ディスクサイズ(バイト単位)(例: "15Gi")。

ステータス スキーマ

DBInstanceStatus は、DBInstance の観測された状態を定義します。

conditions:
- lastTransitionTime: string
  message: string
  observedGeneration: integer
  reason: string
  status: string
  type: string
criticalIncidents:
- code: string
  createTime: string
  message: string
  messageTemplateParams: object
  resource:
    component: string
    location:
      cluster: string
      group: string
      kind: string
      name: string
      namespace: string
      version: string
  stackTrace:
  - component: string
    message: string
  transientUntil: string
endpoints:
- name: string
  value: string
observedGeneration: integer
reconciled: boolean

フィールド

タイプ
必須または省略可

 

説明
conditions
list (object)
省略可
DBInstance の現在の状態に関する取得可能な最新の観測値を表します。
conditions[]
object
省略可
Condition は、この API リソースの現在の状態の 1 つの側面を表します。
conditions[].lastTransitionTime
string
必須
条件があるステータスから別のステータスに遷移した日時を示します。この時刻が不明な場合は、API フィールドが変更された時刻を使用します。
conditions[].message
string
必須
移行の詳細を説明する人間が読める文字列。この文字列は空にできます。
conditions[].observedGeneration
integer
省略可
条件が設定された .metadata.generation を表します。
conditions[].reason
string
必須
この条件の最後の遷移の理由を示すプログラマティック ID が含まれます。値は CamelCase 文字列です。DBInstance の推定値は次のとおりです。
  • AllDBNodesReady: DBInstance に必要な数の準備完了状態の DBNode があります。
  • MinDBNodesReady: 仕様で指定された最小数の DBNodes が準備完了している。
  • DBNodesNotReady: 最小数の DBNodes が準備できていません。
  • AllDBNodesStreaming: DBInstance には、プライマリからアクティブに複製するのに必要な数の DBNode があります。
  • MinDBNodesStreaming: 少なくとも最小数の DBNodes がプライマリから複製されています。
  • DBNodesNotStreaming: DBNodes の最小数が複製されていません。
  • NetworkReady: LoadBalancer が作成され、DBNode を提供する準備が整っています。
  • NetworkNotReady: LoadBalancer は DBNodes を提供する準備ができていません。
  • DBNodesAvailable: 必要な数の DBNodes が正常にプロビジョニングされ、LoadBalancer を使用してアクセスできます。
  • InvalidSpec: 仕様のいずれかが無効であることを示します。
conditions[].status
string
必須
条件のステータス。有効な値は True、False、Unknown です。
conditions[].type
string
必須
条件のタイプ(CamelCase)。想定されるタイプは次のとおりです。
  • DBNodesReady: この DBInstance に必要なすべての DBNode がプロビジョニングされ、準備が整っているかどうかを示します。
  • Streaming: DBNodes がプライマリからアクティブに複製されているかどうかを示します。
  • NetworkReady: LoadBalancer が作成され、DBNode にサービスを提供する準備ができているかどうかを示します。
  • Available: 必要な数の DBNodes がプロビジョニングされ、LoadBalancer を使用してアクセス可能かどうかを示します。
criticalIncidents
list (object)
省略可
アクティブな重大インシデントのリスト。
criticalIncidents[]
object
省略可
進行中の重大なインシデントを表します。
criticalIncidents[].code
string
必須
エラーのエラーコード。エラーコードは DBSE と数値文字列で構成されます(例: DBSE1012)。
criticalIncidents[].createTime
string
必須
インシデントが発生元で作成されたときのタイムスタンプ。
criticalIncidents[].message
string
省略可
発生したインシデントまたはエラーの説明。
criticalIncidents[].messageTemplateParams
object
省略可
UI でユーザー フレンドリーなデータドリブン メッセージを生成するための Key-Value ペアが含まれます。
criticalIncidents[].resource
object
必須
インシデントを報告した Database Service コンポーネントに関する情報が含まれます。
criticalIncidents[].resource.component
string
必須
インシデントを報告した Database Service サブシステムの内部識別子。
criticalIncidents[].resource.location
object
省略可
元のリソースのロケーション。
criticalIncidents[].resource.location.cluster
string
省略可
影響を受けるリソースのクラスタの名前。
criticalIncidents[].resource.location.group
string
省略可
リソースのグループ名。
criticalIncidents[].resource.location.kind
string
省略可
リソースの種類。
criticalIncidents[].resource.location.name
string
省略可
影響を受けるリソースの名前。
criticalIncidents[].resource.location.namespace
string
省略可
影響を受けるリソースの Namespace。
criticalIncidents[].resource.location.version
string
省略可
リソースのバージョン。
criticalIncidents[].stackTrace
list (object)
省略可
スタック トレースに含まれるメッセージの非構造化リスト。
criticalIncidents[].stackTrace[].component
string
省略可
メッセージをロギングした Database Service コンポーネントの名前。
criticalIncidents[].stackTrace[].message
string
省略可
ログに記録されたメッセージ。
criticalIncidents[].transientUntil
string
省略可
問題は指定された時刻まで一時的なものと見なされます。
endpoints
list (object)
省略可
endpoints には、このインスタンスにアクセスできるすべてのエンドポイントが含まれます。
endpoints[].name
string
必須
Name はエンドポイントの名前です(例: Read-Only)。
endpoints[].value
string
必須
value には、インスタンスに接続してアクセスするためのエンドポイント情報が含まれます。
observedGeneration
integer
省略可
コントローラによって観測された世代。
reconciled
boolean
省略可
リソースがコントローラによって調整されたかどうか。