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.

Lancement de Kubernetes sur des nœuds personnalisés existants.

Lorsque vous créez un cluster personnalisé, Rancher peut utiliser RKE2/K3s pour créer un cluster Kubernetes sur des serveurs de matériel sans système d’exploitation sur site, des machines virtuelles sur site ou sur tout nœud hébergé par un fournisseur d’infrastructure.

Pour utiliser cette option, vous devez avoir accès aux serveurs qui feront partie de votre cluster Kubernetes. Provisionnez chaque serveur selon les exigences. Ensuite, exécutez la commande fournie dans l’interface utilisateur de Rancher sur chaque serveur pour le convertir en nœud Kubernetes.

Cette section décrit comment configurer un cluster personnalisé.

Créer un cluster avec des nœuds personnalisés

Vous souhaitez utiliser des hôtes Windows comme nœuds de travail Kubernetes ?

Consultez Configuration des clusters personnalisés pour Windows avant de commencer.

1. Provisionnez un hôte Linux

Commencez la création d’un cluster personnalisé en provisionnant un hôte Linux. Votre hôte peut être :

  • Une machine virtuelle (VM) hébergée dans le cloud

  • Une VM sur site

  • Un serveur en matériel sans système d’exploitation

Si vous souhaitez réutiliser un nœud d’un cluster personnalisé précédent, nettoyez le nœud avant de l’utiliser à nouveau dans un cluster. Si vous réutilisez un nœud qui n’a pas été nettoyé, le provisionnement du cluster peut échouer.

Provisionnez l’hôte selon les exigences d’installation et la liste de contrôle pour des clusters prêts pour la production.

Cluster uniquement IPv6

Pour un cluster uniquement IPv6, assurez-vous que votre système d’exploitation configure correctement le fichier /etc/hosts.

::1       localhost

2. Créer le cluster personnalisé

  1. Cliquez sur ☰ > Gestion des clusters.

  2. Sur la page Clusters, cliquez sur Créer.

  3. Cliquez sur Personnaliser.

  4. Entrez un Nom de cluster.

  5. Utilisez la section Configuration du cluster pour configurer le cluster. Pour plus d’informations, consultez Référence de configuration du cluster RKE2 et Référence de configuration du cluster K3s.

    Nœuds Windows

    Pour en savoir plus sur l’utilisation des nœuds Windows en tant que nœuds de travail Kubernetes, consultez Lancement de Kubernetes sur des clusters Windows.

  6. Cliquez sur Create.

    Résultat : L’interface utilisateur redirige vers la page Inscription, où vous pouvez générer la commande d’inscription pour vos nœuds.

  7. Dans Rôle du nœud, sélectionnez les rôles que vous souhaitez attribuer à un nœud de cluster. Vous devez provisionner au moins un nœud pour chaque rôle : etcd, nœud de travail et plan de contrôle. Un cluster personnalisé nécessite les trois rôles pour terminer le provisionnement. Pour plus d’informations sur les rôles, consultez Rôles pour les nœuds dans les clusters Kubernetes.

    Serveur en matériel sans système d’exploitation

    Si vous prévoyez de dédier des serveurs en matériel sans système d’exploitation à chaque rôle, vous devez provisionner un serveur en matériel sans système d’exploitation pour chaque rôle (c’est-à-dire, provisionner plusieurs serveurs en matériel sans système d’exploitation).

  8. Facultatives : Cliquez sur Afficher les options avancées pour configurer des paramètres supplémentaires tels que spécifier l’adresse IP, remplacer le nom d’hôte du nœud ou ajouter étiquettes ou taints au nœud.

    • Les champs IP publique du nœud et IP privée du nœud peuvent accepter soit une seule adresse, soit une liste d’adresses séparées par des virgules (par exemple : 10.0.0.5,2001:db8::1).
    Cluster uniquement IPv6 ou à double pile

    • Dans les clusters uniquement IPv6 et à double pile, vous devez spécifier l'adresse IPv6 du nœud comme IP privée du nœud.

  9. Copiez la commande affichée à l’écran dans votre presse-papiers.

  10. Connectez-vous à votre hôte Linux en utilisant votre shell préféré, tel que PuTTy ou une connexion Terminal à distance. Exécutez la commande copiée dans votre presse-papiers.

Répétez les étapes 7 à 10 si vous souhaitez dédier des hôtes spécifiques à des rôles de nœud spécifiques. Répétez les étapes autant de fois que nécessaire.

Résultat :

Le cluster est créé et passe à l’état Mise à jour pendant que Rancher initialise et provisionne les composants du cluster.

Vous pouvez accéder à votre cluster après que son état soit mis à jour à Actif.

Les clusters Actifs sont assignés à deux Projets :

  • Default, contenant l’espace de noms default

  • System, contenant les espaces de noms cattle-system, traefik, kube-public et kube-system

3. Amazon uniquement : Ajouter des balises aux ressources

Si vous avez configuré votre cluster pour utiliser Amazon en tant que fournisseur de cloud, ajoutez une balise à vos ressources AWS avec un ID de cluster.

Documentation Amazon : Ajouter des balises à vos ressources Amazon EC2

Vous pouvez utiliser des instances Amazon EC2 sans configurer de fournisseur de cloud dans Kubernetes. Vous devez uniquement configurer le fournisseur de cloud si vous souhaitez utiliser des fonctionnalités spécifiques au fournisseur de cloud Kubernetes. Pour plus d’informations, voir Fournisseurs de cloud Kubernetes

Les ressources suivantes doivent être balisées avec un ClusterID :

  • Nœuds : Tous les hôtes ajoutés dans Rancher.

  • Sous-réseau : Le sous-réseau utilisé pour votre cluster

  • Groupe de sécurité : Le groupe de sécurité utilisé pour votre cluster.

Ne balisez pas plusieurs groupes de sécurité. Baliser plusieurs groupes génère une erreur lors de la création de l’Elastic Load Balancer.

La balise qui doit être utilisée est :

Key=kubernetes.io/cluster/<CLUSTERID>, Value=owned

<CLUSTERID> peut être n’importe quelle chaîne que vous choisissez. Cependant, la même chaîne doit être utilisée sur chaque ressource que vous taguez. Définir la valeur de la balise à owned informe le cluster que toutes les ressources balisées avec le <CLUSTERID> sont possédées et gérées par ce cluster.

Si vous partagez des ressources entre des clusters, vous pouvez changer la balise en :

Key=kubernetes.io/cluster/CLUSTERID, Value=shared

Étapes suivantes optionnelles

Après avoir créé votre cluster, vous pouvez y accéder via l’interface utilisateur de Rancher. En tant que meilleure pratique, nous recommandons de mettre en place ces méthodes alternatives pour accéder à votre cluster :

  • Accédez à votre cluster avec la CLI kubectl : Suivez ces étapes pour accéder aux clusters avec kubectl sur votre station de travail. Dans ce cas, vous serez authentifié via le proxy d’authentification du serveur Rancher, puis Rancher vous connectera au cluster en aval. Cette méthode vous permet de gérer le cluster sans l’interface utilisateur de Rancher.

  • Accédez à votre cluster avec la CLI kubectl, en utilisant le point de terminaison de cluster autorisé : Suivez ces étapes pour accéder directement à votre cluster avec kubectl, sans vous authentifier via Rancher. Nous recommandons de mettre en place cette méthode alternative pour accéder à votre cluster afin que, dans le cas où vous ne pouvez pas vous connecter à Rancher, vous puissiez toujours accéder au cluster.