Definição de recurso personalizado de Replication v1.6.0

Selecione uma versão da documentação:

Esquema de especificação

ReplicationSpec define o estado desejado de Replication.

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
Obrigatório ou opcional

 

Descrição
dbcluster
object
Opcional
DBCluster é o DBCluster ao qual esta Replication pertence.
dbcluster.name
string
Opcional
Nome do referenciador. Para mais informações, consulte Nomes.
downstream
object
Opcional
Downstream contém especificações para o banco de dados de replicação downstream.
downstream.control
string
Obrigatório
Control especifica a operação de replicação a ser realizada nesse banco de dados. Os valores permitidos são setup, promote e rewind.
downstream.host
string
Obrigatório
Host é o endpoint de conexão do banco de dados upstream que este banco de dados pode acessar para replicação.
downstream.password
object
Obrigatório
Password é a referência ao secret que armazena a senha do usuário de replicação do banco de dados upstream.
downstream.password.name
string
Opcional
name é exclusivo em um namespace para referenciar um recurso de secret.
downstream.password.namespace
string
Opcional
namespace define o espaço em que o nome do secret precisa ser exclusivo.
downstream.port
integer
Opcional
Port é a porta do banco de dados upstream que este banco de dados pode acessar para replicação. O padrão é 5.432.
downstream.replicationslotname
string
Obrigatório
ReplicationSlotName é o nome do slot de replicação criado no banco de dados upstream. Ele é usado por esse banco de dados para replicação.
downstream.username
string
Obrigatório
Username é o nome do usuário de replicação criado no banco de dados upstream. Ele é usado por esse banco de dados para se conectar ao upstream para replicação.
upstream
object
Opcional
Upstream contém a especificação do banco de dados upstream de replicação.
upstream.applicationName
string
Opcional
applicationName é o identificador da conexão de replicação síncrona. Esse valor será obrigatório se Synchronous estiver definido como "verdadeiro".
upstream.logReplicationSlot
boolean
Opcional
LogReplicationSlot, se definido como "true", permite que esse slot de replicação seja gravado em arquivos WAL gerados pela instância principal.
Recomendamos ativar essa opção, principalmente em replicações entre regiões. Verifique se o DBCluster principal também tem as opções ReplayReplicationSlotsOnStandbys ativadas para garantir que o slot de replicação gravado nos arquivos WAL seja reproduzido nos standbys de alta disponibilidade.
Ao ativar as duas opções, você garante que, em caso de failover ou troca de alta disponibilidade no DBCluster primário, a nova instância primária de alta disponibilidade retenha os arquivos WAL que ainda não foram recebidos pelo DBCluster secundário.
Observação: a modificação desse campo causa a reinicialização do banco de dados principal.
upstream.logicalReplication
object
Opcional
LogicalReplication especifica a configuração de replicação lógica para o slot de replicação. Se estiver vazio, o slot de replicação será configurado como um slot de replicação física.
upstream.logicalReplication.databaseName
string
Opcional
DatabaseName é o banco de dados associado a esse slot. Somente as alterações desse banco de dados são transmitidas pelo slot.
upstream.logicalReplication.pluginName
string
Opcional
PluginName é o plug-in de decodificação associado a esse slot. Consulte Explicação sobre a decodificação lógica para mais detalhes.
upstream.password
object
Obrigatório
Password é a referência ao secret que armazena a senha do usuário de replicação. Se Password não for fornecido, uma senha será gerada e armazenada em um secret mostrado no status.
upstream.password.name
string
Opcional
name é exclusivo em um namespace para referenciar um recurso de secret.
upstream.password.namespace
string
Opcional
namespace define o espaço em que o nome do secret precisa ser exclusivo.
upstream.replicationslotname
string
Opcional
ReplicationSlotName é o nome do slot de replicação que será usado para replicação. Se não for fornecido, um nome de slot de replicação será gerado e mostrado no status.
upstream.synchronous
string
Opcional
Synchronous especifica se o slot de replicação precisa ser configurado para replicação síncrona. Se for verdadeiro, applicationName será adicionado à lista de standbys síncronos. O padrão é false.
Observação: isso pode ter um impacto negativo no desempenho.
upstream.username
string
Opcional
Username é o nome do usuário de replicação a ser usado para a replicação. Se não for fornecido, um nome de usuário será gerado e mostrado no status.

Esquema de status

ReplicationStatus define o estado observado de Replication.

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
Obrigatório ou opcional

 

Descrição
conditions[]
object
Opcional
Conditions representa as observações mais recentes disponíveis do estado atual da entidade.
conditions[].lastTransitionTime
string
Obrigatório
lastTransitionTime é a última vez que a condição passou de um status para outro, o que ocorre quando a condição fundamental é alterada. Se o horário em que a condição fundamental foi alterada for desconhecido, use o horário em que o campo da API foi alterado.
conditions[].message
string
Obrigatório
message é uma mensagem legível por humanos que indica detalhes sobre a transição. Pode ser uma string vazia.
conditions[].observedGeneration
integer
Opcional
observedGeneration representa o .metadata.generation em que a condição foi definida. Por exemplo, se .metadata.generationfor for 12, mas .status.conditions[x].observedGeneratio for 9, a condição estará desatualizada em relação ao estado atual da instância.
conditions[].reason
string
Obrigatório
reason contém um identificador programático que indica o motivo da última transição da condição. Os produtores de tipos de condição específicos podem definir valores e significados esperados para esse campo, além de se os valores são considerados uma API garantida. O valor precisa ser uma string CamelCase. Esse campo não pode ficar vazio.
conditions[].status
string
Obrigatório
status da condição, que pode ser Verdadeiro, Falso ou Desconhecido.
conditions[].type
string
Obrigatório
tipo de condição em CamelCase ou em foo.example.com/CamelCase. Muitos valores de .condition.type são consistentes entre recursos como Available. Como condições arbitrárias podem ser úteis (consulte .node.status.conditions), a capacidade de resolver conflitos é importante. A expressão regular correspondente é (dns1123SubdomainFmt/)?(qualifiedNameFmt).
criticalIncidents[]
object
Obrigatório
CriticalIncidents é uma lista simples de todos os incidentes críticos ativos.
criticalIncidents[].code
string
Obrigatório
Code é o código desse erro específico. Os códigos de erro são strings DBSE+numeric, como DBSE1012.
criticalIncidents[].createTime
string
Obrigatório
CreateTime é o carimbo de data/hora em que esse incidente foi criado na origem.
criticalIncidents[].message
string
Opcional
Message descreve o incidente ou o erro ocorrido.
criticalIncidents[].messageTemplateParams
object
Opcional
MessageTemplateParams contém pares de chave-valor necessários para gerar uma versão orientada por dados e fácil de usar de Message na interface do usuário.
criticalIncidents[].resource
object
Obrigatório
Resource contém informações sobre o componente do Serviço de Banco de Dados que informou o incidente e informações sobre o recurso do Kubernetes.
criticalIncidents[].resource.component
string
Obrigatório
Component é um identificador interno do subsistema do Serviço de Banco de Dados que informou o incidente.
criticalIncidents[].resource.location
object
Opcional
Local.
criticalIncidents[].resource.location.cluster
string
Opcional
O nome do cluster do recurso do Kubernetes afetado.
criticalIncidents[].resource.location.group
string
Opcional
O nome do grupo do recurso do Kubernetes.
criticalIncidents[].resource.location.kind
string
Opcional
O tipo do recurso do Kubernetes.
criticalIncidents[].resource.location.name
string
Opcional
O nome do recurso do Kubernetes afetado.
criticalIncidents[].resource.location.namespace
string
Opcional
O namespace do recurso do Kubernetes afetado.
criticalIncidents[].resource.location.version
string
Opcional
A versão do recurso do Kubernetes.
criticalIncidents[].stackTrace[]
object
Opcional
Uma lista não estruturada de mensagens do stack trace.
criticalIncidents[].stackTrace[].component
string
Opcional
O nome de um componente do Serviço de Banco de Dados que registrou a mensagem.
criticalIncidents[].stackTrace.message
string
Opcional
Mensagem registrada.
criticalIncidents[].transientUntil
string
Opcional
TransientUntil, se presente, indica que o problema precisa ser considerado temporário até o horário especificado.
downstream
object
Opcional
Downstream contém o estado observado do banco de dados de replicação downstream.
downstream.physicalDownstream
object
Opcional
downstream.physicalDownstream.passwordResourceVersion
string
Opcional
PasswordResourceVersion é a versão do recurso da senha do secret. Essa versão representa a data da última atualização da senha no banco de dados.
downstream.physicalDownstream.setupStrategies
object
Opcional
SetupStrategies contém informações sobre a execução de cada estratégia de configuração usada. Elas aparecem nessa lista na mesma ordem em que foram definidas na especificação.
downstream.physicalDownstream.setupStrategies.endedAt
string
Opcional
EndedAt é o horário em que a tentativa mais recente dessa estratégia terminou.
downstream.physicalDownstream.setupStrategies.message
string
Opcional
Message é uma descrição do motivo pelo qual a tentativa de configuração está no estado atual.
downstream.physicalDownstream.setupStrategies.retries
integer
Opcional
Retries é o número de vezes que essa estratégia foi repetida.
downstream.physicalDownstream.setupStrategies.startedAt
string
Opcional
StartedAt é o horário em que a tentativa mais recente dessa estratégia foi iniciada.
downstream.physicalDownstream.setupStrategies.state
string
Obrigatório
State é o estado atual dessa estratégia de configuração. Ele aceita os seguintes valores:
InProgress: a estratégia está em execução.
Success: a estratégia foi concluída e não haverá mais nenhuma tentativa de estratégias de configuração.
Error: a estratégia falhou, mas será repetida. O campo Retries vai mostrar quantas vezes essa estratégia foi repetida.
Fallback: a estratégia falhou e não será repetida. Em vez disso, vamos recorrer à próxima estratégia disponível, se houver.
Unknown
downstream.physicalDownstream.setupStrategies.strategy
string
Obrigatório
Strategy é o nome do tipo de estratégia a que esse status se refere.
downstream.physicalDownstream.state
object
Opcional
State é o status da replicação, conforme mostrado na tabela pg_stat_wal_receiver do servidor de banco de dados downstream.
observedgeneration
integer
Opcional
Interno: a geração observada pelo controlador.
reconciled
boolean
Opcional
Interno: indica se o recurso foi reconciliado pelo controlador.
upstream
object
Opcional
Upstream contém o estado observado do banco de dados upstream de replicação.
upstream.host
string
Opcional
Host é o endpoint de conexão do banco de dados que os bancos de dados downstream podem acessar para replicação.
upstream.password
object
Opcional
Password é a referência ao secret que armazena a senha do usuário de replicação desse banco de dados.
upstream.password.name
string
Opcional
name é exclusivo em um namespace para referenciar um recurso de secret.
upstream.password.namespace
string
Opcional
namespace define o espaço em que o nome do secret precisa ser exclusivo.
upstream.port
integer
Opcional
Port é a porta do banco de dados que os bancos de dados downstream podem acessar para replicação.
upstream.replicationslotname
string
Opcional
ReplicationSlotName é o nome do slot de replicação criado neste banco de dados. Os bancos de dados downstream podem usar esse slot para replicação.
upstream.username
string
Opcional
Username é o nome do usuário de replicação nesse banco de dados. Os bancos de dados downstream podem usar esse usuário para se conectar ao banco de dados para replicação.