Installazione o aggiornamento di kubectl - Amazon EKS

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Installazione o aggiornamento di kubectl

Kubectl è uno strumento a riga di comando utilizzato per comunicare con il server di API Kubernetes. Il file binario kubectl è disponibile in molti gestori di pacchetti del sistema operativo. L'utilizzo di un gestore di pacchetti per l'installazione è spesso più semplice rispetto al download e al processo di installazione manuale.

In questa sezione viene descritto come scaricare e installare o aggiornare il file binario kubectl sul tuo dispositivo. Il file binario è identico alle versioni della community upstream. Il file binario non è esclusivo di Amazon EKS o AWS.

Nota

Utilizza la versione secondaria kubectl immediatamente precedente a quella del piano di controllo del cluster Amazon EKS. Ad esempio, un client kubectl 1.28 funziona con i cluster Kubernetes 1.27, 1.28 e 1.29.

Installazione o aggiornamento di kubectl.
  1. Determina se kubectl è già installato sul tuo dispositivo.

    kubectl version --client

    Se kubectl è già installato nel percorso del tuo dispositivo, l'output di esempio include informazioni simili alle seguenti. Se desideri aggiornare la versione correntemente installata con una versione più recente, completa la fase successiva assicurandoti di installare la nuova versione nella stessa posizione in cui si trova la versione corrente.

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

    Se non ricevi alcun output, allora kubectl non è installato o è installato in una posizione che non si trova nel percorso del dispositivo.

  2. Installazione o aggiornamento di kubectl sui sistemi operativi macOS, Linux e Windows.

    macOS
    Installazione o aggiornamento di kubectl su macOS
    1. Scarica il file binario per la versione Kubernetes del cluster da 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. (Facoltativo) Verifica il file binario scaricato con la rispettiva somma di controllo SHA-256.

      1. Scarica la somma di controllo SHA-256 per la versione Kubernetes del tuo 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. Controlla la somma di controllo SHA-256 del file binario scaricato.

        openssl sha1 -sha256 kubectl
      3. Assicurati che la somma di controllo generata nell'output corrisponda alla la somma di controllo nel file scaricato kubectl.sha256.

    3. Applica le autorizzazioni di esecuzione al file binario.

      chmod +x ./kubectl
    4. Copia il file binario in una cartella nel tuo PATH. Se disponi già di una versione installata di kubectl, consigliamo di creare un $HOME/bin/kubectl e verificare che $HOME/bin venga per primo in $PATH.

      mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$HOME/bin:$PATH
    5. (Facoltativo) Aggiungi il percorso $HOME/bin al file di inizializzazione dello shell (interprete di comandi), in modo che sia configurato all'apertura di quest'ultimo.

      echo 'export PATH=$HOME/bin:$PATH' >> ~/.bash_profile
    Linux (amd64)
    Installazione o aggiornamento di kubectl su Linux (amd64)
    1. Scarica il file binario kubectl per la versione Kubernetes del cluster da 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. (Facoltativo) Verifica il file binario scaricato con il relativo checksum SHA-256.

      1. Scarica la somma di controllo SHA-256 per la versione Kubernetes del cluster da Amazon S3utilizzando il comando per la tua piattaforma hardware. Il primo link per ogni versione è per amd64, mentre il secondo link è per 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. Controlla la somma di controllo SHA-256 del file binario scaricato con uno dei seguenti comandi.

        • sha256sum -c kubectl.sha256

          Quando utilizzi questo comando, assicurati che sia visualizzato il seguente output:

          kubectl: OK
        • openssl sha1 -sha256 kubectl

          Quando utilizzi questo comando, assicurati che la somma di controllo generata nell'output corrisponda alla la somma di controllo nel file scaricato kubectl.sha256.

    3. Applica le autorizzazioni di esecuzione al file binario.

      chmod +x ./kubectl
    4. Copia il file binario in una cartella nel tuo PATH. Se disponi già di una versione installata di kubectl, consigliamo di creare un $HOME/bin/kubectl e verificare che $HOME/bin venga per primo in $PATH.

      mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$HOME/bin:$PATH
    5. (Facoltativo) Aggiungi il percorso $HOME/bin al file di inizializzazione dello shell (interprete di comandi), in modo che sia configurato all'apertura di quest'ultimo.

      Nota

      Questa fase prevede l'utilizzo dello shell (interprete di comandi) Bash; se stai utilizzando un altro shell, modifica il comando per utilizzare il file di inizializzazione dello shell in uso.

      echo 'export PATH=$HOME/bin:$PATH' >> ~/.bashrc
    Linux (arm64)
    Installazione o aggiornamento di kubectl su Linux (arm64)
    1. Scarica il file binario kubectl per la versione Kubernetes del cluster da 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. (Facoltativo) Verifica il file binario scaricato con il relativo checksum SHA-256.

      1. Scarica la somma di controllo SHA-256 per la versione Kubernetes del cluster da Amazon S3utilizzando il comando per la tua piattaforma hardware. Il primo link per ogni versione è per amd64, mentre il secondo link è per 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. Controlla la somma di controllo SHA-256 del file binario scaricato con uno dei seguenti comandi.

        • sha256sum -c kubectl.sha256

          Quando utilizzi questo comando, assicurati che sia visualizzato il seguente output:

          kubectl: OK
        • openssl sha1 -sha256 kubectl

          Quando utilizzi questo comando, assicurati che la somma di controllo generata nell'output corrisponda alla la somma di controllo nel file scaricato kubectl.sha256.

    3. Applica le autorizzazioni di esecuzione al file binario.

      chmod +x ./kubectl
    4. Copia il file binario in una cartella nel tuo PATH. Se disponi già di una versione installata di kubectl, consigliamo di creare un $HOME/bin/kubectl e verificare che $HOME/bin venga per primo in $PATH.

      mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$HOME/bin:$PATH
    5. (Facoltativo) Aggiungi il percorso $HOME/bin al file di inizializzazione dello shell (interprete di comandi), in modo che sia configurato all'apertura di quest'ultimo.

      Nota

      Questa fase prevede l'utilizzo dello shell (interprete di comandi) Bash; se stai utilizzando un altro shell, modifica il comando per utilizzare il file di inizializzazione dello shell in uso.

      echo 'export PATH=$HOME/bin:$PATH' >> ~/.bashrc
    Windows
    Installazione o aggiornamento di kubectl su Windows
    1. Apri un terminale PowerShell.

    2. Scarica il file binario kubectl per la versione Kubernetes del cluster da 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. (Facoltativo) Verifica il file binario scaricato con il relativo checksum SHA-256.

      1. Scarica la somma di controllo SHA-256 per la versione Kubernetes di 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. Controlla il checksum SHA-256 del file binario scaricato.

        Get-FileHash kubectl.exe
      3. Assicurati che il checksum generato nell'output corrisponda al checksum nel file kubectl.sha256 scaricato. L' PowerShelloutput deve essere una stringa di caratteri equivalente in maiuscolo.

    4. Copia il file binario in una cartella nel tuo PATH. Se disponi di una directory esistente nel PATHdedicata alle utility a riga di comando, copia il file binario in questa directory. In alternativa, completa la procedura seguente.

      1. Crea una nuova directory per i file binari della riga di comando, ad esempio C:\bin.

      2. Copia il file binario kubectl.exe nella nuova directory.

      3. Modifica la variabile di ambiente PATH dell'utente o del sistema per aggiungere la nuova directory a PATH.

      4. Chiudi il terminale PowerShell e aprine uno nuovo per rendere effettiva la nuova variabile PATH.

  3. Dopo l'installazione di kubectl, puoi verificarne la versione.

    kubectl version --client

Alla prima installazione, kubectl non è ancora configurato per comunicare con alcun server. Tratteremo questa configurazione, se necessario, in altre procedure. Per aggiornare la configurazione per comunicare con un particolare cluster, è possibile eseguire il comando seguente. Sostituisci region-code con la Regione AWS in cui si trova il cluster. Sostituisci my-cluster con il nome del cluster.

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