Cette page explique comment mettre à jour les charges de travail avec état existantes exécutées dans un cluster Kubernetes d'appliance Google Distributed Cloud (GDC) sous air gap. À mesure que votre application évolue en fonction de l'utilisation des ressources et des optimisations de configuration, vous devez mettre à jour la spécification de pod sous-jacente dans le cluster Kubernetes pour refléter ces modifications de charge de travail. Pour en savoir plus sur la planification des mises à jour pour les charges de travail avec état, consultez la documentation Kubernetes sur les stratégies de mise à jour.
Cette page s'adresse aux développeurs du groupe d'opérateurs d'applications, qui sont chargés de mettre à jour les charges de travail des applications pour leur organisation.
Avant de commencer
Pour effectuer les tâches décrites dans ce document, vous devez demander les autorisations nécessaires et préparer votre environnement.
Demander des rôles IAM
Pour créer, supprimer, modifier ou afficher des charges de travail avec état dans un cluster Kubernetes, demandez à votre administrateur IAM de l'organisation de vous attribuer le rôle Administrateur de l'espace de noms (namespace-admin). Ce rôle est lié à l'espace de noms de votre projet.
Préparer votre environnement
Pour exécuter des commandes sur le cluster Kubernetes Bare Metal préconfiguré, assurez-vous de disposer des ressources suivantes :
Recherchez le nom du cluster Kubernetes ou demandez-le à votre administrateur de plate-forme.
Connectez-vous et générez le fichier kubeconfig pour le cluster Kubernetes si vous n'en avez pas.
Utilisez le chemin d'accès kubeconfig du cluster Kubernetes pour remplacer
CLUSTER_KUBECONFIGdans ces instructions.
Mettre à jour une ressource StatefulSet
Pour mettre à jour StatefulSet, appliquez un fichier manifeste nouveau ou mis à jour. Cette pratique est utile pour apporter diverses modifications à votre StatefulSet lors du scaling ou pour spécifier une nouvelle version de votre application.
Pour mettre à jour un objet StatefulSet, exécutez la commande suivante :
kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
apply -f STATEFULSET_FILE
Remplacez les éléments suivants :
CLUSTER_KUBECONFIG: fichier kubeconfig pour le cluster Kubernetes exécutant les charges de travail avec état.NAMESPACE: espace de noms du projet.STATEFULSET_FILE: nom du fichier manifesteStatefulSetmis à jour.
La commande kubectl apply applique un fichier manifeste à une ressource. Si la ressource spécifiée n'existe pas, elle est créée par la commande.
Inspecter le déploiement d'une mise à jour de ressource StatefulSet
Vous pouvez afficher des informations détaillées sur l'état et l'historique du déploiement des mises à jour d'un objet StatefulSet. Vous pouvez également annuler le déploiement d'un objet StatefulSet.
Inspecter le déploiement
Pour inspecter le déploiement de la ressource StatefulSet, exécutez la commande suivante :
kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
rollout status statefulset STATEFULSET_NAME
CLUSTER_KUBECONFIG: fichier kubeconfig pour le cluster Kubernetes exécutant les charges de travail avec état.NAMESPACE: espace de noms du projet.STATEFULSET_NAME: nom de l'objetStatefulSetmis à jour.
Obtenir l'historique de déploiement
Pour afficher l'historique de déploiement de la ressource StatefulSet, exécutez la commande suivante :
kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
rollout history statefulset STATEFULSET_NAME
CLUSTER_KUBECONFIG: fichier kubeconfig pour le cluster Kubernetes exécutant les charges de travail avec état.NAMESPACE: espace de noms du projet.STATEFULSET_NAME: nom de l'objetStatefulSetmis à jour.
Annuler un déploiement
Pour annuler un déploiement, exécutez la commande suivante :
kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
rollout undo statefulset STATEFULSET_NAME
Remplacez les éléments suivants :
CLUSTER_KUBECONFIG: fichier kubeconfig pour le cluster Kubernetes exécutant les charges de travail avec état.NAMESPACE: espace de noms du projet.STATEFULSET_NAME: nom de l'objetStatefulSet.