Définition de ressource personnalisée DBCluster

Schéma de spécification

DBClusterSpec définit l'état souhaité de DBCluster.

DBCluster:
  metadata:
    name: string
  spec:
    availability:
      autoFailoverTriggerThreshold: integer
      autoHealTriggerThreshold: integer
      enableAutoFailover: boolean
      enableStandbyAsReadReplica: boolean
      enableAutoHeal: boolean
      healthcheckPeriodSeconds: integer
      replayReplicationSlotsOnStandbys: boolean
      numberOfStandbys: integer

    databaseVersion: string
    loadBalancerPort: integer
    readOnlyPort: integer
    primarySpec:
      adminUser:
        passwordRef:
          name: string
      dbLoadBalancerOptions:
        gcp:
          loadBalancerIP: string
          loadBalancerType: string
          loadBalancerInterface: string
        onprem:
          loadBalancerIP: string
          loadBalancerType: string
          loadBalancerInterface: string
      features:
        columnarSpillToDisk:
          cacheSize: string
          localVolume:
            path: string
        ultraFastCache:
          cacheSize: string
          localVolume:
            path: string
        googleMLExtension:
          enabled: boolean
          config:
            vertexAIKeyRef: string
            vertexAIRegion: string
      monitorPort: integer
      parameters: object
      port: integer
      resources:
        cpu: integer or string
        memory: string or integer
        limits:
          memory: string or integer
        disks:
        - name: string
          path: string

    tls:
      certSecret:
        name: string

Champ

Type
Obligatoire ou facultatif

 

Description
availability
object
(facultatif)
"Availability" contient des paramètres ajustables pour les fonctionnalités de haute disponibilité (HA) de DBCluster.
availability.autoFailoverTriggerThreshold
integer
(facultatif)
"AutoFailoverTriggerThreshold" correspond au nombre d'échecs consécutifs de vérification de l'état sur l'instance principale entraînant un basculement automatique. Si la valeur est définie sur 0, la valeur par défaut du système est utilisée. Utilisez le flag "EnableAutoFailover" pour désactiver le basculement automatique.
availability.autoHealTriggerThreshold
integer
(facultatif)
"AutoHealTriggerThreshold" correspond au nombre d'échecs consécutifs de vérification de l'état des instances de secours entraînant une réparation automatique. Pour désactiver la réparation automatique, utilisez le flag EnableAutoHeal. La valeur par défaut est 5.
availability.enableAutoFailover
boolean
(facultatif)
"EnableAutoFailover" signifie que ce DBCluster déclenchera un basculement s'il détecte que l'instance principale n'est pas opérationnelle et que l'instance de secours l'est. Si la valeur est "true", le basculement automatique est activé. Si la valeur est définie sur "false", le basculement automatique n'est pas déclenché, même si le système détecte que l'instance principale n'est pas opérationnelle. La valeur par défaut est "true". Lorsque ce paramètre est activé, si le système détecte que l'instance principale n'est pas opérationnelle selon le seuil indiqué, il déclenche un basculement. Cette fonctionnalité ne s'applique que s'il s'agit d'un DBCluster haute disponibilité (HA) et si l'instance de secours est opérationnelle.
availability.enableStandbyAsReadReplica
boolean
(facultatif)
EnableStandbyAsReadReplica détermine si les instances de secours peuvent accepter ou non les requêtes des utilisateurs. Si la valeur est définie sur "true", un point de terminaison est créé pour permettre l'accès en lecture seule aux instances de secours.
availability.enableAutoHeal
boolean
(facultatif)
"EnableAutoHeal" signifie que ce DBCluster déclenchera une autoréparation s'il détecte que l'instance de secours n'est pas opérationnelle. Si ce paramètre est défini sur "true", l'autoréparation est activée. S'il est défini sur "false", l'autoréparation n'est pas déclenchée, même si le système détecte que l'instance de secours n'est pas opérationnelle. La valeur par défaut est "true". Lorsque ce paramètre est activé, si le système détecte que l'instance de secours n'est pas opérationnelle selon le seuil indiqué, il déclenche une autoréparation. Cette fonctionnalité ne s'applique que s'il s'agit d'un DBCluster haute disponibilité.
availability.healthcheckPeriodSeconds
integer
(facultatif)
"HealthcheckPeriodSeconds" correspond au nombre de secondes pendant lesquelles le vérificateur d'état attend avant de vérifier à nouveau l'état des instances principale et de secours, puis de mettre à jour l'état en conséquence.
availability.replayReplicationSlotsOnStandbys
boolean
(facultatif)
Si vous définissez replayReplicationSlotsOnStandbys sur "true", les instances de secours à haute disponibilité peuvent relire les emplacements de réplication à partir des fichiers WAL. Nous vous recommandons également d'activer le champ "LogReplicationSlot" sur les ressources de réplication en amont afin que les emplacements de réplication correspondants soient consignés dans les fichiers WAL. Cette configuration permet de confirmer qu'en cas de basculement ou de permutation à haute disponibilité sur le DBCluster principal, la nouvelle instance principale à haute disponibilité conserve les fichiers WAL qui n'ont pas encore été utilisés par ces emplacements de réplication. Notez que la modification de ce champ entraîne le redémarrage de toutes les instances de secours HA.
availability.numberOfStandbys
integer
(facultatif)
"NumberOfStandbys" correspond au nombre d'instances de secours à créer pour ce DBCluster. Si la valeur est supérieure à 0, la haute disponibilité est activée sur le cluster et le système crée le nombre d'instances de secours indiqué. Le nombre maximal d'instances de secours autorisé est de cinq. Pour vérifier l'état actuel de la haute disponibilité sur ce DBCluster, contrôlez la condition "HAReady" sous l'état du DBCluster. Si "HAReady" est défini sur "true", la configuration est terminée et prête. Si la valeur est définie sur 0, la haute disponibilité est désactivée sur le cluster et toutes les instances de secours existantes sont supprimées. Tout nombre compris entre 0 et 5 inclus est accepté. La valeur par défaut est 0.
databaseVersion
string
Obligatoire
"DatabaseVersion" est la version de base de données souhaitée pour le cluster (par exemple, "18.1.0"). Ce champ est obligatoire. Cette version est appliquée à toutes les instances du cluster de bases de données.
loadBalancerPort
integer
(facultatif)
LoadBalancerPort spécifie le port de l'interface de l'équilibreur de charge. Si aucune valeur n'est spécifiée, la valeur par défaut est primarySpec.port (si elle est spécifiée) ou 5432.
readOnlyPort
integer
(facultatif)
ReadOnlyPort spécifie le port du point de terminaison en lecture seule lorsque availability.enableStandbyAsReadReplica est défini sur "true". Si elle n'est pas spécifiée, la valeur par défaut est primarySpec.port + 1, ou max(loadBalancerPort, primarySpec.port) + 1 si elles sont différentes.
primarySpec
object
Obligatoire
"PrimarySpec" contient les spécifications de l'instance principale du cluster de bases de données. L'instance principale contient les ressources de calcul et de stockage qui desservent les points de terminaison en lecture/écriture du cluster de bases de données.
primarySpec.adminUser
object
Obligatoire
"AdminUser" représente la spécification de l'administrateur. Il s'agit de l'utilisateur de base de données initial créé par le plan de contrôle. Les utilisateurs de base de données supplémentaires sont gérés directement par l'utilisateur final. Ce champ peut également être utilisé pour réinitialiser le mot de passe de l'utilisateur initial.
primarySpec.adminUser.passwordRef
object
Obligatoire
"PasswordRef" est le nom du secret contenant le mot de passe de l'administrateur. Cette valeur est utilisée lors du provisionnement initial ou de la réinitialisation du mot de passe pour définir le mot de passe de l'administrateur. Le secret doit se trouver dans le même projet que le cluster de bases de données. Le nom du secret doit suivre le modèle db-pw-. De plus, la clé du mot de passe (dans le secret) doit être identique au nom du cluster de bases de données.
primarySpec.adminUser.passwordRef.name
string
Obligatoire
Nom du référent.
primarySpec.dbLoadBalancerOptions
object
(facultatif)
DBLoadBalancerOptions permet aux utilisateurs de fournir des informations sur l'équilibreur de charge B.
primarySpec.dbLoadBalancerOptions.gcp
object
(facultatif)
Contient des attributs spécifiques à Google Cloud pour l'équilibreur de charge.
primarySpec.dbLoadBalancerOptions.gcp.loadBalancerIP
string
(facultatif)
"LoadBalancerIP" est une adresse IP statique. Pour en savoir plus, consultez Configurer des adresses IP externes statiques.
primarySpec.dbLoadBalancerOptions.gcp.loadBalancerType
string
(facultatif)
Un équilibreur de charge peut être interne ou externe.
primarySpec.dbLoadBalancerOptions.gcp.loadBalancerInterface
string
(facultatif)
LoadBalancerInterface est l'interface réseau à utiliser par LoadBalancer.
primarySpec.dbLoadBalancerOptions.onprem
object
(facultatif)
Contient des attributs sur site pour l'équilibreur de charge.
primarySpec.dbLoadBalancerOptions.onprem.loadBalancerIP
string
(facultatif)
"LoadBalancerIP" est une adresse IP statique.
primarySpec.dbLoadBalancerOptions.onprem.loadBalancerType
string
(facultatif)
Un équilibreur de charge peut être interne ou externe.
primarySpec.dbLoadBalancerOptions.onprem.loadBalancerInterface
string
(facultatif)
LoadBalancerInterface est l'interface réseau à utiliser par LoadBalancer.
primarySpec.features
object
(facultatif)
Spécification de la fonctionnalité.
primarySpec.features.columnarSpillToDisk
object
(facultatif)
Spécification du déversement de colonnes sur le disque.
primarySpec.features.columnarSpillToDisk.cacheSize
string
(facultatif)
Taille du cache pour le déversement sur disque en colonnes.
primarySpec.features.columnarSpillToDisk.localVolume
object
(facultatif)
Configuration du volume local.
primarySpec.features.columnarSpillToDisk.localVolume.path
string
(facultatif)
Chemin d'accès au répertoire local.
primarySpec.features.ultraFastCache
object
(facultatif)
Spécifications du cache ultrarapide.
primarySpec.features.ultraFastCache.cacheSize
string
(facultatif)
Taille du cache ultrarapide.
primarySpec.features.ultraFastCache.localVolume
object
(facultatif)
Configuration du volume local pour un cache ultrarapide.
primarySpec.features.ultraFastCache.localVolume.path
string
(facultatif)
Chemin d'accès au répertoire local du cache ultrarapide.
primarySpec.features.googleMLExtension
object
(facultatif)
Spécifications de l'extension d'intégration Google Machine Learning (ML) (google_ml_integration), qui permet d'utiliser des fonctions d'IA et de s'intégrer à des modèles distants. Pour en savoir plus, consultez la présentation d'AlloyDB AI.
primarySpec.features.googleMLExtension.config
object
(facultatif)
Configuration de l'extension d'intégration Google Machine Learning (ML).
primarySpec.features.googleMLExtension.config.vertexAIKeyRef
string
(facultatif)
Référence à la clé secrète pour Gemini Enterprise Agent Platform.
primarySpec.features.googleMLExtension.config.vertexAIRegion
string
(facultatif)
Région pour Gemini Enterprise Agent Platform.
primarySpec.features.googleMLExtension.enabled
boolean
Obligatoire
Active l'extension Google ML.
primarySpec.monitorPort
integer
(facultatif)
MonitorPort est le numéro de port sur lequel l'agent de surveillance écoute.
primarySpec.parameters
object
(facultatif)
Utilisez parameters pour configurer les indicateurs du moteur de base de données et les paramètres d'exécution de votre cluster de bases de données. Chaque entrée est spécifiée sous forme de paire clé/valeur, où la clé correspond au nom du paramètre du moteur et la valeur est placée entre guillemets (par exemple, work_mem: "64MB").
primarySpec.port
integer
(facultatif)
Port est le numéro de port sur lequel la base de données écoute.
primarySpec.resources
object
Obligatoire
Spécification des ressources pour le processus de base de données. Lorsque l'un des champs de la ressource change, l'opérateur redémarre l'instance de base de données avec la nouvelle spécification de ressource.
primarySpec.resources.cpu
integer or string
Obligatoire
Quantité de ressources processeur allouée au processus de base de données.
primarySpec.resources.disks
object
Obligatoire
Spécifications des disques alloués au processus de base de données.
primarySpec.resources.disks.name
string
Obligatoire
Nom du disque. Ce champ est obligatoire. Les valeurs autorisées sont DataDisk et ObsDisk.
primarySpec.resources.disks.path
string
Obligatoire
Chemin d'accès où le disque sera installé sur le système de fichiers
primarySpec.resources.limits
object
(facultatif)
Limites de ressources pour le processus de base de données.
primarySpec.resources.limits.memory
string or integer
(facultatif)
Quantité maximale de mémoire allouée au processus de base de données.
primarySpec.resources.memory
string or integer
Obligatoire
Quantité de mémoire allouée au processus de base de données.
tls
object
(facultatif)
TLS est la configuration de certificat de serveur souhaitée pour le cluster. Par défaut, ce champ est vide et une nouvelle autorité de certification autosignée ainsi qu'un nouveau certificat d'entité finale sont générés pour le cluster.
tls.certSecret
object
(facultatif)
"CertSecret" fait référence au secret du certificat dans le même espace de noms. Le secret doit contenir les entrées ca.crt (certificat de l'autorité de certification), tls.key (clé privée du serveur) et tls.crt (certificat d'entité finale du serveur). Ce secret est utilisé pour définir la configuration TLS des instances de base de données qui font partie du cluster de bases de données.
tls.certSecret.name
string
(facultatif)
Nom du référent.

Schéma d'état

"DBClusterStatus" définit l'état observé de DBCluster.

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
latestFailoverStatus:
  failoverName: string
  status:
    conditions:
    - lastTransitionTime: string
      message: string
      observedGeneration: integer
      reason: string
      status: string
      type: string
    createTime: 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
  endTime: string
  internal:
    attempt: integer
    lastPhaseChangeTime: string
    newPrimary: string
    newPrimaryZone: string
    oldPrimary: string
    phase: string
  observedGeneration: integer
  reconciled: boolean
  startTime: string
  state: string
observedGeneration: integer
phase: string
primary:
  allocatedResources:
    cpu: integer or string
    memory: integer or string
  conditions:
  - lastTransitionTime: string
    message: string
    observedGeneration: integer
    reason: string
    status: string
    type: string
  endpoint: string
  endpoints:
  - name: string
    value: string
  monitorPort: integer
  parameters: object
  phase: string
  port: integer
  resources:
    cpu: integer or string
    memory: string or integer
    limits:
      memory: string or integer
    disks:
    - name: string
      path: string
  url: string
reconciled: boolean

Champ

Type
Obligatoire ou facultatif

 

Description
conditions
list (object)
(facultatif)
"Conditions" représente les dernières observations disponibles pour l'état actuel de l'entité.
conditions[]
object
(facultatif)
"Conditions" contient des informations sur un aspect de l'état actuel de cette ressource d'API.
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 vous ne connaissez pas l'heure à laquelle la condition sous-jacente a changé, utilisez l'heure à laquelle le champ d'API a changé.
conditions[].message
string
Obligatoire
"message" est un message lisible par l'humain 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 et 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 les valeurs et les 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 (par exemple, "Available"), mais comme des conditions arbitraires peuvent être utiles (voir .node.status.conditions), il est important de pouvoir résoudre les conflits. L'expression régulière à laquelle ce type correspond est (dns1123SubdomainFmt/)?(qualifiedNameFmt).
criticalIncidents
object
(facultatif)
"CriticalIncidents" est une liste plate de tous les incidents critiques actifs.
criticalIncidents[]
object
(facultatif)
"CriticalIncident" contient toutes les informations sur un incident critique en cours.
criticalIncidents[].code
string
Obligatoire
"Code" correspond au code d'erreur de cette erreur spécifique. Les codes d'erreur sont des chaînes DBSE suivies d'un nombre, comme "DBSE1012".
criticalIncidents[].createTime
string
Obligatoire
"CreateTime" correspond au code temporel d'origine de la création de cet incident.
criticalIncidents[].message
string
(facultatif)
"Message" décrit l'incident survenu ou l'erreur qui s'est produite.
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 de 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)
"Cluster" est le nom du cluster de la ressource Kubernetes concernée.
criticalIncidents[].resource.location.group
string
(facultatif)
"Group" est le nom du groupe de la ressource Cluster Manager.
criticalIncidents[].resource.location.kind
string
(facultatif)
"Kind" correspond au genre de la ressource Kubernetes.
criticalIncidents[].resource.location.name
string
(facultatif)
"Name" correspond au nom de la ressource Kubernetes concernée.
criticalIncidents[].resource.location.namespace
string
(facultatif)
"Namespace" correspond à l'espace de noms de la ressource Kubernetes concernée.
criticalIncidents[].resource.location.version
string
(facultatif)
"Group" correspond à la version de la ressource Kubernetes.
criticalIncidents[].stackTrace
object
(facultatif)
"StackTrace" contient une liste non structurée de messages provenant de la trace de la pile.
criticalIncidents[].stackTrace.component
string
(facultatif)
"Component" est le nom d'un composant du service de base de données qui a consigné le message.
criticalIncidents[].stackTrace.message
string
(facultatif)
Message consigné.
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.
latestFailoverStatus
object
(facultatif)
"LatestFailoverStatus" correspond à l'état du basculement le plus récemment mis à jour pour le cluster de bases de données. Il s'agit d'une copie de l'état de l'opération de basculement actuelle ou la plus récemment mise à jour pour le cluster de bases de données. Cet élément peut être utilisé pour surveiller l'état d'une opération de basculement en cours d'exécution.
latestFailoverStatus.failoverName
string
(facultatif)
"FailoverName" correspond au nom du dernier basculement.
latestFailoverStatus.status
object
(facultatif)
"Status" représente l'état du dernier basculement pour le cluster de bases de données.
latestFailoverStatus.status.conditions
object
(facultatif)
"Conditions" représente les dernières observations disponibles pour l'état actuel de l'entité.
latestFailoverStatus.status.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 cette valeur n'est pas connue, vous pouvez utiliser l'heure à laquelle le champ d'API a changé.
latestFailoverStatus.status.conditions.message
string
Obligatoire
"message" est un message lisible par l'humain indiquant des détails sur la transition. Il peut s'agir d'une chaîne vide.
latestFailoverStatus.status.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.
latestFailoverStatus.status.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 les valeurs et les 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 peut pas être vide.
latestFailoverStatus.status.conditions.status
string
Obligatoire
État de la condition. Sa valeur peut être "True", "False" ou "Unknown".
latestFailoverStatus.status.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 (par exemple, "Available"), mais comme des conditions arbitraires peuvent être utiles (voir .node.status.conditions), il est important de pouvoir résoudre les conflits. L'expression régulière à laquelle ce type correspond est (dns1123SubdomainFmt/)?(qualifiedNameFmt).
latestFailoverStatus.status.createTime
string
(facultatif)
"CreateTime" correspond à l'heure à laquelle le mécanisme interne de workflow de basculement a été créé.
latestFailoverStatus.status.criticalIncidents
object
(facultatif)
"CriticalIncidents" est une liste plate de tous les incidents critiques actifs.
latestFailoverStatus.status.criticalIncidents.code
string
Obligatoire
"Code" correspond au code d'erreur de cette erreur spécifique. Les codes d'erreur sont des chaînes DBSE suivies d'un nombre, comme "DBS1012".
latestFailoverStatus.status.criticalIncidents.createTime
string
Obligatoire
"CreateTime" correspond au code temporel d'origine de la création de cet incident.
latestFailoverStatus.status.criticalIncidents.message
string
(facultatif)
"Message" décrit l'incident survenu ou l'erreur qui s'est produite.
latestFailoverStatus.status.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 de Message dans l'interface utilisateur.
latestFailoverStatus.status.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 Cluster Manager.
latestFailoverStatus.status.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.
latestFailoverStatus.status.criticalIncidents.resource.location
object
(facultatif)
Emplacement
latestFailoverStatus.status.criticalIncidents.resource.location.cluster
string
(facultatif)
"Cluster" est le nom du cluster de la ressource Cluster Manager concernée.
latestFailoverStatus.status.criticalIncidents.resource.location.group
string
(facultatif)
"Group" est le nom du groupe de la ressource Cluster Manager.
latestFailoverStatus.status.criticalIncidents.resource.location.kind
string
(facultatif)
"Kind" correspond au genre de la ressource Cluster Manager.
latestFailoverStatus.status.criticalIncidents.resource.location.name
string
(facultatif)
"Name" correspond au nom de la ressource Cluster Manager concernée.
latestFailoverStatus.status.criticalIncidents.resource.location.namespace
string
(facultatif)
"Namespace" correspond à l'espace de noms de la ressource Cluster Manager concernée.
latestFailoverStatus.status.criticalIncidents.resource.location.version
string
(facultatif)
"Group" correspond à la version de la ressource Cluster Manager.
latestFailoverStatus.status.criticalIncidents.stackTrace
object
(facultatif)
"StackTrace" contient une liste non structurée de messages provenant de la trace de la pile.
latestFailoverStatus.status.criticalIncidents.stackTrace.component
string
(facultatif)
"Component" est le nom d'un composant du service de base de données qui a consigné le message.
latestFailoverStatus.status.criticalIncidents.stackTrace.message
string
(facultatif)
Message consigné.
latestFailoverStatus.status.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.
latestFailoverStatus.status.endTime
string
(facultatif)
"EndTime" correspond à l'heure à laquelle le basculement a atteint son état final.
latestFailoverStatus.status.internal
object
(facultatif)
"Internal" est utilisé par les contrôleurs système. Ne vous fiez pas aux informations de cette section.
latestFailoverStatus.status.internal.attempt
integer
Obligatoire
"Attempt" est utilisé pour la logique de nouvelle tentative. La valeur par défaut est 0.
latestFailoverStatus.status.internal.lastPhaseChangeTime
string
(facultatif)
"LastPhaseChangeTime" correspond à la dernière fois où le basculement L1 est passé à une nouvelle phase. Cet élément est utilisé pour la logique de délai avant expiration.
latestFailoverStatus.status.internal.newPrimary
string
Obligatoire
"NewPrimary" est l'instance vers laquelle vous tentez d'effectuer un basculement.
latestFailoverStatus.status.internal.newPrimaryZone
string
(facultatif)
"NewPrimaryZone" est la zone vers laquelle vous tentez d'effectuer le basculement.
latestFailoverStatus.status.internal.oldPrimary
string
Obligatoire
"OldPrimary" est l'instance qui avait le statut d'instance principale au début du basculement.
latestFailoverStatus.status.internal.phase
string
(facultatif)
"Phase" permet de suivre l'état actuel du basculement.
latestFailoverStatus.status.observedGeneration
integer
(facultatif)
Génération observée par le contrôleur.
latestFailoverStatus.status.reconciled
boolean
(facultatif)
Indique si la ressource a été rapprochée par le contrôleur.
latestFailoverStatus.status.startTime
string
(facultatif)
"StartTime" correspond à l'heure de début de l'opération de basculement.
latestFailoverStatus.status.state
string
(facultatif)
"State" correspond à l'état actuel de l'opération de basculement. Les valeurs sont "InProgress", "Success" et "Failed". "InProgress" signifie que le basculement est toujours en cours. "Success" signifie que le basculement a été effectué. Cette étape est terminée lorsque la nouvelle instance principale est promue. "Failed" signifie que l'opérateur n'a pas pu promouvoir la nouvelle instance principale. Le DBCluster devra peut-être être réparé manuellement.
observedGeneration
integer
(facultatif)
Interne : génération observée par le contrôleur.
phase
string
(facultatif)
"Phase" est un récapitulatif de l'état actuel du DBCluster.
primary
object
(facultatif)
"Primary" contient l'état de l'instance principale.
primary.adminUser.passwordRef.name
string
(facultatif)
Nom du référent.
primary.allocatedResources
object
(facultatif)
"AllocatedResources" représente la configuration actuelle de la mémoire, de processeur et de disques.
primary.allocatedResources.cpu
integer or string
Obligatoire
Quantité de ressources processeur allouée au processus de base de données.
primary.allocatedResources.memory
string or integer
Obligatoire
Quantité de mémoire allouée au processus de base de données.
primary.conditions
object
Obligatoire
Les conditions représentent les dernières observations disponibles de l'état actuel de l'instance.
primary.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 vous ne connaissez pas l'heure à laquelle la condition sous-jacente a changé, vous pouvez utiliser l'heure à laquelle le champ d'API a changé.
primary.conditions.message
string
Obligatoire
"message" est un message lisible par l'humain indiquant des détails sur la transition. Il peut s'agir d'une chaîne vide.
primary.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.
primary.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 les valeurs et les 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.
primary.conditions.status
string
Obligatoire
État de la condition. Sa valeur peut être "True", "False" ou "Unknown".
primary.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 (par exemple, "Available"), mais comme des conditions arbitraires peuvent être utiles (voir .node.status.conditions), il est important de pouvoir résoudre les conflits. L'expression régulière à laquelle ce type correspond est (dns1123SubdomainFmt/)?(qualifiedNameFmt).
primary.endpoint
string
(facultatif)
"Endpoint" est l'adresse que vous pouvez utiliser pour établir des connexions à la base de données. Obsolète : utilisez le champ "Endpoints" à la place.
primary.endpoints
object
(facultatif)
"Endpoints" recense tous les points de terminaison par lesquels vous pouvez accéder à cette instance.
primary.endpoints.name
string
Obligatoire
"Name" contient le nom du point de terminaison.
primary.endpoints.value
string
(facultatif)
"Value" contient les informations concernant le point de terminaison.
primary.endpoints.value
string
(facultatif)
"Value" contient les informations concernant le point de terminaison.
primary.monitorPort
integer
(facultatif)
MonitorPort est le numéro de port sur lequel l'agent de surveillance écoute.
primary.currentParameters
object
(facultatif)
CurrentParameters indique les valeurs actuelles des paramètres. CurrentParameters vous permet de vérifier que le champ spec.primarySpec.parameters est appliqué à la base de données. Seuls les noms de paramètres se trouvant dans spec.primarySpec.parameters sont inclus dans ce champ.
primary.port
integer
(facultatif)
Port est le numéro de port sur lequel la base de données écoute.
primary.phase
string
(facultatif)
"Phase" est un récapitulatif de l'état actuel de l'instance.
primary.resources
object
(facultatif)
Spécification des ressources pour le processus de base de données.
primary.resources.cpu
integer or string
(facultatif)
Quantité de ressources processeur allouée au processus de base de données.
primary.resources.disks
list (object)
(facultatif)
Spécifications des disques alloués au processus de base de données.
primary.resources.disks[]
object
(facultatif)
Spécification du disque.
primary.resources.disks[].name
string
(facultatif)
Nom du disque.
primary.resources.disks[].path
string
(facultatif)
Chemin d'installation du disque sur le système de fichiers.
primary.resources.limits
object
(facultatif)
Limites de ressources pour le processus de base de données.
primary.resources.limits.memory
string or integer
(facultatif)
Quantité maximale de mémoire allouée au processus de base de données.
primary.resources.memory
string or integer
(facultatif)
Quantité de mémoire allouée au processus de base de données.
reconciled
boolean
(facultatif)
Indique si la ressource a été rapprochée par le contrôleur.