Définition de ressource personnalisée DBInstance

Schéma de spécification

DBInstanceSpec définit l'état sélectionné de DBInstance.

DBInstance:
  metadata:
    name: string
  spec:
    dbcParent:
      name: string
    instanceType: string
    nodeCount: integer
    readPoolPort: integer
    resources:
      cpu: integer or string
      memory: string or integer
      disks:
      - name: string
        path: string
        size: string

Champ

Type
Obligatoire ou facultatif

 

Description
name
string
Obligatoire
Nom de la ressource DBInstance.
dbcParent
object
Obligatoire
DBCluster parent à partir duquel cette DBInstance est répliquée.
dbcParent.name
string
Obligatoire
Nom du référent DBCluster.
instanceType
string
(facultatif)
Indique le type de DBInstance. Accepte le type ReadPool. La valeur par défaut est ReadPool.
nodeCount
integer
(facultatif)
Détermine le nombre de DBNodes à créer pour cette DBInstance. Les valeurs acceptées sont comprises entre 0 et 20. La valeur par défaut est 1.
readPoolPort
integer
(facultatif)
Port d'interface HAProxy dédié pour un ReadPool DBInstance.
resources
object
(facultatif)
Spécifie les ressources de calcul et de stockage utilisées pour les instances (DBNodes) appartenant à cette DBInstance. Si cet objet est omis, l'instance utilise les mêmes ressources que l'instance principale de DBCluster.
resources.cpu
integer or string
Obligatoire
Quantité de processeur allouée au processus de base de données (par exemple, 2 ou "2").
resources.memory
string or integer
Obligatoire
Quantité de mémoire allouée au processus de base de données (par exemple, "6Gi").
resources.disks
list (object)
Obligatoire
Spécifications des disques alloués au processus de base de données.
resources.disks[].name
string
Obligatoire
Nom du disque. Les valeurs autorisées sont DataDisk et ObsDisk.
resources.disks[].path
string
(facultatif)
Chemin d'installation du disque sur le système de fichiers hôte.
resources.disks[].size
string
(facultatif)
Taille du disque en octets (par exemple, "15Gi").

Schéma d'état

"DBInstanceStatus" définit l'état observé de DBInstance.

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
endpoints:
- name: string
  value: string
observedGeneration: integer
reconciled: boolean

Champ

Type
Obligatoire ou facultatif

 

Description
conditions
list (object)
(facultatif)
Représente les dernières observations disponibles sur l'état actuel de DBInstance.
conditions[]
object
(facultatif)
"Condition" décrit un aspect de l'état actuel de cette ressource d'API.
conditions[].lastTransitionTime
string
Obligatoire
Indique quand la condition est passée d'un état à un autre. Si cette heure est inconnue, utilisez l'heure à laquelle le champ d'API a changé.
conditions[].message
string
Obligatoire
Chaîne lisible décrivant la transition. Cette chaîne peut être vide.
conditions[].observedGeneration
integer
(facultatif)
Représente le .metadata.generation sur lequel la condition a été définie.
conditions[].reason
string
Obligatoire
Contient un identifiant programmatique indiquant la raison de la dernière transition de la condition. La valeur est une chaîne CamelCase. Voici les valeurs attendues pour DBInstance :
  • AllDBNodesReady : DBInstance dispose du nombre requis de DBNodes prêts.
  • MinDBNodesReady : au moins le nombre minimal de DBNodes spécifié dans la spécification est prêt.
  • DBNodesNotReady : le nombre minimal de DBNodes n'est pas prêt.
  • AllDBNodesStreaming : la DBInstance dispose du nombre requis de DBNodes qui répliquent activement à partir du nœud principal.
  • MinDBNodesStreaming : au moins le nombre minimal de DBNodes sont répliqués à partir du nœud principal.
  • DBNodesNotStreaming : le nombre minimal de DBNodes ne se réplique pas.
  • NetworkReady : l'équilibreur de charge a été créé et est prêt à desservir les DBNodes.
  • NetworkNotReady : l'équilibreur de charge n'est pas prêt à desservir les nœuds de base de données.
  • DBNodesAvailable : le nombre requis de DBNodes a été provisionné et est accessible à l'aide de LoadBalancer.
  • InvalidSpec : indique qu'un élément de la spécification n'est pas valide.
conditions[].status
string
Obligatoire
État de la condition. Les valeurs valides sont True, False et Unknown.
conditions[].type
string
Obligatoire
Type de condition au format CamelCase. Voici les types de pièces d'identité acceptés :
  • DBNodesReady : indique si tous les DBNodes requis pour cette DBInstance ont été provisionnés et sont prêts.
  • Streaming : indique si les nœuds de base de données sont en cours de réplication à partir de l'instance principale.
  • NetworkReady : indique si un LoadBalancer a été créé et est prêt à desservir les DBNodes.
  • Available : indique si le nombre requis de DBNodes est provisionné et accessible à l'aide de l'équilibreur de charge.
criticalIncidents
list (object)
(facultatif)
Liste de tous les incidents critiques actifs.
criticalIncidents[]
object
(facultatif)
Décrit un incident critique en cours.
criticalIncidents[].code
string
Obligatoire
Code d'erreur. Les codes d'erreur sont des chaînes DBSE suivies d'un nombre, comme DBSE1012.
criticalIncidents[].createTime
string
Obligatoire
Code temporel d'origine de la création de l'incident.
criticalIncidents[].message
string
(facultatif)
Décrit l'incident survenu ou l'erreur qui s'est produite.
criticalIncidents[].messageTemplateParams
object
(facultatif)
Inclut des paires clé-valeur pour générer un message convivial et axé sur les données dans l'UI.
criticalIncidents[].resource
object
Obligatoire
Contient des informations sur le composant Database Service qui a signalé l'incident.
criticalIncidents[].resource.component
string
Obligatoire
Identifiant interne du sous-système Database Service qui a signalé l'incident.
criticalIncidents[].resource.location
object
(facultatif)
Emplacement de la ressource d'origine.
criticalIncidents[].resource.location.cluster
string
(facultatif)
Nom du cluster de la ressource concernée.
criticalIncidents[].resource.location.group
string
(facultatif)
Nom du groupe de ressources.
criticalIncidents[].resource.location.kind
string
(facultatif)
Type de ressource.
criticalIncidents[].resource.location.name
string
(facultatif)
Nom de la ressource concernée.
criticalIncidents[].resource.location.namespace
string
(facultatif)
Espace de noms de la ressource concernée.
criticalIncidents[].resource.location.version
string
(facultatif)
Version de la ressource.
criticalIncidents[].stackTrace
list (object)
(facultatif)
Liste non structurée des messages provenant de la trace de la pile.
criticalIncidents[].stackTrace[].component
string
(facultatif)
Nom du composant Database Service ayant enregistré le message.
criticalIncidents[].stackTrace[].message
string
(facultatif)
Message consigné.
criticalIncidents[].transientUntil
string
(facultatif)
Indique que le problème doit être considéré comme temporaire jusqu'à l'heure spécifiée.
endpoints
list (object)
(facultatif)
"Endpoints" recense tous les points de terminaison par lesquels vous pouvez accéder à cette instance.
endpoints[].name
string
Obligatoire
"name" correspond au nom du point de terminaison (par exemple, Read-Only).
endpoints[].value
string
Obligatoire
"Value" contient les informations concernant le point de terminaison pour se connecter à l'instance et y accéder.
observedGeneration
integer
(facultatif)
Génération observée par le contrôleur.
reconciled
boolean
(facultatif)
Indique si la ressource a été rapprochée par le contrôleur.