Introduction
Dans le chapitre précédent nous avions étudié la plus petite unité de Kubernetes, à savoir les Pods. C'est bien joli tout ça, mais si vous souhaitez allouer plus de puissance à votre Pod, comment allez-vous vous y prendre ?
Une des solutions reste de scaler votre Pod. Mais pensez-vous que nous allons exécuter la commande permettant de créer un Pod autant de fois que le nombre de répliques voulues ?
La réponse est évidemment NON. Dans ce cas, nous utiliserons un objet Kubernetes, prévue à cet effet, soit les ReplicaSets.
Les ReplicaSets garantissent que le nombre de répliques souhaitées de votre Pod, est bel et bien respecté. Il peut être considéré comme un remplacement d'un autre objet Kubernetes nommé le replication controller (en FR: "contrôleur de réplication").
La principale différence entre le ReplicaSets et le replication controller, est que le ReplicaSet prend en charge le sélecteur basé sur sur les labels, ce qui n'est pas le cas avec le replication controller.
Manipulation des ReplicaSet
Création du ReplicaSet
Dans cet exemple, nous allons créer un ReplicaSet contenant trois répliques du Pod nginx. Comme d'habitude pour créer un Pod, nous passerons par la création d'un template au format YAML, ce qui nous donne ;
apiVersion: apps/v1
kind: ReplicaSet
metadata:
name: nginx-rs
labels:
app: web
spec:
replicas: 3
selector:
matchLabels:
app: web
template:
metadata:
labels:
app: web
spec:
containers:
- name: nginx
image: nginxPassons à l'explication de ces quelques nouvelles lignes de notre template :
apiVersion: apps/v1Dans ce template nous spécifions la version apps/v1 qui est la version de l'API k8s qui prend en charge le concept des ReplicasSets.
replicas: 3
selector:
matchLabels:
app: webIci, nous indiquons le nombre de répliques voulues, soit trois répliques. Et nous définissons aussi la condition de correspondance qui consiste à répliquer les pods ayant le label app: web.
Par la suite, on ne fait que définir la configuration de notre Pod, comme vu dans le chapitre précédent dédié aux Pods.
Une fois le template fini, on peut commencer à créer notre ReplicaSet avec la commande suivante :
kubectl create -f nginx-rs.yamlVérifons ensuite la liste des pods disponibles dans notre cluster :
kubectl get pods -o wideRésultat :
NAME READY STATUS RESTARTS AGE IP NODE NOMINATED NODE READINESS GATES
nginx-rs-f49kh 1/1 Running 0 7m25s 192.168.1.44 worker-1 <none> <none>
nginx-rs-sn9v9 1/1 Running 0 7m25s 192.168.1.42 worker-1 <none> <none>
nginx-rs-xk5g7 1/1 Running 0 7m25s 192.168.1.43 worker-1 <none> <none>D'après le résultat, nous avons bien nos trois répliques du Pod nginx avec une adresse IP spécifique à chaque Pod.
Nous pouvons dès lors, accéder à la page d'accueil de nginx depuis ces 3 IPS :
ssh vagrant@worker-1 curl -s http://192.168.1.44
ssh vagrant@worker-1 curl -s http://192.168.1.42
ssh vagrant@worker-1 curl -s http://192.168.1.43Résultat :
<title>Welcome to nginx!</title>
...
<body>
<h1>Welcome to nginx!</h1>
<p>If you see this page, the nginx web server is successfully installed and
working. Further configuration is required.</p>
<p>For online documentation and support please refer to
<a href="http://nginx.org/">nginx.org</a>.<br/>
Commercial support is available at
<a href="http://nginx.com/">nginx.com</a>.</p>
<p><em>Thank you for using nginx.</em></p>Scaler vos Pods
Il existe différentes manières pour scaler vos Pods. Vous pouvez par exemple scaler les répliques de vos Pods sans changer votre template YAML avec les commandes suivantes :
kubectl scale --replicas=4 replicaset nginx-rsou
kubectl scale --replicas=4 -f nginx-rs.yamlAprès avoir exécuté la commande de scaling , nous allons cette fois-ci, vérifier la liste des ReplicaSets disponibles dans notre cluster k8s :
kubectl get replicasetsou
kubectl get rsRésultat :
NAME DESIRED CURRENT READY AGE
nginx-rs 4 4 4 21mLe nombre de répliques du Pod nginx est bien passé de trois à quatre.
Contrairement à la première méthode, celle prochaine commande permet d'un côté de diminuer le nombre de répliques de notre Pod, mais nécessite un changement depuis notre template YAML.
Depuis notre template, je vais changer la ligne replicas: 3 en replicas: 2, et lancer la commande suivante :
kubectl apply -f nginx-pod.yamlSi on revérifie la liste de nos ReplicaSet, nous avons bien plus que deux Pods :
kubectl apply -f nginx-pod.yamlRésultat :
Information
Si jamais vous avez perdu votre template, vous pouvez alors utiliser la commande kubectl edit rs nginx-rs, ce qui aura pour effet d'ouvrir l'éditeur de texte de votre terminal contenant la configuration de votre ReplicaSet au format YAML. Pour chaque modification et sauvegarde de ce fichier, les changements seront immédiatement appliqués sur votre ReplicaSet.
Supprimer votre ReplicaSet
Voici la commande qui permet de supprimer votre ReplicaSet :
kubectl delete ReplicaSet nginx-rsou
kubectl delete rs nginx-rsRésultat :
replicaset.extensions "nginx-rs" deletedRécupérer des informations sur votre ReplicaSet
Comme pour les Pods, vous pouvez récupérer des informations détaillées sur votre ReplicaSet. Plus exactement, ce qui va nous intéresser le plus, ce sont les différents événements subis par notre ReplicaSet, soit la commande suivante :
kubectl describe rs nginx-rsRésultat :
Conclusion
Les ReplicaSets sont un bon moyen, pour créer et gérer les répliques de vos Pods. Dans le chapitre suivant nos verrons un autre type d'objet Kubernetes, les Deployments.
Comme à mon habitude, voici un récapitulatif des commandes de manipulation des ReplicaSet
# Afficher la liste des Replicasets
kubectl get replicasets [En option <REPLICASET NAME>]
--template : récupérer des informations précises de la sortie de la commande
Ex: Récupérer le nombre de réplique : kubectl get rs <REPLICASET NAME> --template={{.status.replicas}}
# Créer un ReplicaSet
kubectl create -f <template.yaml>
# Supprimer un ReplicaSet
kubectl delete replicasets <REPLICASET NAME>
# Appliquer des nouveaux changements à votre ReplicaSet sans le détruire
kubectl apply -f <template.yaml>
# Modifier et appliquer les changements de votre ReplicaSet instantanément sans le détruire
kubectl edit rs <REPLICASET NAME>
# Afficher les détails d'un replicaset
kubectl describe replicasets <REPLICASET NAME>
Espace commentaire
Écrire un commentaire
Rejoignez la discussion
Vous devez être connecté pour poster un message.
28 commentaires
Utilise
jsonpathougo-templateaveckubectl get:Comment je peux récupérer juste le nom des pods via une ligne de commande ?
Ton cluster est trop vieux. Regarde si tu dois utiliser
extensions/v1beta1, mais sérieusement, upgrade ton cluster.J'ai un souci avec l'API
apps/v1sur mon vieux cluster, ça me renvoie une erreur.Oui, c'est justement son rôle. Le contrôleur surveille l'état réel vs l'état souhaité. Il va instantanément recréer un pod pour maintenir le
replicasdéfini.Question bête : si je supprime un pod manuellement, le ReplicaSet le recrée ?
Merci pour l'article, c'est clair. Le concept de
matchLabelsest bien mieux expliqué ici que dans la doc officielle.Si tu as un autre processus qui tourne ou un outil de CI/CD qui repousse l'ancienne conf, il va écraser tes modifs. Vérifie ton pipeline.
J'ai tenté de modifier le nombre de répliques via
kubectl edit rsmais le changement ne persiste pas. Normal ?createéchoue si l'objet existe.applyest déclaratif : il met à jour l'objet existant avec ton nouveau YAML. Utiliseapplypar défaut.C'est quoi la différence concrète entre
kubectl applyetkubectl createpour un ReplicaSet ?Le ReplicaSet gère les pods, pas le réseau hôte. Il te faut un
Servicede typeNodePortpour exposer ça proprement.J'ai un conflit de port sur l'hôte, comment changer le port de nginx dans le template ?
Exact, ou utilise un outil comme
stern. Sinon en bash :Pas directement avec
kubectl logs, faut faire une boucle en bash.Est-ce que je peux voir les logs de tous les pods d'un coup ?
Utilise les labels que tu as définis dans
matchLabels:Comment je peux lister uniquement les pods appartenant à un ReplicaSet précis ?
Probablement un manque de ressources sur tes nœuds. Vérifie avec
kubectl describe nodepour voir si tu as encore de la place.J'ai testé le scaling avec
kubectl scalemais mes pods ne montent pas. Ils sont enPending.Ça dépend de ta variable d'env
EDITOR. Perso je metsexport EDITOR=vimdans mon.bashrc.Le
kubectl edit rsc'est pratique, mais ça utilise quel éditeur par défaut ?Le
selectorest immuable. Tu ne peux pas le modifier sur un objet existant. Il faut détruire le ReplicaSet et le recréer.J'ai une erreur
Invalid valuequand je modifie le selector dans le template YAML. Pourquoi ?Oui, utilise
kubectl delete rs --force --grace-period=0 . À ne jamais faire en prod sauf si c'est vraiment planté.