Résoudre les problèmes de création de clusters

Sélectionnez une version de la documentation :

Cette page explique comment résoudre les problèmes liés à AlloyDB Omni à l'aide de l'orchestrateur RPM.

Erreurs de création de cluster

Cette section liste les erreurs de création de cluster que vous pouvez rencontrer et explique comment les résoudre.

Échec de l'installation, car l'élévation des privilèges n'est pas activée

Le problème suivant se produit lorsque la variable ansible_user de votre playbook d'installation spécifie un utilisateur non root et que la lecture n'active pas l'élévation des privilèges :

This command has to be run under the root user.

Ce problème se produit, car le rôle google.alloydbomni_orchestrator.install installe des packages avec le gestionnaire de packages dnf, qui nécessite des privilèges root.

Pour résoudre ce problème, procédez comme suit :

  1. Dans votre playbook, ajoutez become: true au niveau de la lecture, comme indiqué dans Installer les composants AlloyDB Omni à l'aide d'Ansible.
  2. Vérifiez que l'utilisateur de la variable ansible_user peut exécuter sudo sur chaque nœud de l'inventaire.
  3. Exécutez à nouveau le playbook :

    ansible-playbook -i deployment_spec.yaml install.yaml

Pour vérifier que le problème est résolu, assurez-vous que la tâche Install SELinux python utilities indique ok ou changed, et que le récapitulatif de la lecture affiche failed=0 pour chaque hôte.

Échec de l'amorçage, car le répertoire de données n'existe pas sur les nœuds de base de données

Le problème suivant se produit lorsque le playbook d'amorçage expire sur tous les nœuds de base de données avec le message Timeout when waiting for DB_NODE_1:5432, et que le journal du gestionnaire de nœuds affiche une erreur liée à un répertoire de données manquant.

Pour identifier le répertoire manquant, procédez comme suit :

  1. Utilisez journalctl pour vérifier le journal du gestionnaire de nœuds :

    sudo journalctl -u alloydbomni_node_manager
  2. Recherchez dans la sortie un message semblable à celui-ci :

    service "dbprocess": root data directory does not exist: PG_DATA_DIR
    

Ces messages incluent les valeurs suivantes :

  • DB_NODE_1: adresse IP ou nom de domaine complet (FQDN) d'un nœud de base de données.
  • PG_DATA_DIR: chemin d'accès hôte au répertoire dans lequel les données de la base de données sont stockées.

Ce problème se produit, car PG_DATA_DIR n'existe pas sur tous les nœuds de base de données. L'orchestrateur s'attend à ce que le répertoire existe avant l'amorçage.

Pour résoudre ce problème, procédez comme suit :

  1. Sur chaque nœud de base de données, créez PG_DATA_DIR et installez-y le volume externe. Pour en savoir plus, consultez la section Créer un cluster.
  2. Configurez l'installation pour qu'elle persiste après les redémarrages.
  3. Exécutez à nouveau le playbook d'amorçage.

Pour vérifier que le problème est résolu, exécutez la commande suivante :

alloydbctl get -d deployment_spec.yaml -t DBCluster -n CLUSTER_NAME -o yaml

Remplacez CLUSTER_NAME par le nom de votre cluster de base de données.

La sortie affiche la DatabaseReady condition avec status: "True".

Échec de l'amorçage, car les valeurs de paramètre DBCluster ne sont pas entre guillemets

Le problème suivant se produit lorsque la section parameters de votre spécification DBCluster contient des valeurs numériques sans guillemets, et que vous exécutez le playbook qui appelle le rôle google.alloydbomni_orchestrator.bootstrap :

invalid parameters in DBCluster resource specification: json: cannot unmarshal number into Go struct field AlInstanceSpec.primarySpec.InstanceSpec.parameters of type string

Ce problème se produit, car chaque entrée du champ parameters est une paire clé-valeur de chaîne, comme décrit dans Définition de ressource personnalisée DBCluster.

Pour résoudre ce problème, procédez comme suit :

  1. Placez chaque valeur du champ spec.primarySpec.parameters entre guillemets, comme indiqué dans Préparer les spécifications du cluster :

    DBCluster:
      spec:
        primarySpec:
          parameters:
            max_connections: "100"
            max_wal_size: "2GB"
    
  2. Exécutez à nouveau le playbook d'amorçage.

Pour vérifier que le problème est résolu, exécutez la commande suivante :

alloydbctl get -d deployment_spec.yaml -t DBCluster -n CLUSTER_NAME -o yaml

Remplacez CLUSTER_NAME par le nom de votre cluster de base de données.

La sortie affiche la DatabaseReady condition avec status: "True".