レプリケーション v1.1.1 カスタム リソース定義

仕様スキーマ

ReplicationSpec は、レプリケーションの望ましい状態を定義します。

dbcluster:
  name: string
downstream:
  control: string
  host: string
  password:
    name: string
    namespace: string
  port: integer
  replicationSlotName: string
  username: string
upstream:
  password:
    name: string
    namespace: string
  replicationSlotName: string
  username: string

フィールド

タイプ
必須または省略可

 

説明
dbcluster
object
省略可
DBCluster は、このレプリケーションが属する DBCluster です。
dbcluster.name
string
省略可
参照対象の名前。詳細については、名前をご覧ください。
downstream
object
省略可
Downstream には、ダウンストリーム データベースのレプリケーションの仕様が含まれています。
downstream.control
string
必須
control は、このデータベースで実行するレプリケーション オペレーションを指定します。指定できる値は、setup、promote、rewind です。
downstream.host
string
必須
ホストは、このデータベースがレプリケーションのためにアクセスできるアップストリーム データベースの接続エンドポイントです。
downstream.password
object
必須
Password は、アップストリーム データベースのレプリケーション ユーザー パスワードを保存するシークレットの参照です。
downstream.password.name
string
省略可
name は、シークレット リソースを参照する名前空間内で一意です。
downstream.password.namespace
string
省略可
namespace は、シークレット名が一意である必要がある空間を定義します。
downstream.port
integer
省略可
Port は、このデータベースがレプリケーションのためにアクセスできるアップストリーム データベースのポートです。デフォルトは 5432 です。
downstream.replicationslotname
string
必須
ReplicationSlotName は、アップストリーム データベースに作成されたレプリケーション スロットの名前です。このデータベースではレプリケーションに使用されます。
downstream.username
string
必須
ユーザー名は、アップストリーム データベースで作成されたレプリケーション ユーザーの名前です。このデータベースは、レプリケーションのためにアップストリームに接続するために使用します。
upstream
object
省略可
アップストリームには、レプリケーション アップストリーム データベースの仕様が含まれています。
upstream.password
object
必須
Password は、レプリケーション ユーザーのパスワードを保存するシークレットへの参照です。Password が指定されていない場合、パスワードが生成され、ステータスに表示されるシークレットに保存されます。
upstream.password.name
string
省略可
name は、シークレット リソースを参照する名前空間内で一意です。
upstream.password.namespace
string
省略可
namespace は、シークレット名が一意である必要がある空間を定義します。
upstream.replicationslotname
string
省略可
ReplicationSlotName は、レプリケーションに使用するレプリケーション スロットの名前です。指定しない場合、レプリケーション スロット名が生成され、ステータスに表示されます。
upstream.username
string
省略可
ユーザー名は、レプリケーションに使用するレプリケーション ユーザーの名前です。指定しない場合、ユーザー名が生成され、ステータスに表示されます。

ステータス スキーマ

ReplicationStatus は、レプリケーションの観測された状態を定義します。

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
downstream: object
observedGeneration: integer
reconciled: boolean
upstream:
  host: string
  password:
    name: string
    namespace: string
  port: integer
  replicationSlotName: string
  username: string

フィールド

タイプ
必須または省略可

 

説明
conditions[]
object
省略可
condition は、エンティティの現在の状態に関する、利用可能な最新の観測値を表します。
conditions[].lastTransitionTime
string
必須
lastTransitionTime は、あるステータスから別のステータスに条件が最後に移行した時刻です。これは、基盤となる条件が変更されたときに発生します。基になる条件が変更された時刻が不明な場合は、API フィールドが変更された時刻を使用します。
conditions[].message
string
必須
message は、移行の詳細を示す人間が読めるメッセージです。空の文字列を指定できます。
conditions[].observedGeneration
integer
省略可
observedGeneration は、条件が設定された .metadata.generation を表します。たとえば、.metadata.generation が 12 で、.status.conditions[x].observedGeneration が 9 の場合、その状態はインスタンスの現在の状態に関して古くなっています。
conditions[].reason
string
必須
reason には、条件の最後の遷移の理由を示すプログラマティック ID が含まれます。特定の条件タイプのプロデューサーは、このフィールドの想定される値と意味、および値が保証付き API と見なされるかどうかを定義できます。値は CamelCase 文字列にする必要があります。このフィールドは空でないこと。
conditions[].status
string
必須
条件のステータス(True、False、Unknown のいずれか)。
conditions[].type
string
必須
キャメルケースまたは foo.example.com/CamelCase で条件のタイプを指定します。多くの .condition.type 値は、Available など、リソース間で一貫しています。任意の条件が有用な場合があるため(.node.status.conditions を参照)、競合を解決する機能が重要です。一致する正規表現は、(dns1123SubdomainFmt/)?(qualifiedNameFmt) です。
criticalIncidents[]
object
必須
CriticalIncidents は、アクティブなすべての重大なインシデントのフラットなリストです。
criticalIncidents[].code
string
必須
Code は、この特定のエラーのエラーコードです。エラーコードは DBSE+numeric 文字列(DBSE1012 など)です。
criticalIncidents[].createTime
string
必須
CreateTime は、このインシデントが送信元で作成されたときのタイムスタンプです。
criticalIncidents[].message
string
省略可
Message には、発生したインシデントまたはエラーの説明が含まれます。
criticalIncidents[].messageTemplateParams
object
省略可
MessageTemplateParams には、ユーザー インターフェースでユーザー フレンドリーなデータドリブン バージョンの Message を生成するために必要な Key-Value ペアが含まれています。
criticalIncidents[].resource
object
必須
Resource には、インシデントを報告した Database Service コンポーネントに関する情報と、Kubernetes リソースに関する情報が含まれます。
criticalIncidents[].resource.component
string
必須
Component は、インシデントを報告した Database Service サブシステムの内部識別子です。
criticalIncidents[].resource.location
object
省略可
位置情報。
criticalIncidents[].resource.location.cluster
string
省略可
影響を受ける Kubernetes リソースのクラスタの名前。
criticalIncidents[].resource.location.group
string
省略可
Kubernetes リソースのグループ名。
criticalIncidents[].resource.location.kind
string
省略可
Kubernetes リソースの Kind。
criticalIncidents[].resource.location.name
string
省略可
影響を受ける Kubernetes リソースの名前。
criticalIncidents[].resource.location.namespace
string
省略可
影響を受ける Kubernetes リソースの名前空間。
criticalIncidents[].resource.location.version
string
省略可
Kubernetes リソースのバージョン。
criticalIncidents[].stackTrace[]
object
省略可
スタック トレースからのメッセージの非構造化リスト。
criticalIncidents[].stackTrace[].component
string
省略可
メッセージをログに記録した Database Service コンポーネントの名前。
criticalIncidents[].stackTrace.message
string
省略可
ログに記録されたメッセージ。
criticalIncidents[].transientUntil
string
省略可
TransientUntil が指定されている場合、問題は指定された時刻まで一時的なものと見なす必要があります。
downstream
object
省略可
Downstream には、レプリケーション ダウンストリーム データベースの観測された状態が含まれます。
observedgeneration
integer
省略可
内部: コントローラによって検出された生成。
reconciled
boolean
省略可
内部: リソースがコントローラによって調整されたかどうか。
upstream
object
省略可
upstream には、レプリケーション アップストリーム データベースの観測された状態が含まれます。
upstream.host
string
省略可
ホストは、ダウンストリーム データベースがレプリケーションのためにアクセスできるこのデータベースの接続エンドポイントです。
upstream.password
object
省略可
Password は、このデータベースのレプリケーション ユーザー パスワードを保存するシークレットの参照です。
upstream.password.name
string
省略可
name は、シークレット リソースを参照する名前空間内で一意です。
upstream.password.namespace
string
省略可
namespace は、シークレット名が一意である必要がある空間を定義します。
upstream.port
integer
省略可
Port は、ダウンストリーム データベースがレプリケーションのためにアクセスできるこのデータベースのポートです。
upstream.replicationslotname
string
省略可
ReplicationSlotName は、このデータベースに作成されたレプリケーション スロットの名前です。ダウンストリーム データベースは、このレプリケーション スロットをレプリケーションに使用できます。
upstream.username
string
省略可
ユーザー名は、このデータベースのレプリケーション ユーザーの名前です。ダウンストリーム データベースは、このユーザーを使用してこのデータベースに接続し、レプリケーションを行うことができます。