Installazione o aggiornamento di kubectl - Amazon EKS

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.25 funziona con i cluster Kubernetes 1.24, 1.25 e 1.26.

Installazione o aggiornamento di kubectl.

  1. Determina se disponi già di kubectl installato sul tuo dispositivo.

    kubectl version --short --client

    Se kubectl è già installato nel percorso del tuo dispositivo, l'output di esempio include la riga seguente. Puoi ignorare il messaggio che spiega che --short diventerà l'impostazione predefinita in futuro. Se desideri aggiornare la versione correntemente installata con una versione successiva, completa il passaggio successivo assicurandoti di installare la nuova versione nella stessa posizione in cui si trova la versione corrente.

    Client Version: v1.26.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.26

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.2/2023-03-17/bin/darwin/amd64/kubectl

      • Kubernetes 1.25

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.7/2023-03-17/bin/darwin/amd64/kubectl

      • Kubernetes 1.24

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.11/2023-03-17/bin/darwin/amd64/kubectl

      • Kubernetes 1.23

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2023-03-17/bin/darwin/amd64/kubectl

      • Kubernetes 1.22

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2023-03-17/bin/darwin/amd64/kubectl

      • Kubernetes 1.21

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2023-01-30/bin/darwin/amd64/kubectl

      • Kubernetes 1.20

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.20.15/2022-10-31/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.26

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.2/2023-03-17/bin/darwin/amd64/kubectl.sha256

        • Kubernetes 1.25

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.7/2023-03-17/bin/darwin/amd64/kubectl.sha256

        • Kubernetes 1.24

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.11/2023-03-17/bin/darwin/amd64/kubectl.sha256

        • Kubernetes 1.23

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2023-03-17/bin/darwin/amd64/kubectl.sha256

        • Kubernetes 1.22

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2023-03-17/bin/darwin/amd64/kubectl.sha256

        • Kubernetes 1.21

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2023-01-30/bin/darwin/amd64/kubectl.sha256

        • Kubernetes 1.20

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.20.15/2022-10-31/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 in PATH. Se si dispone già di una versione installata di kubectl, è consigliabile 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 della shell, in modo che sia configurato quando si apre una shell.

      echo 'export PATH=$PATH:$HOME/bin' >> ~/.bash_profile

    6. Dopo l'installazione di kubectl, è possibile verificarne la versione.

      kubectl version --short --client

      Puoi ignorare il messaggio che spiega che --short diventerà l'impostazione predefinita in futuro.

    Linux
    Installazione o aggiornamento di kubectl su Linux

    1. Scarica il file binario kubectl della versione Kubernetes del cluster da Amazon S3utilizzando il comando per la piattaforma hardware del tuo dispositivo. Il primo link per ogni versione è per amd64 mentre il secondo link è per arm64.

      • Kubernetes 1.26

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.2/2023-03-17/bin/linux/amd64/kubectl

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.2/2023-03-17/bin/linux/arm64/kubectl

      • Kubernetes 1.25

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.7/2023-03-17/bin/linux/amd64/kubectl

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.7/2023-03-17/bin/linux/arm64/kubectl

      • Kubernetes 1.24

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.11/2023-03-17/bin/linux/amd64/kubectl

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.11/2023-03-17/bin/linux/arm64/kubectl

      • Kubernetes 1.23

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2023-03-17/bin/linux/amd64/kubectl

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2023-03-17/bin/linux/arm64/kubectl

      • Kubernetes 1.22

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2023-03-17/bin/linux/amd64/kubectl

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2023-03-17/bin/linux/arm64/kubectl

      • Kubernetes 1.21

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2023-01-30/bin/linux/amd64/kubectl

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2023-01-30/bin/linux/arm64/kubectl

      • Kubernetes 1.20

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.20.15/2022-10-31/bin/linux/amd64/kubectl

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.20.15/2022-10-31/bin/linux/arm64/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 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.26

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.2/2023-03-17/bin/linux/amd64/kubectl.sha256

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.2/2023-03-17/bin/linux/arm64/kubectl.sha256

        • Kubernetes 1.25

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.7/2023-03-17/bin/linux/amd64/kubectl.sha256

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.7/2023-03-17/bin/linux/arm64/kubectl.sha256

        • Kubernetes 1.24

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.11/2023-03-17/bin/linux/amd64/kubectl.sha256

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.11/2023-03-17/bin/linux/arm64/kubectl.sha256

        • Kubernetes 1.23

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2023-03-17/bin/linux/amd64/kubectl.sha256

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2023-03-17/bin/linux/arm64/kubectl.sha256

        • Kubernetes 1.22

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2023-03-17/bin/linux/amd64/kubectl.sha256

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2023-03-17/bin/linux/arm64/kubectl.sha256

        • Kubernetes 1.21

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2023-01-30/bin/linux/amd64/kubectl.sha256

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2023-01-30/bin/linux/arm64/kubectl.sha256

        • Kubernetes 1.20

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.20.15/2022-10-31/bin/linux/amd64/kubectl.sha256

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.20.15/2022-10-31/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 in PATH. Se si dispone già di una versione installata di kubectl, è consigliabile 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=$PATH:$HOME/bin

    5. (Facoltativo) Aggiungi il percorso $HOME/bin al file di inizializzazione della shell, in modo che sia configurato quando si apre una shell.

      Nota

      In questo passaggio si presume l'utilizzo della shell Bash; se si sta utilizzando un'altra shell, modificare il comando per utilizzare il file di inizializzazione della shell in uso.

      echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc

    6. Dopo l'installazione di kubectl, è possibile verificarne la versione.

      kubectl version --short --client

      Puoi ignorare il messaggio che spiega che --short diventerà l'impostazione predefinita in futuro.

    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.26

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.2/2023-03-17/bin/windows/amd64/kubectl.exe

      • Kubernetes 1.25

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.7/2023-03-17/bin/windows/amd64/kubectl.exe

      • Kubernetes 1.24

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.11/2023-03-17/bin/windows/amd64/kubectl.exe

      • Kubernetes 1.23

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2023-03-17/bin/windows/amd64/kubectl.exe

      • Kubernetes 1.22

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2023-03-17/bin/windows/amd64/kubectl.exe

      • Kubernetes 1.21

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2023-01-30/bin/windows/amd64/kubectl.exe

      • Kubernetes 1.20

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.20.15/2022-10-31/bin/windows/amd64/kubectl.exe

    3. (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 di Windows.

        • Kubernetes 1.26

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.2/2023-03-17/bin/windows/amd64/kubectl.exe.sha256

        • Kubernetes 1.25

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.7/2023-03-17/bin/windows/amd64/kubectl.exe.sha256

        • Kubernetes 1.24

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.11/2023-03-17/bin/windows/amd64/kubectl.exe.sha256

        • Kubernetes 1.23

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2023-03-17/bin/windows/amd64/kubectl.exe.sha256

        • Kubernetes 1.22

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2023-03-17/bin/windows/amd64/kubectl.exe.sha256

        • Kubernetes 1.21

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2023-01-30/bin/windows/amd64/kubectl.exe.sha256

        • Kubernetes 1.20

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.20.15/2022-10-31/bin/windows/amd64/kubectl.exe.sha256

      2. Controlla la somma di controllo SHA-256 del file binario scaricato.

        Get-FileHash kubectl.exe

      3. Assicurati che la somma di controllo generata nell'output corrisponda alla la somma di controllo nel file scaricato kubectl.sha256. L'output di PowerShell deve essere una stringa di caratteri equivalente in maiuscolo.

    4. Copia il file binario in una cartella in PATH. Se disponi di una directory esistente nel PATHdedicata alle utility a riga di comando, copia il file binario in questa directory. In caso contrario, 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.

    5. Dopo l'installazione di kubectl, è possibile verificarne la versione.

      kubectl version --short --client

      Puoi ignorare il messaggio che spiega che --short diventerà l'impostazione predefinita in futuro.