Définition de ressource personnalisée Replication v1.3.0

Sélectionnez une version de la documentation :

Schéma de spécification

ReplicationSpec définit l'état souhaité de la réplication.

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

Champ

Type
Obligatoire ou facultatif

 

Description
dbcluster
object
Facultatif
DBCluster est le DBCluster auquel appartient cette réplication.
dbcluster.name
string
Facultatif
Nom du référent. Pour en savoir plus, consultez Noms.
downstream
object
Facultatif
"Downstream" contient les spécifications de la base de données de réplication en aval.
downstream.control
string
Obligatoire
Le contrôle spécifie l'opération de réplication à effectuer sur cette base de données. Les valeurs autorisées sont "setup", "promote" et "rewind".
downstream.host
string
Obligatoire
L'hôte est le point de connexion de la base de données en amont auquel cette base de données peut accéder pour la réplication.
downstream.password
object
Obligatoire
"Password" fait référence au secret stockant le mot de passe de l'utilisateur de réplication de la base de données en amont.
downstream.password.name
string
Facultatif
Le nom est unique dans un espace de noms pour référencer une ressource secrète.
downstream.password.namespace
string
Facultatif
L'espace de noms définit l'espace dans lequel le nom du secret doit être unique.
downstream.port
integer
Facultatif
Port est le port de la base de données en amont auquel cette base de données peut accéder pour la réplication. La valeur par défaut est 5432.
downstream.replicationslotname
string
Obligatoire
ReplicationSlotName est le nom de l'emplacement de réplication créé dans la base de données en amont. Elle est utilisée par cette base de données pour la réplication.
downstream.username
string
Obligatoire
Le nom d'utilisateur correspond au nom de l'utilisateur de réplication créé sur la base de données en amont. Cette adresse est utilisée par cette base de données pour se connecter à l'amont pour la réplication.
upstream
object
Facultatif
Upstream contient les spécifications de la base de données de réplication en amont.
upstream.applicationName
string
Facultatif
applicationName est l'identifiant de la connexion de réplication synchrone. Cette valeur est obligatoire si Synchronous est défini sur "true".
upstream.logicalReplication
object
Facultatif
LogicalReplication spécifie la configuration de la réplication logique pour l'emplacement de réplication. S'il est vide, l'emplacement de réplication est configuré en tant qu'emplacement de réplication physique.
upstream.logicalReplication.databaseName
string
Facultatif
DatabaseName est la base de données associée à cet emplacement. Seules les modifications apportées à cette base de données sont diffusées via le slot.
upstream.logicalReplication.pluginName
string
Facultatif
PluginName est le plug-in de décodage associé à cet emplacement. Pour en savoir plus, consultez Explication du décodage logique.
upstream.password
object
Obligatoire
Le mot de passe est la référence au secret stockant le mot de passe de l'utilisateur de réplication. Si aucun mot de passe n'est fourni, un mot de passe est généré et stocké dans un secret affiché dans l'état.
upstream.password.name
string
Facultatif
Le nom est unique dans un espace de noms pour référencer une ressource secrète.
upstream.password.namespace
string
Facultatif
L'espace de noms définit l'espace dans lequel le nom du secret doit être unique.
upstream.replicationslotname
string
Facultatif
ReplicationSlotName est le nom de l'emplacement de réplication à utiliser pour la réplication. Si ce nom n'est pas fourni, un nom d'emplacement de réplication est généré et affiché dans l'état.
upstream.synchronous
string
Facultatif
"Synchronous" indique si l'emplacement de réplication doit être configuré pour la réplication synchrone. Si la valeur est "true", applicationName est ajouté à la liste des serveurs de secours synchrones. La valeur par défaut est false.
Remarque : Cela peut avoir un impact négatif sur les performances.
upstream.username
string
Facultatif
Le nom d'utilisateur de réplication à utiliser pour la réplication. Si aucun nom d'utilisateur n'est fourni, un nom d'utilisateur est généré et affiché dans l'état.

Schéma d'état

ReplicationStatus définit l'état observé de la réplication.

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:
    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

Champ

Type
Obligatoire ou facultatif

 

Description
conditions[]
object
Facultatif
Les conditions représentent les dernières observations disponibles de l'état actuel de l'entité.
conditions[].lastTransitionTime
string
Obligatoire
lastTransitionTime correspond à la dernière fois où la condition est passée d'un état à un autre, ce qui se produit lorsque la condition sous-jacente a changé. Si l'heure à laquelle la condition sous-jacente a changé est inconnue, utilisez l'heure à laquelle le champ d'API a changé.
conditions[].message
string
Obligatoire
"message" est un message lisible indiquant des détails sur la transition. Il peut s'agir d'une chaîne vide.
conditions[].observedGeneration
integer
Facultatif
observedGeneration représente le .metadata.generation sur lequel la condition a été définie. Par exemple, si .metadata.generation est défini sur 12, mais que .status.conditions[x].observedGeneration est défini sur 9, la condition est obsolète par rapport à l'état actuel de l'instance.
conditions[].reason
string
Obligatoire
reason contient un identifiant programmatique indiquant la raison de la dernière transition de la condition. Les producteurs de types de conditions spécifiques peuvent définir des valeurs et des significations attendues pour ce champ, et indiquer si les valeurs sont considérées comme une API garantie. La valeur doit être une chaîne CamelCase. Ce champ ne doit pas être vide.
conditions[].status
string
Obligatoire
État de la condition. Sa valeur peut être "True", "False" ou "Unknown".
conditions[].type
string
Obligatoire
type de condition au format CamelCase ou foo.example.com/CamelCase. De nombreuses valeurs .condition.type sont cohérentes entre les ressources, comme "Available" (Disponible). Étant donné que des conditions arbitraires peuvent être utiles (voir .node.status.conditions), la capacité de résolution des conflits est importante. L'expression régulière à laquelle il correspond est (dns1123SubdomainFmt/)?(qualifiedNameFmt).
criticalIncidents[]
object
Obligatoire
CriticalIncidents est une liste plate de tous les incidents critiques actifs.
criticalIncidents[].code
string
Obligatoire
"Code" correspond au code d'erreur de cette erreur spécifique. Les codes d'erreur sont des chaînes DBSE+numeric, comme DBSE1012.
criticalIncidents[].createTime
string
Obligatoire
CreateTime correspond à l'horodatage de la création de cet incident à l'origine.
criticalIncidents[].message
string
Facultatif
Le message décrit l'incident ou l'erreur qui s'est produit.
criticalIncidents[].messageTemplateParams
object
Facultatif
MessageTemplateParams contient des paires clé-valeur nécessaires pour générer une version conviviale et axée sur les données du message dans l'interface utilisateur.
criticalIncidents[].resource
object
Obligatoire
La ressource contient des informations sur le composant Database Service qui a signalé l'incident, ainsi que des informations sur la ressource Kubernetes.
criticalIncidents[].resource.component
string
Obligatoire
"Component" est un identifiant interne du sous-système du service de base de données qui a signalé l'incident.
criticalIncidents[].resource.location
object
Facultatif
Emplacement.
criticalIncidents[].resource.location.cluster
string
Facultatif
Nom du cluster de la ressource Kubernetes concernée.
criticalIncidents[].resource.location.group
string
Facultatif
Nom du groupe de la ressource Kubernetes.
criticalIncidents[].resource.location.kind
string
Facultatif
Type de la ressource Kubernetes.
criticalIncidents[].resource.location.name
string
Facultatif
Nom de la ressource Kubernetes concernée.
criticalIncidents[].resource.location.namespace
string
Facultatif
Espace de noms de la ressource Kubernetes concernée.
criticalIncidents[].resource.location.version
string
Facultatif
Version de la ressource Kubernetes.
criticalIncidents[].stackTrace[]
object
Facultatif
Liste non structurée des messages de la trace de pile.
criticalIncidents[].stackTrace[].component
string
Facultatif
Nom d'un composant du service de base de données ayant enregistré le message.
criticalIncidents[].stackTrace.message
string
Facultatif
Message enregistré.
criticalIncidents[].transientUntil
string
Facultatif
Si la valeur TransientUntil est présente, cela indique que le problème doit être considéré comme temporaire jusqu'à l'heure spécifiée.
downstream
object
Facultatif
"Downstream" contient l'état observé de la base de données de réplication en aval.
downstream.physicalDownstream
object
Facultatif
downstream.physicalDownstream.setupStrategies
object
Facultatif
SetupStrategies contient des informations sur l'exécution de chaque stratégie de configuration tentée. Elles apparaissent dans cette liste dans le même ordre que celui dans lequel elles ont été définies dans les spécifications.
downstream.physicalDownstream.setupStrategies.endedAt
string
Facultatif
EndedAt correspond à l'heure à laquelle la dernière tentative d'application de cette stratégie s'est terminée.
downstream.physicalDownstream.setupStrategies.message
string
Facultatif
Le message décrit pourquoi la tentative de configuration est dans l'état actuel.
downstream.physicalDownstream.setupStrategies.retries
integer
Facultatif
"Retries" (Tentatives) indique le nombre de fois où cette stratégie a été réessayée.
downstream.physicalDownstream.setupStrategies.startedAt
string
Facultatif
StartedAt correspond à l'heure à laquelle la dernière tentative d'application de cette stratégie a commencé.
downstream.physicalDownstream.setupStrategies.state
string
Obligatoire
L'état correspond à l'état actuel de cette stratégie de configuration. Il accepte les valeurs suivantes :
InProgress : la stratégie est en cours d'exécution.
Success : la stratégie a été exécutée avec succès et aucune autre stratégie de configuration ne sera tentée.
Error : la stratégie a échoué, mais une nouvelle tentative sera effectuée. Le champ "Nouvelles tentatives" indique le nombre de fois où cette stratégie a été réessayée.
Fallback : la stratégie a échoué et ne sera pas réessayée. À la place, nous passerons à la prochaine stratégie disponible, le cas échéant.
Unknown
downstream.physicalDownstream.setupStrategies.strategy
string
Obligatoire
"Stratégie" correspond au nom du type de stratégie auquel cet état se rapporte.
downstream.physicalDownstream.state
object
Facultatif
"État" correspond à l'état de la réplication tel qu'il apparaît dans la table pg_stat_wal_receiver du serveur de base de données en aval.
observedgeneration
integer
Facultatif
Interne : génération observée par le contrôleur.
reconciled
boolean
Facultatif
Interne : indique si la ressource a été réconciliée par le contrôleur.
upstream
object
Facultatif
"Upstream" contient l'état observé de la base de données en amont de la réplication.
upstream.host
string
Facultatif
L'hôte est le point de connexion de cette base de données auquel les bases de données en aval peuvent accéder pour la réplication.
upstream.password
object
Facultatif
Le mot de passe est la référence au secret stockant le mot de passe de l'utilisateur de réplication de cette base de données.
upstream.password.name
string
Facultatif
Le nom est unique dans un espace de noms pour référencer une ressource secrète.
upstream.password.namespace
string
Facultatif
L'espace de noms définit l'espace dans lequel le nom du secret doit être unique.
upstream.port
integer
Facultatif
Port : port de cette base de données auquel les bases de données en aval peuvent accéder pour la réplication.
upstream.replicationslotname
string
Facultatif
ReplicationSlotName est le nom de l'emplacement de réplication créé sur cette base de données. Les bases de données en aval peuvent utiliser cet emplacement de réplication pour la réplication.
upstream.username
string
Facultatif
Le nom d'utilisateur est celui de l'utilisateur de réplication sur cette base de données. Les bases de données en aval peuvent utiliser cet utilisateur pour se connecter à cette base de données à des fins de réplication.