For AI agents: the complete documentation index is available at https://docs.ovhcloud.com/fr/llms.txt, the full documentation bundle is available at https://docs.ovhcloud.com/fr/llms-full.txt, and this page is available as Markdown at https://docs.ovhcloud.com/fr/guides/public-cloud/containers-orchestration/managed-rancher-service/using-rancher-cli.md.

Utiliser la Rancher CLI

Voir en Markdown

Découvrez comment utiliser la Rancher CLI pour administrer un Managed Rancher Service

Objectif

Managed Rancher Service par OVHcloud vous permet d'orchestrer vos clusters Kubernetes. Ce tutoriel présente la Rancher CLI, qui vous permet d'administrer vos clusters Kubernetes en complément de l'interface Rancher.

Prérequis

Instructions

Rancher CLI

La Rancher CLI (Command Line Interface) est un outil unifié qui vous permet d'interagir avec un OVHcloud Managed Rancher Service (MRS). Grâce à cet outil, vous administrez votre MRS en ligne de commande plutôt que via l'interface graphique.

Télécharger et installer la Rancher CLI

Pour télécharger la Rancher CLI, connectez-vous à l'interface de votre Managed Rancher Service et cliquez sur le lien About en bas du menu latéral de navigation :

Interface OVHcloud Managed Rancher Service

Dans la section CLI Downloads, cliquez pour télécharger les binaires correspondant à votre système d'exploitation (macOS, Linux ou Windows), décompressez l'archive et copiez le binaire rancher dans votre PATH.

Info

Vous pouvez télécharger les binaires directement depuis le dépôt GitHub de la Rancher CLI.

Générer une clé d'API pour utiliser la Rancher CLI

Pour utiliser la Rancher CLI et vous connecter à votre OVHcloud MRS, vous devez créer une clé d'API.

En haut à droite, cliquez sur votre avatar, puis sur le menu Account & API Keys.

Interface OVHcloud Managed Rancher Service

La page Account and API Keys s'affiche.

Interface OVHcloud Managed Rancher Service

Cliquez sur le bouton Create API Key pour créer une clé d'API.

Renseignez une description permettant d'identifier votre clé d'API (CLI par exemple), conservez la valeur No Scope définie par défaut pour le scope et définissez la date d'expiration.

Interface OVHcloud Managed Rancher Service
Warning

Si vous le souhaitez, vous pouvez modifier le scope afin de n'autoriser la Rancher CLI à accéder qu'à un seul de vos clusters Kubernetes.

Cliquez ensuite sur le bouton Create.

Une nouvelle clé d'API est créée. Copiez-collez l'Access Key, la Secret Key et le Bearer Token dans un gestionnaire de mots de passe.

Utiliser la Rancher CLI

Connectez-vous à votre MRS avec la CLI :

rancher login <MRS_URL> --token <BEARER_TOKEN>

Vous devriez obtenir le résultat suivant :

rancher login https://xxxxxx.xxxx.rancher.ovh.net --token token-phbts:qhsdfuqsdfuhdsqfdqshfdsqhkfhsqdkjfhkqsj

NUMBER    CLUSTER NAME             PROJECT ID             PROJECT NAME   PROJECT DESCRIPTION
1         my-mks-rancher-cluster   c-gcqnf:p-lt2z4        Default        Default project created for the cluster
2         my-mks-rancher-cluster   c-gcqnf:p-t4tcj        System         System project created for the cluster
3         my-kube                  c-m-2brxmwcz:p-dcpvf   Default        Default project created for the cluster
4         my-kube                  c-m-2brxmwcz:p-vcwrr   System         System project created for the cluster
Select a Project:1
INFO[0044] Saving config to /Users/avache/.rancher/cli2.json

Vous êtes maintenant authentifié sur votre MRS et pouvez afficher la liste de vos clusters Kubernetes :

rancher clusters

CURRENT   ID             STATE     NAME                     PROVIDER   NODES     CPU         RAM             PODS
*         c-gcqnf        active    my-mks-rancher-cluster   Unknown    3         1.38/5.52   0.97/14.72 GB   20/330
          c-m-2brxmwcz   active    my-kube                  Imported   3         2.11/5.52   1.44/15.09 GB   31/330

Dans notre exemple, nous disposons d'un cluster MKS et d'un cluster existant importé précédemment.

Sélectionnez l'un des clusters Kubernetes :

rancher context switch

NUMBER    CLUSTER NAME             PROJECT ID             PROJECT NAME   PROJECT DESCRIPTION
1         my-mks-rancher-cluster   c-gcqnf:p-lt2z4        Default        Default project created for the cluster
2         my-mks-rancher-cluster   c-gcqnf:p-t4tcj        System         System project created for the cluster
3         my-kube                  c-m-2brxmwcz:p-dcpvf   Default        Default project created for the cluster
4         my-kube                  c-m-2brxmwcz:p-vcwrr   System         System project created for the cluster
Select a Project:3
INFO[0004] Setting new context to project Default
INFO[0004] Saving config to /Users/avache/.rancher/cli2.json

En choisissant 3, vous avez basculé sur le cluster my-kube.

Listez les pods du cluster my_kube directement depuis la Rancher CLI :

rancher kubectl get pod -A

NAMESPACE             NAME                                           READY   STATUS    RESTARTS        AGE
cattle-fleet-system   fleet-agent-f7dc57db7-wx4s5                    1/1     Running   0               3d23h
cattle-system         cattle-cluster-agent-6ccc7dbf48-8phk6          1/1     Running   0               3d23h
cattle-system         cattle-cluster-agent-6ccc7dbf48-kv26f          1/1     Running   0               3d23h
cattle-system         rancher-webhook-fd7599678-tptcd                1/1     Running   0               3d23h
default               hello-world-deployment-c7584d4f5-w98l7         1/1     Running   0               110d
default               nfs-nginx-29r49                                1/1     Running   0               6d1h
default               nfs-nginx-f5j92                                1/1     Running   0               6d1h
default               nfs-nginx-z9qjg                                1/1     Running   0               6d1h
ingress-nginx         ingress-nginx-controller-55474d95c5-7tl7n      1/1     Running   0               110d
kube-system           calico-kube-controllers-66b876699d-j8tsl       1/1     Running   1 (64d ago)     118d
kube-system           canal-j7dtp                                    2/2     Running   0               118d
kube-system           canal-lc5vl                                    2/2     Running   0               118d
kube-system           canal-swrxf                                    2/2     Running   0               118d
kube-system           coredns-5594b5bf54-gh26t                       1/1     Running   0               118d
kube-system           coredns-5594b5bf54-tqnvc                       1/1     Running   0               118d
kube-system           csi-nfs-node-88zds                             3/3     Running   0               6d1h
kube-system           csi-nfs-node-b4kf7                             3/3     Running   0               6d1h
kube-system           csi-nfs-node-rqz25                             3/3     Running   0               6d1h
kube-system           csi-nfs2-controller-74f4559bc4-rmjhb           4/4     Running   2 (4d21h ago)   6d1h
kube-system           kube-dns-autoscaler-9f54dfbf4-btmm6            1/1     Running   0               118d
kube-system           kube-proxy-9p6t8                               1/1     Running   0               118d
kube-system           kube-proxy-jk77j                               1/1     Running   0               118d
kube-system           kube-proxy-tjvnf                               1/1     Running   0               118d
kube-system           metrics-server-5876b4d5bf-jr9z6                1/1     Running   0               118d
kube-system           ovhcloud-apiserver-proxy-8w656                 1/1     Running   0               118d
kube-system           ovhcloud-apiserver-proxy-btdn4                 1/1     Running   0               118d
kube-system           ovhcloud-apiserver-proxy-rbclj                 1/1     Running   0               118d
kube-system           ovhcloud-konnectivity-agent-7d9b9dfddd-9s4vk   1/1     Running   0               118d
kube-system           ovhcloud-konnectivity-agent-7d9b9dfddd-nhhp7   1/1     Running   0               118d
trivy-system          trivy-operator-84b86599cb-tzmg4                1/1     Running   0               110d
velero                velero-55f979c9c-hmb7v                         1/1     Running   0               43d

Aller plus loin

  • Pour en savoir plus sur la Rancher CLI et l'ensemble de ses commandes, consultez la documentation Rancher CLI.

  • Pour obtenir une vue d'ensemble d'OVHcloud Managed Rancher Service, consultez la page OVHcloud Managed Rancher Service.

  • Pour une formation ou une assistance technique sur la mise en œuvre de nos solutions, contactez votre commercial ou consultez la page Professional Services pour obtenir un devis et faire analyser votre projet par nos experts.

  • Notre équipe reste disponible sur notre chaîne Discord dédiée, n'hésitez pas à nous y rejoindre : https://discord.gg/ovhcloud. Posez vos questions, faites-nous part de vos commentaires et interagissez directement avec l'équipe qui développe nos services Container et Orchestration.

  • Échangez avec notre communauté d'utilisateurs.

Cette page vous a-t-elle aidé ?