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 :
- Dans votre playbook, ajoutez
become: trueau niveau de la lecture, comme indiqué dans Installer les composants AlloyDB Omni à l'aide d'Ansible. - Vérifiez que l'utilisateur de la variable
ansible_userpeut exécutersudosur chaque nœud de l'inventaire. 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 :
Utilisez
journalctlpour vérifier le journal du gestionnaire de nœuds :sudo journalctl -u alloydbomni_node_managerRecherchez 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 :
- Sur chaque nœud de base de données, créez
PG_DATA_DIRet installez-y le volume externe. Pour en savoir plus, consultez la section Créer un cluster. - Configurez l'installation pour qu'elle persiste après les redémarrages.
- 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 yamlRemplacez 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 :
Placez chaque valeur du champ
spec.primarySpec.parametersentre guillemets, comme indiqué dans Préparer les spécifications du cluster :DBCluster: spec: primarySpec: parameters: max_connections: "100" max_wal_size: "2GB"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 yamlRemplacez CLUSTER_NAME par le nom de votre cluster de base de données.
La sortie affiche la DatabaseReady condition avec status: "True".