Definizione di risorsa personalizzata per la replica v1.6.0

Seleziona una versione della documentazione:

Schema delle specifiche

ReplicationSpec definisce lo stato desiderato della replica.

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

Campo

Tipo
Obbligatorio o facoltativo

 

Descrizione
dbcluster
object
Facoltativo 		DBCluster è il DBCluster a cui appartiene questa replica.
dbcluster.name
string
Facoltativo 		Nome del referente. Per saperne di più, consulta Nomi.
downstream
object
Facoltativo 		Downstream contiene le specifiche per il database di replica downstream.
downstream.control
string
Obbligatorio 		Il controllo specifica l'operazione di replica da eseguire su questo database. I valori consentiti sono setup, promote e rewind.
downstream.host
string
Obbligatorio 		Host è l'endpoint di connessione del database upstream a cui questo database può accedere per la replica.
downstream.password
object
Obbligatorio 		Password è il riferimento al secret che memorizza la password dell'utente di replica del database upstream.
downstream.password.name
string
Facoltativo 		name è univoco all'interno di uno spazio dei nomi per fare riferimento a una risorsa secret.
downstream.password.namespace
string
Facoltativo 		namespace definisce lo spazio all'interno del quale il nome del secret deve essere univoco.
downstream.port
integer
Facoltativo 		Port è la porta del database upstream a cui questo database può accedere per la replica. Il valore predefinito è 5432.
downstream.replicationslotname
string
Obbligatorio 		ReplicationSlotName è il nome dello slot di replica creato nel database upstream. Viene utilizzato da questo database per la replica.
downstream.username
string
Obbligatorio 		Username è il nome dell'utente di replica creato nel database upstream. Viene utilizzato da questo database per connettersi all'upstream per la replica.
upstream
object
Facoltativo 		Upstream contiene le specifiche per il database upstream di replica.
upstream.applicationName
string
Facoltativo 		applicationName è l'identificatore della connessione di replica sincrona. Questo valore è obbligatorio se Synchronous è impostato su "true".
upstream.logReplicationSlot
boolean
Facoltativo 		Se LogReplicationSlot è impostato su true, questo slot di replica può essere scritto nei file WAL generati dall'istanza primaria.
È consigliabile abilitare questa opzione, soprattutto nelle repliche tra regioni. Assicurati che anche il DBCluster primario abbia abilitato le opzioni ReplayReplicationSlotsOnStandbys per garantire che lo slot di replica scritto nei file WAL venga riprodotto sugli standby HA.
Se attivi entrambe le opzioni, ti assicuri che in caso di failover o switchover HA sul DBCluster primario, la nuova istanza primaria HA conservi i file WAL che non sono ancora stati ricevuti dal DBCluster secondario.
Tieni presente che la modifica di questo campo comporta il riavvio del database principale.
upstream.logicalReplication
object
Facoltativo 		LogicalReplication specifica la configurazione della replica logica per lo slot di replica. Se è vuoto, lo slot di replica è configurato come slot di replica fisico.
upstream.logicalReplication.databaseName
string
Facoltativo 		DatabaseName è il database associato a questo slot. Solo le modifiche di questo database vengono trasmesse in streaming tramite lo slot.
upstream.logicalReplication.pluginName
string
Facoltativo 		PluginName è il plug-in di decodifica associato a questo slot. Per maggiori dettagli, vedi Spiegazione della decodifica logica.
upstream.password
object
Obbligatorio 		Password è il riferimento al secret che memorizza la password dell'utente di replica. Se la password non viene fornita, ne viene generata una e memorizzata in un secret mostrato nello stato.
upstream.password.name
string
Facoltativo 		name è univoco all'interno di uno spazio dei nomi per fare riferimento a una risorsa secret.
upstream.password.namespace
string
Facoltativo 		namespace definisce lo spazio all'interno del quale il nome del secret deve essere univoco.
upstream.replicationslotname
string
Facoltativo 		ReplicationSlotName è il nome dello slot di replica da utilizzare per la replica. Se non viene fornito, viene generato un nome dello slot di replica e mostrato nello stato.
upstream.synchronous
string
Facoltativo 		Synchronous specifica se lo slot di replica deve essere configurato per la replica sincrona. Se è true, applicationName viene aggiunto all'elenco degli standby sincroni. Il valore predefinito è false.
Nota: questa operazione potrebbe avere un impatto negativo sul rendimento.
upstream.username
string
Facoltativo 		Username è il nome dell'utente di replica da utilizzare per la replica. Se non viene fornito, viene generato un nome utente e mostrato nello stato.

Schema dello stato

ReplicationStatus definisce lo stato osservato della replica.

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

Campo

Tipo
Obbligatorio o facoltativo

 

Descrizione
conditions[]
object
Facoltativo 		Conditions rappresenta le ultime osservazioni disponibili dello stato attuale dell'entità.
conditions[].lastTransitionTime
string
Obbligatorio 		lastTransitionTime è l'ultima volta che la condizione è passata da uno stato all'altro, il che si verifica quando la condizione sottostante è cambiata. Se l'ora in cui è cambiata la condizione sottostante non è nota, utilizza l'ora in cui è cambiato il campo API.
conditions[].message
string
Obbligatorio 		message è un messaggio leggibile che indica i dettagli della transizione. Può essere una stringa vuota.
conditions[].observedGeneration
integer
Facoltativo 		observedGeneration rappresenta .metadata.generation in base al quale è stata impostata la condizione. Ad esempio, se .metadata.generation è 12, ma .status.conditions[x].observedGeneration è 9, la condizione non è aggiornata rispetto allo stato attuale dell'istanza.
conditions[].reason
string
Obbligatorio 		reason contiene un identificatore programmatico che indica il motivo dell'ultima transizione della condizione. I produttori di tipi di condizioni specifici possono definire i valori e i significati previsti per questo campo e se i valori sono considerati un'API garantita. Il valore deve essere una stringa CamelCase. Questo campo non può essere vuoto.
conditions[].status
string
Obbligatorio 		stato della condizione, uno tra True, False, Unknown.
conditions[].type
string
Obbligatorio 		tipo di condizione in formato CamelCase o in foo.example.com/CamelCase. Molti valori .condition.type sono coerenti tra le risorse, ad esempio Available. Poiché le condizioni arbitrarie possono essere utili (vedi .node.status.conditions), la capacità di risolvere i conflitti è importante. L'espressione regolare a cui corrisponde è (dns1123SubdomainFmt/)?(qualifiedNameFmt).
criticalIncidents[]
object
Obbligatorio 		CriticalIncidents è un elenco semplice di tutti gli incidenti critici attivi.
criticalIncidents[].code
string
Obbligatorio 		Code è il codice di errore di questo errore specifico. I codici di errore sono stringhe DBSE+numeric, ad esempio DBSE1012.
criticalIncidents[].createTime
string
Obbligatorio 		CreateTime è il timestamp di creazione di questo incidente all'origine.
criticalIncidents[].message
string
Facoltativo 		Message descrive l'incidente o l'errore che si è verificato.
criticalIncidents[].messageTemplateParams
object
Facoltativo 		MessageTemplateParams contiene le coppie chiave-valore necessarie per generare una versione di Message basata sui dati e di facile utilizzo nell'interfaccia utente.
criticalIncidents[].resource
object
Obbligatorio 		Resource contiene informazioni sul componente del servizio di database che ha segnalato l'incidente, nonché informazioni sulla risorsa Kubernetes.
criticalIncidents[].resource.component
string
Obbligatorio 		Component è un identificatore interno del sottosistema del servizio di database che ha segnalato l'incidente.
criticalIncidents[].resource.location
object
Facoltativo 		Posizione.
criticalIncidents[].resource.location.cluster
string
Facoltativo 		Il nome del cluster della risorsa Kubernetes interessata.
criticalIncidents[].resource.location.group
string
Facoltativo 		Il nome del gruppo della risorsa Kubernetes.
criticalIncidents[].resource.location.kind
string
Facoltativo 		Il tipo di risorsa Kubernetes.
criticalIncidents[].resource.location.name
string
Facoltativo 		Il nome della risorsa Kubernetes interessata.
criticalIncidents[].resource.location.namespace
string
Facoltativo 		Lo spazio dei nomi della risorsa Kubernetes interessata.
criticalIncidents[].resource.location.version
string
Facoltativo 		La versione della risorsa Kubernetes.
criticalIncidents[].stackTrace[]
object
Facoltativo 		Un elenco non strutturato di messaggi dall'analisi dello stack.
criticalIncidents[].stackTrace[].component
string
Facoltativo 		Il nome di un componente del servizio di database che ha registrato il messaggio.
criticalIncidents[].stackTrace.message
string
Facoltativo 		Messaggio registrato.
criticalIncidents[].transientUntil
string
Facoltativo 		TransientUntil, se presente, indica che il problema deve essere considerato transitorio fino all'ora specificata.
downstream
object
Facoltativo 		Downstream contiene lo stato osservato del database downstream di replica.
downstream.physicalDownstream
object
Facoltativo
downstream.physicalDownstream.passwordResourceVersion
string
Facoltativo 		PasswordResourceVersion è la versione della risorsa della password segreta. Questa versione rappresenta l'ultimo aggiornamento della password nel database.
downstream.physicalDownstream.setupStrategies
object
Facoltativo 		SetupStrategies contiene informazioni sull'esecuzione di ogni strategia di configurazione tentata. Vengono visualizzati in questo elenco nello stesso ordine in cui sono state definite le strategie nella specifica.
downstream.physicalDownstream.setupStrategies.endedAt
string
Facoltativo 		EndedAt è l'ora in cui è terminato l'ultimo tentativo di questa strategia.
downstream.physicalDownstream.setupStrategies.message
string
Facoltativo 		Il messaggio è una descrizione del motivo per cui il tentativo di configurazione si trova nello stato in cui si trova.
downstream.physicalDownstream.setupStrategies.retries
integer
Facoltativo 		Ritentativi è il numero di volte in cui è stato eseguito un nuovo tentativo di questa strategia.
downstream.physicalDownstream.setupStrategies.startedAt
string
Facoltativo 		StartedAt è l'ora in cui è stato avviato l'ultimo tentativo di questa strategia.
downstream.physicalDownstream.setupStrategies.state
string
Obbligatorio 		L'attributo state [stato] indica lo stato attuale di questa strategia di configurazione. Accetta i seguenti valori:
InProgress: la strategia è in esecuzione.
Success: la strategia è stata completata correttamente e non verranno tentate altre strategie di configurazione.
Error: La strategia non è riuscita, ma verrà riprovata. Il campo Tentativi mostra il numero di volte in cui è stato riprovato a utilizzare questa strategia.
Fallback: la strategia non è riuscita e non verrà riprovata. In alternativa, verrà utilizzata la strategia successiva disponibile, se esistente.
Unknown
downstream.physicalDownstream.setupStrategies.strategy
string
Obbligatorio 		Strategia è il nome del tipo di strategia a cui si riferisce questo stato.
downstream.physicalDownstream.state
object
Facoltativo 		Stato è lo stato della replica visualizzato nella tabella pg_stat_wal_receiver del server di database downstream.
observedgeneration
integer
Facoltativo 		Interno: la generazione osservata dal controller.
reconciled
boolean
Facoltativo 		Internal: Indica se la risorsa è stata riconciliata dal controller.
upstream
object
Facoltativo 		Upstream contiene lo stato osservato del database upstream di replica.
upstream.host
string
Facoltativo 		Host è l'endpoint di connessione di questo database a cui i database downstream possono accedere per la replica.
upstream.password
object
Facoltativo 		Password è il riferimento al secret che memorizza la password dell'utente di replica di questo database.
upstream.password.name
string
Facoltativo 		name è univoco all'interno di uno spazio dei nomi per fare riferimento a una risorsa secret.
upstream.password.namespace
string
Facoltativo 		namespace definisce lo spazio all'interno del quale il nome del secret deve essere univoco.
upstream.port
integer
Facoltativo 		Port è la porta di questo database a cui i database downstream possono accedere per la replica.
upstream.replicationslotname
string
Facoltativo 		ReplicationSlotName è il nome dello slot di replica creato in questo database. I database downstream possono utilizzare questo slot di replica per la replica.
upstream.username
string
Facoltativo 		Username è il nome dell'utente di replica su questo database. I database downstream possono utilizzare questo utente per connettersi a questo database per la replica.