Cette page explique comment utiliser la console Google Cloud ou la Google Cloud CLI pour mettre à niveau un cluster d'administrateur ou d'utilisateur Google Distributed Cloud enregistré dans l'API GKE On-Prem. Si vous avez créé votre cluster d'utilisateur à l'aide de Terraform, vous pouvez utiliser Terraform pour le mettre à niveau. Pour connaître les conditions requises, les bonnes pratiques et d'autres informations sur le processus de mise à niveau, consultez les pages Bonnes pratiques de mise à niveau et Cycle de vie et étapes des mises à niveau de cluster avant de continuer.
Qu'est-ce que l'API GK On-Prem ?
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 outilsGoogle Cloud standards. L'API GKE On-Prem s'exécute sur l'infrastructure de Google Cloud. Terraform, la console Google Cloud et Google Cloud CLI sont des clients de l'API. Ils l'utilisent pour créer, mettre à jour, migrer et supprimer des clusters dans votre centre de données. Si vous avez créé le cluster à l'aide d'un client standard, il est enregistré dans l'API GKE On-Prem. Cela signifie que vous pouvez utiliser les clients standards pour gérer le cycle de vie du cluster (à quelques exceptions près).
Si vous avez créé le cluster à l'aide de bmctl
, vous pouvez l'inscrire dans l'API GKE On-Prem, ce qui vous permet d'utiliser les clients standards.
Avant de commencer
Configurer gcloud CLI
Pour mettre à niveau un cluster à l'aide de gcloud CLI ou de Terraform:
Assurez-vous de disposer de la dernière version de gcloud CLI. Mettez à jour les composants de gcloud CLI, si nécessaire :
gcloud components update
Exigences IAM
Si vous n'êtes pas propriétaire du projet, vous devez disposer du rôle Identity and Access Management roles/gkeonprem.admin
pour le projet Google Cloud dans lequel le cluster a été créé. Pour en savoir plus sur les autorisations incluses dans ce rôle, consultez la section Rôles GKE On-Prem dans la documentation IAM.
Pour mettre à niveau le cluster à l'aide de la console, vous devez disposer au minimum des éléments suivants:
roles/container.viewer
. Ce rôle permet aux utilisateurs d'afficher la page "Clusters GKE" et les autres ressources de conteneur dans la console. Pour en savoir plus sur les autorisations incluses dans ce rôle ou pour attribuer un rôle avec des autorisations de lecture/écriture, consultez la section Rôles Kubernetes Engine dans la documentation IAM.roles/gkehub.viewer
. Ce rôle permet aux utilisateurs d'afficher les clusters dans la console. Pour en savoir plus sur les autorisations incluses dans ce rôle ou pour accorder un rôle avec des autorisations de lecture/écriture, consultez la section Rôles GKE Hub dans la documentation IAM.
Exigences concernant les versions
La version sera disponible dans l'API GKE On-Prem environ sept à 14 jours après sa publication dans Google Distributed Cloud.
Vous pouvez passer directement à n'importe quelle version de la même version mineure ou de la version mineure suivante. Par exemple, vous pouvez passer de la version 1.31.100 à la version 1.31.200, ou de la version 1.30.100 à la version 1.31.200. Il n'est pas possible de passer à une version ultérieure à la version installée de plus d'une version mineure.
Un cluster d'administrateur peut gérer des clusters d'utilisateur qui correspondent à la même version mineure, ou à une version mineure précédente. La version d'un cluster d'utilisateur géré ne peut pas être inférieure de plus d'une version mineure à celle du cluster d'administrateur. Avant de mettre à jour un cluster d'administrateur vers une nouvelle version mineure, assurez-vous donc que tous les clusters d'utilisateur gérés correspondent à la même version mineure que le cluster d'administrateur.
Mettre à niveau un cluster d'administrateur
Console
Dans la console, accédez à la page Vue d'ensemble des clusters Google Kubernetes Engine.
Sélectionnez le projet Google Cloud, puis le cluster que vous souhaitez mettre à niveau.
Dans le panneau Détails, cliquez sur Plus de détails.
Dans la section Paramètres de base du cluster, cliquez sur
Mettre à niveau.Dans la liste Choisir la version cible, sélectionnez la version vers laquelle vous souhaitez effectuer la mise à niveau. Nous vous recommandons de passer à la dernière version du correctif.
Cliquez sur Mettre à jour.
Avant la mise à niveau du cluster, des vérifications préliminaires sont exécutées pour valider l'état du cluster et celui des nœuds. Si les vérifications préliminaires sont réussies, le cluster d'administrateur est mis à niveau. La mise à niveau prend 30 minutes ou plus, selon la taille de votre cluster.
Pour afficher l'état de la mise à niveau, cliquez sur Afficher les détails dans l'onglet Détails du cluster.
CLI gcloud
Vous pouvez également lister tous les clusters d'administrateur enregistrés dans le projet pour confirmer le nom et la région du cluster:
gcloud container bare-metal admin-clusters list \ --project=PROJECT_ID \ --location=-
Remplacez
PROJECT_ID
par l'ID du projet hôte du parc dont le cluster est membre. Si vous avez créé le cluster à l'aide debmctl
, il s'agit de l'ID de projet dans le champgkeConnect.projectID
du fichier de configuration du cluster.Lorsque vous définissez
--location=-
, cela signifie que vous souhaitez lister tous les clusters de toutes les régions. Si vous devez limiter la liste, définissez--location
sur une région spécifique.
Si une erreur
PERMISSION_DENIED
s'affiche, vérifiez l'ID de projet que vous avez saisi. Si l'ID du projet est correct, exécutezgcloud auth login
pour vous connecter à Google Cloud CLI avec le compte ayant accès au projet.Obtenez la liste des versions disponibles pour la mise à niveau :
gcloud container bare-metal admin-clusters query-version-config \ --admin-cluster=ADMIN_CLUSTER_NAME \ --project=PROJECT_ID \ --location=REGION
Remplacez les éléments suivants :
ADMIN_CLUSTER_NAME
: nom du cluster d'administrateur.PROJECT_ID
: ID du projet hôte du parc auquel le cluster est membre.REGION
: région Google Cloud dans laquelle l'API GKE On-Prem s'exécute et stocke les métadonnées du cluster.
Mettre à niveau le cluster d'administrateur
gcloud container bare-metal admin-clusters update ADMIN_CLUSTER_NAME \ --project=PROJECT_ID \ --location=REGION \ --version=VERSION
Remplacez
VERSION
par la version de Google Distributed Cloud vers laquelle vous souhaitez effectuer la mise à niveau. Spécifiez une version à partir de la sortie de la commande précédente. Nous vous recommandons de passer à la dernière version du correctif.La sortie de la commande ressemble à ceci :
Waiting for operation [projects/example-project-12345/locations/us-west1/operations/operation-1679543737105-5f7893fd5bae9-942b3f97-75e59179] to complete.
Dans l'exemple de résultat, la chaîne
operation-1679543737105-5f7893fd5bae9-942b3f97-75e59179
est leOPERATION_ID
de l'opération de longue durée.Pour connaître l'état de l'opération, copiez l'
OPERATION_ID
de votre sortie dans la commande suivante. Ouvrez une autre fenêtre de terminal et exécutez la commande.gcloud container bare-metal operations describe OPERATION_ID \ --project=PROJECT_ID \ --location=REGION
La mise à niveau prend au moins 30 minutes, en fonction de la taille de votre cluster. Pendant la mise à niveau du cluster, vous pouvez exécuter la commande précédente de temps en temps pour obtenir l'état actuel.
Une fois la mise à niveau terminée, un message semblable à celui-ci s'affiche dans la fenêtre de terminal dans laquelle vous avez exécuté la commande gcloud ... update
:
Updated Anthos on bare metal Admin Cluster [https://gkeonprem.googleapis.com/v1/projects/example-project-1234/locations/us-central1/bareMetalAdminClusters/abm-admin-cluster]. NAME LOCATION VERSION MEMBERSHIP STATE abm-admin-cluster us-central1 1.31.0-gke.889 abm-admin-cluster RUNNING
Pour en savoir plus sur les champs et les options, consultez la documentation de référence sur les clusters d'administrateur bare metal pour les conteneurs gcloud.
Mettre à niveau un cluster d'utilisateur
Console
Dans la console, accédez à la page Vue d'ensemble des clusters Google Kubernetes Engine.
Sélectionnez le projet Google Cloud, puis le cluster que vous souhaitez mettre à niveau.
Dans le panneau Détails, cliquez sur Plus de détails.
Dans la section Paramètres de base du cluster, cliquez sur
Mettre à niveau.Dans la liste Choisir la version cible, sélectionnez la version vers laquelle vous souhaitez effectuer la mise à niveau.
Cliquez sur Mettre à jour.
Avant la mise à niveau du cluster, des vérifications préliminaires sont exécutées pour valider l'état du cluster et celui des nœuds. Si les vérifications préliminaires sont réussies, le cluster d'utilisateur est mis à niveau. La mise à niveau prend 30 minutes ou plus, selon la taille de votre cluster.
Pour afficher l'état de la mise à niveau, cliquez sur Afficher les détails dans l'onglet Détails du cluster.
CLI gcloud
Vous pouvez également lister tous les clusters d'utilisateurs enregistrés dans le projet pour confirmer le nom et la région du cluster:
gcloud container bare-metal clusters list \ --project=PROJECT_ID \ --location=-
Remplacez
PROJECT_ID
par l'ID du projet hôte du parc dont le cluster est membre. Si vous avez créé le cluster à l'aide debmctl
, il s'agit de l'ID de projet dans le champgkeConnect.projectID
du fichier de configuration du cluster.Lorsque vous définissez
--location=-
, cela signifie que vous souhaitez lister tous les clusters de toutes les régions. Si vous devez limiter la liste, définissez--location
sur une région spécifique.
La sortie de la commande ressemble à ceci :
NAME LOCATION VERSION ADMIN_CLUSTER STATE abm-user-cluster us-central1 1.31.0-gke.889 abm-admin-cluster RUNNING
Si une erreur
PERMISSION_DENIED
s'affiche, vérifiez l'ID de projet que vous avez saisi. Si l'ID du projet est correct, exécutezgcloud auth login
pour vous connecter à Google Cloud CLI avec le compte ayant accès au projet.Obtenez la liste des versions disponibles pour la mise à niveau :
gcloud container bare-metal clusters query-version-config \ --cluster=USER_CLUSTER_NAME \ --project=PROJECT_ID \ --location=REGION
Remplacez les éléments suivants :
USER_CLUSTER_NAME
: nom du cluster d'utilisateur à migrer.PROJECT_ID
: ID du projet hôte du parc auquel le cluster est membre.REGION
: région Google Cloud dans laquelle l'API GKE On-Prem s'exécute et stocke les métadonnées du cluster.
La sortie de la commande ressemble à ceci :
versions: - hasDependencies: true version: 1.15.2 - hasDependencies: true version: 1.15.1 - hasDependencies: true version: 1.15.0 - version: 1.14.6
Choisissez une version qui n'est pas listée sous
- hasDependencies: true
. Dans cet exemple, la seule version disponible vers laquelle vous pouvez mettre à niveau le cluster d'utilisateur est1.14.6
.Mettez à niveau le cluster d'utilisateur :
gcloud container bare-metal clusters update USER_CLUSTER_NAME \ --project=PROJECT_ID \ --location=REGION \ --version=VERSION
Remplacez
VERSION
par la version de Google Distributed Cloud vers laquelle vous souhaitez effectuer la mise à niveau. Spécifiez une version à partir de la sortie de la commande précédente. Nous vous recommandons de passer à la dernière version du correctif.La sortie de la commande ressemble à ceci :
Waiting for operation [projects/example-project-12345/locations/us-west1/operations/operation-1679543737105-5f7893fd5bae9-942b3f97-75e59179] to complete.
Dans l'exemple de résultat, la chaîne
operation-1679543737105-5f7893fd5bae9-942b3f97-75e59179
est leOPERATION_ID
de l'opération de longue durée.Pour connaître l'état de l'opération, copiez l'
OPERATION_ID
de votre sortie dans la commande suivante. Ouvrez une autre fenêtre de terminal et exécutez la commande.gcloud container bare-metal operations describe OPERATION_ID \ --project=PROJECT_ID \ --location=REGION
La mise à niveau prend au moins 30 minutes, en fonction de la taille de votre cluster. Pendant la mise à niveau du cluster, vous pouvez exécuter la commande précédente de temps en temps pour obtenir l'état actuel.
Pour en savoir plus sur les champs et les options, consultez la documentation de référence sur les clusters bare metal pour les conteneurs gcloud.
Terraform
Pour mettre à niveau un cluster à l'aide de Terraform, vous utilisez la même configuration Terraform que celle que vous avez utilisée pour créer le cluster.
Accédez au répertoire dans lequel se trouve le fichier de configuration Terraform.
Obtenez la liste des versions disponibles pour la mise à niveau :
gcloud container bare-metal clusters query-version-config \ --cluster=USER_CLUSTER_NAME \ --project=PROJECT_ID \ --location=REGION
Remplacez les éléments suivants :
USER_CLUSTER_NAME
: nom du cluster d'utilisateur à migrer.PROJECT_ID
: ID du projet hôte de parc dans lequel ce cluster d'utilisateur est membre.REGION
: région Google Cloud dans laquelle l'API GKE On-Prem s'exécute et stocke ses métadonnées.
Si une erreur
PERMISSION_DENIED
s'affiche, vérifiez l'ID de projet que vous avez saisi. Si l'ID du projet est correct, exécutezgcloud auth login
pour vous connecter à Google Cloud CLI avec le compte ayant accès au projet.Dans votre configuration Terraform, remplacez
bare_metal_version
par la version de Google Distributed Cloud vers laquelle vous souhaitez effectuer la mise à niveau. Spécifiez une version à partir de la sortie de la commande précédente. Nous vous recommandons de passer à la dernière version du correctif.Initialisez et créez le plan Terraform :
terraform init
Terraform installe les bibliothèques nécessaires, telles que le fournisseur Google Cloud.
Examinez la configuration et apportez les modifications nécessaires :
terraform plan
Appliquez le plan Terraform pour créer le cluster d'utilisateur :
terraform apply
Pour en savoir plus sur la ressource google_gkeonprem_bare_metal_cluster
, consultez la documentation de référence.