Commencez avec Amazon EKS — eksctl - Amazon EKS

Aidez à améliorer cette page

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Pour contribuer à ce guide de l'utilisateur, cliquez sur le GitHub lien Modifier cette page sur qui se trouve dans le volet droit de chaque page.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Commencez avec Amazon EKS — eksctl

Note

Cette rubrique explique comment démarrer sans le mode automatique EKS.

Le mode automatique d'EKS automatise les tâches de routine pour le calcul, le stockage et la mise en réseau en cluster. Découvrez comment démarrer avec le mode automatique d'Amazon EKS.

Ce guide vous permet de créer toutes les ressources nécessaires pour commencer à utiliser Amazon Elastic Kubernetes Service (Amazon EKS) avec eksctl, un utilitaire de ligne de commande simple pour créer et gérer les clusters Kubernetes sur Amazon EKS. À la fin de ce didacticiel, vous disposerez d'un cluster Amazon EKS en cours d'exécution sur lequel vous pouvez déployer des applications.

Les procédures de ce guide créent automatiquement plusieurs ressources que vous devez créer manuellement lorsque vous créez votre cluster à l'aide de l'outil AWS Management Console. Si vous préférez créer manuellement la plupart des ressources pour mieux comprendre comment elles interagissent les unes avec les autres, utilisez le AWS Management Console pour créer votre cluster et effectuer des calculs. Pour de plus amples informations, veuillez consulter Démarrez avec Amazon EKS AWS Management Console et la AWS CLI.

Prérequis

Avant de commencer ce didacticiel, vous devez installer et configurer les outils AWS CLI, kubectl et eksctl comme décrit dans Configuration pour utiliser Amazon EKS.

Étape 1 : créer votre cluster Amazon EKS et votre nœud

Important

Pour démarrer le plus simplement et le plus rapidement possible, cette rubrique inclut les étapes pour créer un cluster et des nœuds avec des paramètres par défaut. Avant de créer un cluster et des nœuds pour une utilisation en production, nous vous recommandons de vous familiariser avec tous les paramètres et de déployer un cluster et des nœuds avec les paramètres qui répondent à vos besoins. Pour plus d’informations, consultez Création d'un cluster Amazon EKS et Gérez les ressources informatiques à l'aide de nœuds. Certains paramètres ne peuvent être activés que lors de la création de votre cluster et de vos nœuds.

Vous pouvez créer un cluster à l'aide de l'un des types de nœuds suivants. Pour en savoir plus sur chaque type, consultez Gérez les ressources informatiques à l'aide de nœuds. Une fois votre cluster déployé, vous pouvez ajouter d'autres types de nœuds.

  • Fargate — Linux — Sélectionnez ce type de nœud si vous souhaitez exécuter des applications Linux sur. Simplifiez la gestion des calculs avec AWS Fargate Fargate est un moteur de calcul sans serveur qui vous permet de déployer des pods Kubernetes sans gérer les instances Amazon. EC2

  • Nœuds gérés — Linux — Sélectionnez ce type de nœud si vous souhaitez exécuter des applications Amazon Linux sur des EC2 instances Amazon. Bien que cela ne soit pas inclus dans ce guide, vous pouvez également ajouter les nœuds autogérés par Windows et Bottlerocket à votre cluster.

Créez votre cluster Amazon EKS à l'aide de la commande suivante. Vous pouvez remplacer my-cluster par votre propre valeur. Un nom ne peut contenir que des caractères alphanumériques (sensibles à la casse) et des traits d'union. Il doit commencer par un caractère alphanumérique et ne doit pas dépasser 100 caractères. Le nom doit être unique au sein de la AWS région et du AWS compte dans lesquels vous créez le cluster. Remplacez region-code par n'importe quelle AWS région prise en charge par Amazon EKS. Pour obtenir la liste des AWS régions, consultez la section Points de terminaison et quotas Amazon EKS dans le guide de référence AWS général.

Fargate - Linux
eksctl create cluster --name my-cluster --region region-code --fargate
Managed nodes - Linux
eksctl create cluster --name my-cluster --region region-code

La création du cluster prend plusieurs minutes. Au cours de la création, vous verrez plusieurs lignes de sortie. La dernière ligne de sortie est similaire à celle de l'exemple suivant.

[...]
[✓]  EKS cluster "my-cluster" in "region-code" region is ready

eksctla créé un fichier de kubectl configuration ~/.kube/config ou ajouté la configuration du nouveau cluster dans un fichier de configuration existant ~/.kube/config sur votre ordinateur.

Une fois la création du cluster terminée, consultez la AWS CloudFormation pile nommée eksctl-my-cluster-cluster dans la AWS CloudFormation console pour voir toutes les ressources créées.

Étape 2 : Afficher les ressources Kubernetes

  1. Affichez vos nœuds de cluster.

    kubectl get nodes -o wide

    L'exemple qui suit illustre un résultat.

    Fargate - Linux
    NAME STATUS ROLES AGE VERSION INTERNAL-IP EXTERNAL-IP OS-IMAGE KERNEL-VERSION CONTAINER-RUNTIME fargate-ip-192-0-2-0.region-code.compute.internal Ready <none> 8m3s v1.2.3-eks-1234567 192.0.2.0 <none> Amazon Linux 2 1.23.456-789.012.amzn2.x86_64 containerd://1.2.3 fargate-ip-192-0-2-1.region-code.compute.internal Ready <none> 7m30s v1.2.3-eks-1234567 192-0-2-1 <none> Amazon Linux 2 1.23.456-789.012.amzn2.x86_64 containerd://1.2.3
    Managed nodes - Linux
    NAME STATUS ROLES AGE VERSION INTERNAL-IP EXTERNAL-IP OS-IMAGE KERNEL-VERSION CONTAINER-RUNTIME ip-192-0-2-0.region-code.compute.internal Ready <none> 6m7s v1.2.3-eks-1234567 192.0.2.0 192.0.2.2 Amazon Linux 2 1.23.456-789.012.amzn2.x86_64 containerd://1.2.3 ip-192-0-2-1.region-code.compute.internal Ready <none> 6m4s v1.2.3-eks-1234567 192.0.2.1 192.0.2.3 Amazon Linux 2 1.23.456-789.012.amzn2.x86_64 containerd://1.2.3

    Pour plus d'informations sur les éléments que vous voyez en sortie, consultez Consultez les ressources Kubernetes dans AWS Management Console.

  2. Affichez les applications en cours d'exécution sur votre cluster.

    kubectl get pods -A -o wide

    L'exemple qui suit illustre un résultat.

    Fargate - Linux
    NAMESPACE NAME READY STATUS RESTARTS AGE IP NODE NOMINATED NODE READINESS GATES kube-system coredns-1234567890-abcde 1/1 Running 0 18m 192.0.2.0 fargate-ip-192-0-2-0.region-code.compute.internal <none> <none> kube-system coredns-1234567890-12345 1/1 Running 0 18m 192.0.2.1 fargate-ip-192-0-2-1.region-code.compute.internal <none> <none>
    Managed nodes - Linux
    NAMESPACE NAME READY STATUS RESTARTS AGE IP NODE NOMINATED NODE READINESS GATES kube-system aws-node-12345 1/1 Running 0 7m43s 192.0.2.1 ip-192-0-2-1.region-code.compute.internal <none> <none> kube-system aws-node-67890 1/1 Running 0 7m46s 192.0.2.0 ip-192-0-2-0.region-code.compute.internal <none> <none> kube-system coredns-1234567890-abcde 1/1 Running 0 14m 192.0.2.3 ip-192-0-2-3.region-code.compute.internal <none> <none> kube-system coredns-1234567890-12345 1/1 Running 0 14m 192.0.2.4 ip-192-0-2-4.region-code.compute.internal <none> <none> kube-system kube-proxy-12345 1/1 Running 0 7m46s 192.0.2.0 ip-192-0-2-0.region-code.compute.internal <none> <none> kube-system kube-proxy-67890 1/1 Running 0 7m43s 192.0.2.1 ip-192-0-2-1.region-code.compute.internal <none> <none>

    Pour plus d'informations sur les éléments que vous voyez en sortie, consultez Consultez les ressources Kubernetes dans AWS Management Console.

Étape 3 : supprimer votre cluster et vos nœuds

Une fois que vous avez terminé avec le cluster et les nœuds que vous avez créés pour ce didacticiel, vous devez nettoyer en supprimant le cluster et les nœuds à l'aide de la commande suivante. Si vous souhaitez exécuter d'autres opérations avec ce cluster avant le nettoyage, consultez Étapes suivantes.

eksctl delete cluster --name my-cluster --region region-code

Étapes suivantes

Les rubriques suivantes de la documentation vous aideront à étendre les fonctionnalités de votre cluster.