L'outil de ligne de commande Kubernetes, kubectl, est utilisé pour exécuter des commandes sur des clusters Kubernetes. Vous utiliserez kubectl pour inspecter et gérer les ressources de cluster de votre service et afficher les journaux. Certaines commandes couramment utilisées pour récupérer des informations sur un cluster Kubernetes sont les suivantes :
- obtenir kubectl affiche des informations sur l'objet API spécifié.
- kubectl décrire donne plus de détails sur l'objet API spécifié.
- journaux kubectl afficher la sortie du journal des conteneurs.
Si vous avez des doutes sur l'utilisation de l'outil kubectl, les commandes kubectl help et kubectl
Si vous rencontrez l'erreur ci-dessous lors de l'exécution de la commande kubectl :
kubectl: command not found
vous pouvez essayer d'installer le package ci-dessous selon votre choix de distribution.
| Répartition | Commande |
|---|---|
| OS X | installer kubernetes-cli |
| Debian | apt-get install kubernetes-client |
| CentOS | yum install kubernetes-client |
| Fédora | dnf install kubernetes-client |
Exemples de commandes kubectl
1. Lister les informations sur une ressource avec plus de détails :
$ kubectl get pod|service|deployment|ingress|... -o wide
2. Mettez à jour le pod spécifié avec l'étiquette "malsain" et la valeur "vrai" :
$ kubectl label pods name unhealthy=true
3. Listez toutes les ressources avec différents types :
$ kubectl get all
4. Afficher l'utilisation des ressources (CPU/Mémoire/Stockage) des nœuds ou des pods :
$ kubectl top pod|node
5. Imprimez l'adresse des services maître et cluster :
$ kubectl cluster-info
6. Afficher une explication d'un champ spécifique :
$ kubectl explain pods.spec.containers
7. Imprimez les journaux d'un conteneur dans un pod ou une ressource spécifiée :
$ kubectl logs pod_name
8. Exécutez la commande dans un pod existant :
$ kubectl exec pod_name -- ls /
9. Vous pouvez également utiliser la commande exec pour exécuter une commande dans un conteneur en cours d'exécution :
$ kubectl exec -it pod_name -- bash
10. Si vous n'avez pas bash ou un autre terminal disponible dans votre conteneur, vous pouvez toujours vous attacher au processus en cours :
$ kubectl attach -it pod_name
11. Vous pouvez également copier des fichiers vers et depuis un conteneur à l'aide de la commande cp :
$ kubectl cp [pod-name]:[/path/to/remote/file] [/path/to/local/file]
12. Si vous souhaitez accéder à votre pod via le réseau, vous pouvez utiliser la commande port-forward pour transférer le trafic réseau de la machine locale vers le pod.
$ kubectl port-forward [pod-name] 8080:80
13. Si vous souhaitez afficher les événements Kubernetes, vous pouvez utiliser la commande kubectl get events pour afficher une liste des 10 derniers événements sur tous les objets d'un espace de noms donné :
$ kubectl get events
14. Si vous souhaitez savoir comment votre cluster utilise les ressources, vous pouvez utiliser la commande top pour afficher la liste des ressources utilisées par les nœuds ou les pods. Cette commande :
$ kubectl top nodes
15. Supposons que vous ayez un objet simple stocké dans obj.yaml. Vous pouvez utiliser kubectl pour créer cet objet dans Kubernetes en exécutant :
$ kubectl apply -f obj.yaml
16. De même, après avoir apporté des modifications à l'objet, vous pouvez à nouveau utiliser la commande Apply pour mettre à jour l'objet :
$ kubectl apply -f obj.yaml
17. Lorsque vous souhaitez supprimer un objet, vous pouvez simplement lancer :
$ kubectl delete -f obj.yaml
18. Les étiquettes et les annotations sont des balises pour vos objets. Par exemple, pour ajouter le libellé color=red à une barre nommée Pod, vous pouvez exécuter :
$ kubectl label pods bar color=red
19. Si vous souhaitez voir une liste des champs pris en charge pour chaque type d'objet Kubernetes pris en charge, vous pouvez utiliser la commande EXPLAIN :
$ kubectl explain pods
20. Si vous êtes intéressé par des informations plus détaillées sur un objet particulier, utilisez la commande describe :
$ kubectl describe [resource-name] [obj-name]