Installation ou mise à jour de kubectl - Amazon EKS

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.

Installation ou mise à jour de kubectl

Kubectl est un outil de ligne de commande que vous utilisez pour communiquer avec le serveur d'API Kubernetes. Le fichier binaire kubectl est disponible dans de nombreux gestionnaires de packages de systèmes d'exploitation. L'utilisation d'un gestionnaire de packages pour votre installation est souvent plus facile que celle d'un processus d'installation et de téléchargement manuel.

Cette rubrique vous aide à télécharger et installer ou mettre à jour le fichier binaire kubectl sur votre appareil. Le fichier binaire est identique aux versions communautaires en amont. Le fichier binaire n'est pas propre à Amazon EKS ou AWS.

Note

Vous devez utiliser une version kubectl qui se situe à une différence de version mineure près du plan de contrôle de votre cluster Amazon EKS. Par exemple, un client kubectl 1.28 doit utiliser des clusters Kubernetes, 1.27, 1.28 et 1.29.

Pour installer ou mettre à jour kubectl
  1. Déterminez si vous avez déjà kubectl installé sur votre appareil.

    kubectl version --client

    Si kubectl est installé dans le chemin d'accès de votre appareil, l'exemple de sortie comprend des informations similaires à celles qui suivent. Si vous souhaitez mettre à jour la version que vous avez actuellement installée avec une version plus récente, passez à l'étape suivante en vous assurant d'installer la nouvelle version au même emplacement que votre version actuelle.

    Client Version: v1.29.X-eks-1234567

    Si vous n'obtenez aucune sortie, vous n'avez pas kubectl installé, ou il n'est pas installé dans un emplacement qui se trouve sur le chemin d'accès de votre appareil.

  2. Installation ou mise à jour de kubectl sur les systèmes d'exploitation macOS, Linux, et Windows.

    macOS
    Pour installer ou mettre à jour kubectl sur macOS
    1. Téléchargez le fichier binaire pour la version Kubernetes de votre cluster depuis Amazon S3.

      • Kubernetes 1.29

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.0/2024-01-04/bin/darwin/amd64/kubectl
      • Kubernetes 1.28

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.5/2024-01-04/bin/darwin/amd64/kubectl
      • Kubernetes 1.27

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.9/2024-01-04/bin/darwin/amd64/kubectl
      • Kubernetes 1.26

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.12/2024-01-04/bin/darwin/amd64/kubectl
      • Kubernetes 1.25

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-01-04/bin/darwin/amd64/kubectl
      • Kubernetes 1.24

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-01-04/bin/darwin/amd64/kubectl
      • Kubernetes 1.23

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-01-04/bin/darwin/amd64/kubectl
    2. (Facultatif) Vérifiez le fichier binaire téléchargé avec le total de contrôle SHA-256 de votre fichier binaire.

      1. Télécharger le total de contrôle SHA-256 pour la version Kubernetes de votre cluster.

        • Kubernetes 1.29

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.0/2024-01-04/bin/darwin/amd64/kubectl.sha256
        • Kubernetes 1.28

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.5/2024-01-04/bin/darwin/amd64/kubectl.sha256
        • Kubernetes 1.27

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.9/2024-01-04/bin/darwin/amd64/kubectl.sha256
        • Kubernetes 1.26

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.12/2024-01-04/bin/darwin/amd64/kubectl.sha256
        • Kubernetes 1.25

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-01-04/bin/darwin/amd64/kubectl.sha256
        • Kubernetes 1.24

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-01-04/bin/darwin/amd64/kubectl.sha256
        • Kubernetes 1.23

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-01-04/bin/darwin/amd64/kubectl.sha256
      2. Vérifiez le total de contrôle SHA-256 du fichier binaire téléchargé.

        openssl sha1 -sha256 kubectl
      3. Assurez-vous que le total de contrôle généré dans la sortie correspond à celui du fichier kubectl.sha256 téléchargé.

    3. Appliquez les autorisations d'exécution au fichier binaire.

      chmod +x ./kubectl
    4. Copiez le fichier binaire vers un dossier de votre PATH. Si vous avez déjà installé une version de kubectl, nous vous recommandons de créer un fichier $HOME/bin/kubectl et de vérifier que le fichier $HOME/bin est en premier dans votre $PATH.

      mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$HOME/bin:$PATH
    5. (Facultatif) Ajoutez le chemin $HOME/bin à votre fichier d'initialisation du shell de façon à ce qu'il soit configuré lorsque vous ouvrez un shell.

      echo 'export PATH=$HOME/bin:$PATH' >> ~/.bash_profile
    Linux (amd64)
    Pour installer ou mettre à jour kubectl sur Linux (amd64)
    1. Téléchargez le fichier binaire kubectl pour la version Kubernetes de votre cluster depuis Amazon S3.

      • Kubernetes 1.29

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.0/2024-01-04/bin/linux/amd64/kubectl
      • Kubernetes 1.28

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.5/2024-01-04/bin/linux/amd64/kubectl
      • Kubernetes 1.27

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.9/2024-01-04/bin/linux/amd64/kubectl
      • Kubernetes 1.26

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.12/2024-01-04/bin/linux/amd64/kubectl
      • Kubernetes 1.25

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-01-04/bin/linux/amd64/kubectl
      • Kubernetes 1.24

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-01-04/bin/linux/amd64/kubectl
      • Kubernetes 1.23

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-01-04/bin/linux/amd64/kubectl
    2. (Facultatif) Vérifiez le fichier binaire téléchargé avec le total de contrôle SHA-256 de votre fichier binaire.

      1. Téléchargez le total de contrôle SHA-256 pour la version Kubernetes de votre cluster depuis Amazon S3 à l'aide de la commande correspondant à la plateforme matérielle de votre appareil. Le premier lien pour chaque version est pour amd64 et le second lien est pour arm64.

        • Kubernetes 1.29

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.0/2024-01-04/bin/linux/amd64/kubectl.sha256
        • Kubernetes 1.28

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.5/2024-01-04/bin/linux/amd64/kubectl.sha256
        • Kubernetes 1.27

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.9/2024-01-04/bin/linux/amd64/kubectl.sha256
        • Kubernetes 1.26

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.12/2024-01-04/bin/linux/amd64/kubectl.sha256
        • Kubernetes 1.25

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-01-04/bin/linux/amd64/kubectl.sha256
        • Kubernetes 1.24

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-01-04/bin/linux/amd64/kubectl.sha256
        • Kubernetes 1.23

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-01-04/bin/linux/amd64/kubectl.sha256
      2. Vérifiez le total de contrôle SHA-256 du fichier binaire que vous avez téléchargé à l'aide de l'une des commandes suivantes.

        • sha256sum -c kubectl.sha256

          Lorsque vous utilisez cette commande, assurez-vous que la sortie suivante s'affiche :

          kubectl: OK
        • openssl sha1 -sha256 kubectl

          Lorsque vous utilisez cette commande, assurez-vous que le total de contrôle généré dans la sortie correspond à celui du fichier kubectl.sha256 téléchargé.

    3. Appliquez les autorisations d'exécution au fichier binaire.

      chmod +x ./kubectl
    4. Copiez le fichier binaire vers un dossier de votre PATH. Si vous avez déjà installé une version de kubectl, nous vous recommandons de créer un fichier $HOME/bin/kubectl et de vérifier que le fichier $HOME/bin est en premier dans votre $PATH.

      mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$HOME/bin:$PATH
    5. (Facultatif) Ajoutez le chemin $HOME/bin à votre fichier d'initialisation du shell de façon à ce qu'il soit configuré lorsque vous ouvrez un shell.

      Note

      Cette étape suppose que vous utilisiez le shell Bash ; si vous utilisez un autre shell, modifiez la commande pour utiliser votre propre fichier d'initialisation shell.

      echo 'export PATH=$HOME/bin:$PATH' >> ~/.bashrc
    Linux (arm64)
    Pour installer ou mettre à jour kubectl sur Linux (arm64)
    1. Téléchargez le fichier binaire kubectl pour la version Kubernetes de votre cluster depuis Amazon S3.

      • Kubernetes 1.29

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.0/2024-01-04/bin/linux/arm64/kubectl
      • Kubernetes 1.28

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.5/2024-01-04/bin/linux/arm64/kubectl
      • Kubernetes 1.27

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.9/2024-01-04/bin/linux/arm64/kubectl
      • Kubernetes 1.26

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.12/2024-01-04/bin/linux/arm64/kubectl
      • Kubernetes 1.25

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-01-04/bin/linux/arm64/kubectl
      • Kubernetes 1.24

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-01-04/bin/linux/arm64/kubectl
      • Kubernetes 1.23

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-01-04/bin/linux/arm64/kubectl
    2. (Facultatif) Vérifiez le fichier binaire téléchargé avec le total de contrôle SHA-256 de votre fichier binaire.

      1. Téléchargez le total de contrôle SHA-256 pour la version Kubernetes de votre cluster depuis Amazon S3 à l'aide de la commande correspondant à la plateforme matérielle de votre appareil. Le premier lien pour chaque version est pour amd64 et le second lien est pour arm64.

        • Kubernetes 1.29

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.0/2024-01-04/bin/linux/arm64/kubectl.sha256
        • Kubernetes 1.28

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.5/2024-01-04/bin/linux/arm64/kubectl.sha256
        • Kubernetes 1.27

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.9/2024-01-04/bin/linux/arm64/kubectl.sha256
        • Kubernetes 1.26

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.12/2024-01-04/bin/linux/arm64/kubectl.sha256
        • Kubernetes 1.25

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-01-04/bin/linux/arm64/kubectl.sha256
        • Kubernetes 1.24

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-01-04/bin/linux/arm64/kubectl.sha256
        • Kubernetes 1.23

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-01-04/bin/linux/arm64/kubectl.sha256
      2. Vérifiez le total de contrôle SHA-256 du fichier binaire que vous avez téléchargé à l'aide de l'une des commandes suivantes.

        • sha256sum -c kubectl.sha256

          Lorsque vous utilisez cette commande, assurez-vous que la sortie suivante s'affiche :

          kubectl: OK
        • openssl sha1 -sha256 kubectl

          Lorsque vous utilisez cette commande, assurez-vous que le total de contrôle généré dans la sortie correspond à celui du fichier kubectl.sha256 téléchargé.

    3. Appliquez les autorisations d'exécution au fichier binaire.

      chmod +x ./kubectl
    4. Copiez le fichier binaire vers un dossier de votre PATH. Si vous avez déjà installé une version de kubectl, nous vous recommandons de créer un fichier $HOME/bin/kubectl et de vérifier que le fichier $HOME/bin est en premier dans votre $PATH.

      mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$HOME/bin:$PATH
    5. (Facultatif) Ajoutez le chemin $HOME/bin à votre fichier d'initialisation du shell de façon à ce qu'il soit configuré lorsque vous ouvrez un shell.

      Note

      Cette étape suppose que vous utilisiez le shell Bash ; si vous utilisez un autre shell, modifiez la commande pour utiliser votre propre fichier d'initialisation shell.

      echo 'export PATH=$HOME/bin:$PATH' >> ~/.bashrc
    Windows
    Pour installer ou mettre à jour kubectl sur Windows
    1. Ouvrez un terminal PowerShell.

    2. Téléchargez le fichier binaire kubectl pour la version Kubernetes de votre cluster depuis Amazon S3.

      • Kubernetes 1.29

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.0/2024-01-04/bin/windows/amd64/kubectl.exe
      • Kubernetes 1.28

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.5/2024-01-04/bin/windows/amd64/kubectl.exe
      • Kubernetes 1.27

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.9/2024-01-04/bin/windows/amd64/kubectl.exe
      • Kubernetes 1.26

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.12/2024-01-04/bin/windows/amd64/kubectl.exe
      • Kubernetes 1.25

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-01-04/bin/windows/amd64/kubectl.exe
      • Kubernetes 1.24

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-01-04/bin/windows/amd64/kubectl.exe
      • Kubernetes 1.23

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-01-04/bin/windows/amd64/kubectl.exe
    3. (Facultatif) Vérifiez le fichier binaire téléchargé avec le total de contrôle SHA-256 de votre fichier binaire.

      1. Téléchargez le total de contrôle SHA-256 pour la version Kubernetes de votre cluster pour Windows.

        • Kubernetes 1.29

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.0/2024-01-04/bin/windows/amd64/kubectl.exe.sha256
        • Kubernetes 1.28

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.5/2024-01-04/bin/windows/amd64/kubectl.exe.sha256
        • Kubernetes 1.27

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.9/2024-01-04/bin/windows/amd64/kubectl.exe.sha256
        • Kubernetes 1.26

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.12/2024-01-04/bin/windows/amd64/kubectl.exe.sha256
        • Kubernetes 1.25

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-01-04/bin/windows/amd64/kubectl.exe.sha256
        • Kubernetes 1.24

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-01-04/bin/windows/amd64/kubectl.exe.sha256
        • Kubernetes 1.23

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-01-04/bin/windows/amd64/kubectl.exe.sha256
      2. Vérifiez le total de contrôle SHA-256 du fichier binaire téléchargé.

        Get-FileHash kubectl.exe
      3. Assurez-vous que le total de contrôle généré dans la sortie correspond à celui du fichier kubectl.sha256 téléchargé. La PowerShell sortie doit être une chaîne de caractères équivalente en majuscules.

    4. Copiez le fichier binaire vers un dossier de votre PATH. Si vous disposez déjà d'un répertoire dans votre PATH que vous utilisez pour les utilitaires de ligne de commande, copiez le fichier binaire dans ce répertoire. Sinon, effectuez les étapes suivantes.

      1. Créez un répertoire pour vos fichiers binaires de ligne de commande, par exemple C:\bin.

      2. Copiez le fichier binaire kubectl.exe vers votre nouveau répertoire.

      3. Modifiez la variable d'environnement PATH de votre utilisateur ou système pour ajouter le nouveau répertoire à votre variable PATH.

      4. Fermez votre terminal PowerShell et ouvrez-en un nouveau pour sélectionner la nouvelle variable PATH.

  3. Après avoir installé kubectl, vous pouvez vérifier sa version.

    kubectl version --client

Lors de la première installation de kubectl, il n'est pas encore configuré pour communiquer avec un serveur. Nous aborderons cette configuration au besoin dans d'autres procédures. Si vous devez mettre à jour la configuration pour communiquer avec un cluster en particulier, vous pouvez exécuter la commande suivante. Remplacez region-code par la Région AWS dans laquelle se trouve votre cluster. Remplacez my-cluster par le nom de votre cluster.

aws eks update-kubeconfig --region region-code --name my-cluster