Definisi resource kustom Replication v1.6.0

Pilih versi dokumentasi:

Skema spesifikasi

ReplicationSpec menentukan status Replikasi yang diinginkan.

dbcluster:
  name: string
downstream:
  control: string
  host: string
  password:
    name: string
    namespace: string
  port: integer
  replicationSlotName: string
  username: string
upstream:
  applicationName: string
  logReplicationSlot: boolean
  logicalReplication:
    databaseName: string
    pluginName: string
  password:
    name: string
    namespace: string
  replicationSlotName: string
  synchronous: string
  username: string

Kolom

Jenis
Wajib atau opsional

 

Deskripsi
dbcluster
object
Opsional 		DBCluster adalah DBCluster tempat Replikasi ini berada.
dbcluster.name
string
Opsional 		Nama referen. Untuk mengetahui informasi selengkapnya, lihat Nama.
downstream
object
Opsional 		Downstream berisi spesifikasi untuk database downstream replikasi.
downstream.control
string
Wajib 		Kontrol menentukan operasi replikasi yang akan dilakukan pada database ini. Nilai yang diizinkan adalah setup, promote, dan rewind.
downstream.host
string
Wajib 		Host adalah endpoint koneksi database upstream yang dapat diakses oleh database ini untuk replikasi.
downstream.password
object
Wajib 		Sandi adalah referensi ke secret yang menyimpan sandi pengguna replikasi database upstream.
downstream.password.name
string
Opsional 		name bersifat unik dalam namespace untuk mereferensikan resource secret.
downstream.password.namespace
string
Opsional 		namespace menentukan ruang tempat nama secret harus unik.
downstream.port
integer
Opsional 		Port adalah port database upstream yang dapat diakses oleh database ini untuk replikasi. Default-nya adalah 5432.
downstream.replicationslotname
string
Wajib 		ReplicationSlotName adalah nama slot replikasi yang dibuat di database upstream. Slot ini digunakan oleh database ini untuk replikasi.
downstream.username
string
Wajib 		Nama pengguna adalah nama pengguna replikasi yang dibuat di database upstream. Pengguna ini digunakan oleh database ini untuk terhubung ke upstream untuk replikasi.
upstream
object
Opsional 		Upstream berisi spesifikasi untuk database upstream replikasi.
upstream.applicationName
string
Opsional 		applicationName adalah ID koneksi replikasi sinkron. Nilai ini diperlukan jika Sinkron ditetapkan ke "true".
upstream.logReplicationSlot
boolean
Opsional 		LogReplicationSlot jika disetel ke benar (true) akan memungkinkan slot replikasi ini ditulis ke file WAL yang dihasilkan oleh instance utama.
Sebaiknya aktifkan opsi ini, terutama dalam replikasi lintas region. Pastikan DBCluster utama juga mengaktifkan opsi ReplayReplicationSlotsOnStandbys untuk memastikan slot replikasi yang ditulis ke file WAL akan diputar ulang di standby HA.
Dengan mengaktifkan kedua opsi tersebut, Anda akan memastikan bahwa jika terjadi failover atau pengalihan HA pada DBCluster utama, instance utama HA baru akan mempertahankan file WAL yang belum diterima oleh DBCluster sekunder.
Perhatikan bahwa mengubah kolom ini akan menyebabkan database utama dimulai ulang.
upstream.logicalReplication
object
Opsional 		LogicalReplication menentukan konfigurasi replikasi logis untuk slot replikasi. Jika kosong, slot replikasi dikonfigurasi sebagai slot replikasi fisik.
upstream.logicalReplication.databaseName
string
Opsional 		DatabaseName adalah database yang terkait dengan slot ini. Hanya perubahan dari database ini yang di-streaming melalui slot.
upstream.logicalReplication.pluginName
string
Opsional 		PluginName adalah plugin decoding yang terkait dengan slot ini. Lihat Penjelasan Dekode Logis untuk mengetahui detailnya.
upstream.password
object
Wajib 		Sandi adalah referensi ke secret yang menyimpan sandi pengguna replikasi. Jika Sandi tidak diberikan, sandi akan dibuat dan disimpan dalam secret yang ditampilkan dalam status.
upstream.password.name
string
Opsional 		name bersifat unik dalam namespace untuk mereferensikan resource secret.
upstream.password.namespace
string
Opsional 		namespace menentukan ruang tempat nama secret harus unik.
upstream.replicationslotname
string
Opsional 		ReplicationSlotName adalah nama slot replikasi yang akan digunakan untuk replikasi. Jika tidak disediakan, nama slot replikasi akan dibuat dan ditampilkan dalam status.
upstream.synchronous
string
Opsional 		Synchronous menentukan apakah slot replikasi harus dikonfigurasi untuk replikasi sinkron. Jika benar (true), applicationName akan ditambahkan ke daftar standby sinkron. Nilai defaultnya adalah false.
Catatan: Tindakan ini dapat berdampak negatif pada performa.
upstream.username
string
Opsional 		Username adalah nama pengguna replikasi yang akan digunakan untuk replikasi. Jika tidak diberikan, nama pengguna akan dibuat dan ditampilkan dalam status.

Skema status

ReplicationStatus menentukan status Replikasi yang diamati.

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:
  physicalDownstream:
    passwordResourceVersion: string
    setupStrategies:
      endedAt: string
      message: string
      retries: integer
      startedAt: string
      state: string
      strategy: string
    state: string
observedGeneration: integer
reconciled: boolean
upstream:
  host: string
  password:
    name: string
    namespace: string
  port: integer
  replicationSlotName: string
  username: string

Kolom

Jenis
Wajib atau opsional

 

Deskripsi
conditions[]
object
Opsional 		Conditions mewakili pengamatan terbaru yang tersedia tentang status entitas saat ini.
conditions[].lastTransitionTime
string
Wajib 		lastTransitionTime adalah terakhir kali kondisi bertransisi dari satu status ke status lainnya, yang terjadi saat kondisi yang mendasarinya berubah. Jika waktu perubahan kondisi yang mendasari tidak diketahui, gunakan waktu saat kolom API berubah.
conditions[].message
string
Wajib 		message adalah pesan yang dapat dibaca manusia yang menunjukkan detail tentang transisi. Nilainya bisa berupa string kosong.
conditions[].observedGeneration
integer
Opsional 		observedGeneration mewakili .metadata.generation yang menjadi dasar penetapan kondisi. Misalnya, jika .metadata.generation adalah 12, tetapi .status.conditions[x].observedGeneration adalah 9, kondisi tersebut sudah tidak sesuai dengan status instance saat ini.
conditions[].reason
string
Wajib 		reason berisi ID terprogram yang menunjukkan alasan transisi terakhir kondisi. Produsen jenis kondisi tertentu dapat menentukan nilai dan arti yang diharapkan untuk kolom ini, dan apakah nilai dianggap sebagai API terjamin. Nilai harus berupa string CamelCase. Kolom ini mungkin tidak kosong.
conditions[].status
string
Wajib 		status kondisi, salah satu dari True, False, Unknown.
conditions[].type
string
Wajib 		jenis kondisi dalam CamelCase atau di foo.example.com/CamelCase. Banyak nilai .condition.type yang konsisten di seluruh resource seperti Available. Karena kondisi arbitrer dapat berguna (lihat .node.status.conditions), kemampuan untuk menyelesaikan konflik itu penting. Ekspresi reguler yang cocok adalah (dns1123SubdomainFmt/)?(qualifiedNameFmt).
criticalIncidents[]
object
Wajib 		CriticalIncidents adalah daftar datar semua Insiden Kritis yang aktif.
criticalIncidents[].code
string
Wajib 		Code adalah kode error dari error tertentu ini. Kode error adalah string DBSE+numeric, seperti DBSE1012.
criticalIncidents[].createTime
string
Wajib 		CreateTime adalah stempel waktu saat Insiden ini dibuat di sumbernya.
criticalIncidents[].message
string
Opsional 		Message menjelaskan insiden atau error yang terjadi.
criticalIncidents[].messageTemplateParams
object
Opsional 		MessageTemplateParams berisi key-value pair yang diperlukan untuk membuat versi Pesan berbasis data yang mudah digunakan di antarmuka pengguna.
criticalIncidents[].resource
object
Wajib 		Resource berisi informasi tentang komponen Layanan Database yang melaporkan insiden, serta informasi tentang resource Kubernetes.
criticalIncidents[].resource.component
string
Wajib 		Component adalah ID internal subsistem Layanan Database yang melaporkan insiden.
criticalIncidents[].resource.location
object
Opsional 		Lokasi.
criticalIncidents[].resource.location.cluster
string
Opsional 		Nama cluster resource Kubernetes yang terpengaruh.
criticalIncidents[].resource.location.group
string
Opsional 		Nama Grup resource Kubernetes.
criticalIncidents[].resource.location.kind
string
Opsional 		Jenis resource Kubernetes.
criticalIncidents[].resource.location.name
string
Opsional 		Nama resource Kubernetes yang terpengaruh.
criticalIncidents[].resource.location.namespace
string
Opsional 		Namespace resource Kubernetes yang terpengaruh.
criticalIncidents[].resource.location.version
string
Opsional 		Versi resource Kubernetes.
criticalIncidents[].stackTrace[]
object
Opsional 		Daftar pesan tidak terstruktur dari stack trace.
criticalIncidents[].stackTrace[].component
string
Opsional 		Nama komponen Database Service yang mencatat pesan ke dalam log.
criticalIncidents[].stackTrace.message
string
Opsional 		Pesan log.
criticalIncidents[].transientUntil
string
Opsional 		TransientUntil, jika ada, menunjukkan bahwa masalah harus dianggap sementara hingga waktu yang ditentukan.
downstream
object
Opsional 		Downstream berisi status database downstream replikasi yang diamati.
downstream.physicalDownstream
object
Opsional
downstream.physicalDownstream.passwordResourceVersion
string
Opsional 		PasswordResourceVersion adalah versi resource sandi rahasia. Versi ini menunjukkan kapan sandi terakhir diperbarui di database.
downstream.physicalDownstream.setupStrategies
object
Opsional 		SetupStrategies berisi informasi tentang eksekusi setiap strategi penyiapan yang dicoba. Strategi tersebut muncul dalam daftar ini dengan urutan yang sama seperti yang ditentukan dalam spesifikasi.
downstream.physicalDownstream.setupStrategies.endedAt
string
Opsional 		EndedAt adalah waktu saat upaya terbaru dari strategi ini berakhir.
downstream.physicalDownstream.setupStrategies.message
string
Opsional 		Pesan adalah deskripsi alasan upaya penyiapan berada dalam statusnya saat ini.
downstream.physicalDownstream.setupStrategies.retries
integer
Opsional 		Percobaan ulang adalah frekuensi strategi ini dicoba ulang.
downstream.physicalDownstream.setupStrategies.startedAt
string
Opsional 		StartedAt adalah waktu saat upaya terbaru dari strategi ini dimulai.
downstream.physicalDownstream.setupStrategies.state
string
Wajib 		State adalah status strategi penyiapan ini saat ini. Nilai yang diterima:
InProgress: Strategi sedang dijalankan.
Success: Strategi telah berhasil diselesaikan dan tidak ada lagi strategi penyiapan yang akan dicoba.
Error: Strategi gagal, tetapi akan dicoba lagi. Kolom Retries akan menampilkan frekuensi percobaan ulang strategi ini.
Fallback: Strategi gagal dan tidak akan dicoba lagi. Sebagai gantinya, kita akan melakukan penggantian ke strategi berikutnya yang tersedia jika ada.
Unknown
downstream.physicalDownstream.setupStrategies.strategy
string
Wajib 		Strategi adalah nama jenis strategi yang terkait dengan status ini.
downstream.physicalDownstream.state
object
Opsional 		State adalah status replikasi seperti yang terlihat dalam tabel pg_stat_wal_receiver server database downstream.
observedgeneration
integer
Opsional 		Internal: Pembuatan yang diamati oleh pengontrol.
reconciled
boolean
Opsional 		Internal: Apakah resource direkonsiliasi oleh pengontrol.
upstream
object
Opsional 		Upstream berisi status database upstream replikasi yang diamati.
upstream.host
string
Opsional 		Host adalah endpoint koneksi database ini yang dapat diakses oleh database downstream untuk replikasi.
upstream.password
object
Opsional 		Password adalah referensi ke secret yang menyimpan sandi pengguna replikasi database ini.
upstream.password.name
string
Opsional 		name bersifat unik dalam namespace untuk mereferensikan resource secret.
upstream.password.namespace
string
Opsional 		namespace menentukan ruang tempat nama secret harus unik.
upstream.port
integer
Opsional 		Port adalah port database ini yang dapat diakses oleh database downstream untuk replikasi.
upstream.replicationslotname
string
Opsional 		ReplicationSlotName adalah nama slot replikasi yang dibuat di database ini. Database downstream dapat menggunakan slot replikasi ini untuk replikasi.
upstream.username
string
Opsional 		Username adalah nama pengguna replikasi di database ini. Database downstream dapat menggunakan pengguna ini untuk terhubung ke database ini untuk replikasi.