Cette page explique comment examiner les problèmes de création d'un cluster d'utilisateur Google Distributed Cloud Virtual for Bare Metal dans la console Google Cloud.
L'API GKE On-Prem est une API hébergée par Google Cloud qui vous permet de gérer le cycle de vie de vos clusters sur site à l'aide de Terraform et des outils Google Cloud standards. L'API GKE On-Prem s'exécute dans l'infrastructure de Google Cloud. Terraform, la console Google Cloud et la Google Cloud CLI sont les clients de l'API. Elles l'utilisent pour créer, mettre à jour, mettre à niveau et supprimer des clusters dans votre centre de données. Si vous avez créé le cluster à l'aide d'un client standard, celui-ci est enregistré dans l'API GKE On-Prem, ce qui signifie que vous pouvez utiliser les clients standards pour gérer le cycle de vie du cluster (à quelques exceptions près).
Si vous avez besoin d'une aide supplémentaire, contactez Cloud Customer Care.
Erreurs de création de cluster
Cette section décrit certaines erreurs qui se produisent lors de la création du cluster dans la console Google Cloud.
Erreur "La ressource existe déjà"
La création du cluster d'utilisateur échoue et un message d'erreur semblable à celui-ci s'affiche :
Resource 'projects/1234567890/[...]/user-cluster1'
already exists
Request ID: 129290123128705826
Ce message d'erreur indique que le nom du cluster est déjà utilisé.
Pour résoudre ce problème, vous pouvez supprimer et recréer le cluster:
- Supprimez le cluster.
- Recréez le cluster en lui attribuant un autre nom qui n'entre pas en conflit avec celui d'un cluster existant.
Erreur de conflit d'adresses IP
La création du cluster d'utilisateur échoue et un message d'erreur semblable à celui-ci s'affiche :
- Validation Category: Network Configuration
- [FAILURE] CIDR, VIP and static IP (availability and overlapping): user: user
cluster control plane VIP "10.251.133.132" overlaps with
example-cluster1/control plane VIP "10.251.133.132"
Vous ne pouvez pas modifier des champs tels que l'adresse IP virtuelle du plan de contrôle et l'adresse IP virtuelle d'entrée dans la section Équilibreur de charge de la page Détails du cluster dans la console Google Cloud. Pour résoudre les conflits d'adresses IP, supprimez et recréez le cluster:
- Supprimez le cluster.
- Recréez le cluster en utilisant des adresses IP qui n'entrent pas en conflit avec un cluster existant.
Supprimer les clusters non opérationnels
Un cluster peut devenir non opérationnel pour de nombreuses raisons, par exemple:
- Problèmes de connectivité avec l'agent Connect ou l'environnement sur site.
- Le cluster d'administrateur d'un cluster d'utilisateur a été supprimé, ou il existe des problèmes de connectivité entre les clusters d'administrateur et d'utilisateur.
Si la console ne parvient pas à supprimer un cluster, exécutez les commandes de la gcloud CLI pour supprimer les ressources Google Cloud des clusters non opérationnels. Si vous n'avez pas récemment mis à jour la gcloud CLI, exécutez la commande suivante pour mettre à jour les composants:
gcloud components update
Supprimez ensuite les ressources Google Cloud.
Cluster d'utilisateur
Supprimez le cluster d'utilisateur:
gcloud container bare-metal clusters delete USER_CLUSTER_NAME \ --project=PROJECT_ID \ --location=REGION \ --force \ --allow-missing \ --ignore-errors
Remplacez les éléments suivants :
USER_CLUSTER_NAME: nom du cluster d'utilisateur à supprimer.PROJECT_ID: ID du projet dans lequel le cluster est enregistré.REGION: emplacement Google Cloud associé au cluster d'utilisateur. L'emplacement s'affiche dans la console.L'option
--forcesupprime un cluster contenant des pools de nœuds. Sans l'option--force, vous devez d'abord supprimer les pools de nœuds, puis supprimer le cluster.L'option
--allow-missingpermet de poursuivre la commande si le cluster est introuvable.L'option
--ignore-errorssupprime les ressources Google Cloud lorsque les clusters d'administrateur et d'utilisateur sont inaccessibles.Cette commande supprime le cluster s'il existe, ainsi que l'API GKE On-Prem et les ressources d'appartenance au parc de Google Cloud.
Vérifiez que les ressources de l'API GKE On-Prem ont été supprimées:
gcloud container bare-metal clusters list \ --project=PROJECT_ID \ --location=-
Lorsque vous définissez
--location=-, cela signifie que tous les clusters de toutes les régions sont répertoriés. Si vous devez limiter la liste, définissez--locationsur une région spécifique.Vérifiez que les ressources d'appartenance au parc ont été supprimées:
gcloud container fleet memberships list \ --project=PROJECT_ID
Cluster d'administrateur
Si vous avez enregistré le cluster d'administrateur dans l'API GKE On-Prem, annulez son enregistrement:
gcloud container bare-metal admin-clusters unenroll ADMIN_CLUSTER_NAME \ --project=PROJECT_ID \ --location=REGION \ --allow-missing --ignore-errors
Remplacez les éléments suivants :
ADMIN_CLUSTER_NAME: nom du cluster d'administrateur.PROJECT_ID: ID du projet hôte du parc.REGION: région Google Cloud.
L'option
--allow-missingannule l'enregistrement du cluster si l'appartenance au parc est introuvable.L'option
--ignore-errorssupprime les ressources Google Cloud lorsque les clusters d'administrateur et d'utilisateur sont inaccessibles.Cette commande supprime les ressources de l'API GKE On-Prem de Google Cloud.
Supprimez le cluster du parc:
gcloud container fleet memberships delete ADMIN_CLUSTER_NAME \ --project=PROJECT_ID \ --location=global
Cette commande supprime de Google Cloud les ressources d'appartenance au parc.
Vérifiez que les ressources de l'API GKE On-Prem ont été supprimées:
gcloud container fleet memberships delete ADMIN_CLUSTER_NAME --project=FLEET_HOST_PROJECT_ID
Lorsque vous définissez
--location=-, cela signifie que tous les clusters de toutes les régions sont répertoriés. Si vous devez limiter la liste, définissez--locationsur une région spécifique.Vérifiez que les ressources d'appartenance au parc ont été supprimées:
gcloud container fleet memberships list \ --project=PROJECT_ID