Ce document a été traduit à l'aide d'une technologie de traduction automatique. Bien que nous nous efforcions de fournir des traductions exactes, nous ne fournissons aucune garantie quant à l'exhaustivité, l'exactitude ou la fiabilité du contenu traduit. En cas de divergence, la version originale anglaise prévaut et fait foi.

Helm CLI : démarrage rapide

Ces instructions décrivent une méthode rapide pour configurer une installation de Rancher à titre de preuve de concept.

Ces instructions supposent que vous disposez d’une machine virtuelle Linux avec laquelle vous communiquerez depuis votre poste de travail local. Rancher sera installé sur la machine Linux. Vous devrez récupérer l’adresse IP de cette machine afin de pouvoir accéder à Rancher depuis votre poste de travail local. Rancher est conçu pour gérer des clusters Kubernetes à distance, donc tout cluster Kubernetes que Rancher gérera à l’avenir devra également être en mesure d’atteindre cette adresse IP.

Nous ne recommandons pas d’installer Rancher localement car cela crée un problème de réseau. L’installation de Rancher sur hôte local ne permet pas à Rancher de communiquer avec les clusters Kubernetes en aval, donc sur hôte local, vous ne pourriez pas tester les fonctionnalités de provisionnement ou de gestion des clusters de Rancher.

Votre machine Linux peut être n’importe où. Cela pourrait être une instance Amazon EC2, un droplet Digital Ocean ou une machine virtuelle Azure, pour ne citer que quelques exemples. D’autres documents de Rancher utilisent souvent 'nœud' comme terme générique pour tous ceux-ci. Une façon possible de déployer une machine Linux est de configurer une instance Amazon EC2 comme indiqué dans ce tutoriel.

Les exigences d’installation complètes sont ici.

Installer SUSE® Rancher Prime: K3s sur Linux

Rancher doit être installé sur une version Kubernetes prise en charge. Pour savoir quelles versions de Kubernetes sont prises en charge pour votre version de Rancher, veuillez vous référer à la Matrice de support Rancher.

Pour spécifier la version K3s (Kubernetes), utilisez la variable d’environnement INSTALL_K3S_VERSION (par exemple, INSTALL_K3S_VERSION="v1.24.10+k3s1") lors de l’exécution du script d’installation K3s.

Installez un cluster K3s en exécutant cette commande sur la machine Linux :

curl -sfL https://get.k3s.io | INSTALL_K3S_VERSION=<VERSION> sh -s - server --cluster-init

L’utilisation de --cluster-init permet à K3s d’utiliser etcd intégré comme base de données et a la capacité de se convertir en configuration de haute disponibilité. Référez-vous à Haute disponibilité avec base de données intégrée.

Enregistrez l’IP de la machine Linux.

Enregistrez le kubeconfig sur votre station de travail

Le fichier kubeconfig est important pour accéder au cluster Kubernetes. Copiez le fichier à /etc/rancher/k3s/k3s.yaml depuis la machine Linux et enregistrez-le sur votre poste de travail local dans le répertoire ~/.kube/config. Une façon de le faire est d’utiliser l’outil scp et d’exécuter cette commande sur votre machine locale :

  • Mac et Linux

  • Windows

scp root@<IP_OF_LINUX_MACHINE>:/etc/rancher/k3s/k3s.yaml ~/.kube/config

Dans certains cas, il peut être nécessaire de s’assurer que votre shell a la variable d’environnement KUBECONFIG=~/.kube/config définie, par exemple, elle peut être exportée dans vos fichiers de profil ou rc.

Par défaut, "scp" n’est pas une commande reconnue, donc nous devons d’abord installer un module.

Dans Windows Powershell :

Find-Module Posh-SSH
Install-Module Posh-SSH

## Get the remote kubeconfig file
scp root@<IP_OF_LINUX_MACHINE>:/etc/rancher/k3s/k3s.yaml $env:USERPROFILE\.kube\config

Modifiez l’URL du serveur Rancher dans le kubeconfig

Dans le fichier kubeconfig, vous devrez changer la valeur du champ server en <IP_OF_LINUX_NODE>:6443. Le serveur API Kubernetes sera accessible au port 6443, tandis que le serveur Rancher sera accessible aux ports 80 et 443. Cette modification est nécessaire afin que lorsque vous exécutez des commandes Helm ou kubectl depuis votre station de travail locale, vous puissiez communiquer avec le cluster Kubernetes sur lequel Rancher sera installé.

  • Mac et Linux

  • Windows

Une façon d’ouvrir le fichier kubeconfig pour l’édition est d’utiliser Vim :

vi ~/.kube/config

Appuyez sur i pour mettre Vim en mode insertion. Pour enregistrer votre travail, appuyez sur Esc. Ensuite, appuyez sur :wq puis sur Enter.

Dans Windows Powershell, vous pouvez utiliser notepad.exe pour éditer le fichier kubeconfig :

notepad.exe $env:USERPROFILE\.kube\config

Une fois modifié, appuyez soit sur ctrl+s, soit allez à File > Save pour enregistrer votre travail.

Installez Rancher avec Helm

Ensuite, depuis votre station de travail locale, exécutez les commandes suivantes. Vous devez avoir kubectl et helm installés.

Pour voir les options de personnalisation de l’installation de cert-manager (y compris pour les cas où votre cluster utilise des PodSecurityPolicies), consultez la documentation de cert-manager.

 
helm repo add rancher-prime <helm-chart-repo-url>

To learn more about the Rancher Prime Helm chart repository URL, see our Prime-only documentation. Authentication is required. Use your SUSE Customer Center (SCC) credentials to log in.

 
kubectl create namespace cattle-system

kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/<VERSION>/cert-manager.crds.yaml

helm repo add jetstack https://charts.jetstack.io

helm repo update

helm install cert-manager jetstack/cert-manager \
  --namespace cert-manager \
  --create-namespace

# Windows Powershell
helm install cert-manager jetstack/cert-manager `
  --namespace cert-manager `
  --create-namespace

La commande finale pour installer Rancher est ci-dessous. La commande nécessite un nom de domaine qui redirige le trafic vers la machine Linux. Pour des raisons de simplicité dans ce tutoriel, vous pouvez utiliser un faux nom de domaine pour créer votre preuve de concept. Un exemple de faux nom de domaine serait <IP_OF_LINUX_NODE>.sslip.io.

Pour installer une version spécifique de Rancher, utilisez le drapeau --version (par exemple, --version 2.6.6). Sinon, la dernière version de Rancher est installée par défaut.

Voir Configuration du mot de passe de démarrage pour les exigences de mot de passe.

helm install rancher rancher-prime/rancher \
  --namespace cattle-system \
  --set hostname=<IP_OF_LINUX_NODE>.sslip.io \
  --set replicas=1 \
  --set bootstrapPassword=<PASSWORD_FOR_RANCHER_ADMIN>

# Windows Powershell

helm install rancher rancher-prime/rancher `
  --namespace cattle-system `
  --set hostname=<IP_OF_LINUX_NODE>.sslip.io `
  --set replicas=1 `
  --set bootstrapPassword=<PASSWORD_FOR_RANCHER_ADMIN>

Maintenant, si vous naviguez vers <IP_OF_LINUX_NODE>.sslip.io dans un navigateur web, vous devriez voir l’interface utilisateur de Rancher.

Pour simplifier ces instructions, nous avons utilisé un faux nom de domaine et des certificats auto-signés pour effectuer cette installation. Par conséquent, vous devrez probablement ajouter une exception de sécurité à votre navigateur web pour voir l’interface utilisateur de Rancher. Notez que pour les installations en production, vous auriez besoin d’une configuration à haute disponibilité avec un équilibreur de charge, un vrai nom de domaine et de vrais certificats.

Ces instructions omettent également les exigences d’installation complètes et d’autres options d’installation. Si vous rencontrez des problèmes avec ces étapes, consultez la documentation complète de l’installation de Helm CLI.

Pour lancer de nouveaux clusters Kubernetes avec votre nouveau serveur Rancher, vous devrez peut-être configurer des identifiants cloud dans Rancher. Pour plus d’informations, consultez Lancement de clusters Kubernetes avec Rancher.