Installazione di kubectl - Amazon EKS

Installazione di kubectl

Kubernetes utilizza una utility della riga di comando denominata kubectl per comunicare con il server API del cluster. Il file binario kubectl è disponibile in molti pacchetti di gestione dei sistemi operativi; questa opzione è spesso molto più semplice rispetto al download e al processo di installazione manuale. È possibile seguire le istruzioni di installazione specifiche per il tuo pacchetto di gestione o sistema operativo disponibili nella documentazione Kubernetes.

Questo argomento aiuta a eseguire il download e a installare i file binari forniti da Amazon EKS kubectl per i sistemi operativi MacOS, Linux e Windows. Selezionare il nome della scheda del proprio sistema operativo. Questi file binari sono identici alle versioni della community di upstream e non sono esclusivi 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.20 deve funzionare con cluster Kubernetes 1.19, 1.20 e 1.21.

Selezionare la scheda con il nome del sistema operativo su cui si desidera installare kubectl.

macOS

Per installare kubectl su macOS

  1. Da Amazon S3 eseguire il download del file binario kubectl fornito da Amazon EKS per la versione Kubernetes del cluster.

    • Kubernetes 1.21

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.21.2/2021-07-05/bin/darwin/amd64/kubectl
    • Kubernetes 1.20

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.20.4/2021-04-12/bin/darwin/amd64/kubectl
    • Kubernetes 1.19

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.19.6/2021-01-05/bin/darwin/amd64/kubectl
    • Kubernetes 1.18

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/darwin/amd64/kubectl
    • Kubernetes 1.17

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.17.12/2020-11-02/bin/darwin/amd64/kubectl
  2. (Facoltativo) Verificare il file binario scaricato con il checksum SHA-256 relativo al file binario.

    1. Scaricare il checksum SHA-256 per la versione Kubernetes del cluster per macOS.

      • Kubernetes 1.21

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.21.2/2021-07-05/bin/darwin/amd64/kubectl.sha256
      • Kubernetes 1.20

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.20.4/2021-04-12/bin/darwin/amd64/kubectl.sha256
      • Kubernetes 1.19

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.19.6/2021-01-05/bin/darwin/amd64/kubectl.sha256
      • Kubernetes 1.18

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/darwin/amd64/kubectl.sha256
      • Kubernetes 1.17

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.17.12/2020-11-02/bin/darwin/amd64/kubectl.sha256
    2. Controlla il checksum SHA-256 per il file binario scaricato.

      openssl sha1 -sha256 kubectl
    3. Confronta il checksum SHA-256 generato nell'output del comando con il file SHA-256 scaricato. I due valori devono corrispondere.

  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 con il comando seguente:

    kubectl version --short --client
Linux

Per installare kubectl su Linux

  1. Esegui il download da Amazon S3 del file binario kubectl fornito da Amazon EKS per la versione Kubernetes del cluster tramite il comando per la tua piattaforma hardware.

    • Kubernetes 1.21

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.21.2/2021-07-05/bin/linux/amd64/kubectl
      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.21.2/2021-07-05/bin/linux/arm64/kubectl
    • Kubernetes 1.20

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.20.4/2021-04-12/bin/linux/amd64/kubectl
      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.20.4/2021-04-12/bin/linux/arm64/kubectl
    • Kubernetes 1.19

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.19.6/2021-01-05/bin/linux/amd64/kubectl
      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.19.6/2021-01-05/bin/linux/arm64/kubectl
    • Kubernetes 1.18

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/linux/amd64/kubectl
      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/linux/arm64/kubectl
    • Kubernetes 1.17

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.17.12/2020-11-02/bin/linux/amd64/kubectl
      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.17.12/2020-11-02/bin/linux/arm64/kubectl
  2. (Facoltativo) Verificare il file binario scaricato con il checksum SHA-256 relativo al file binario.

    1. Scaricare la somma SHA-256 per la versione Kubernetes del cluster per Linux tramite il comando per la propria piattaforma hardware.

      • Kubernetes 1.21

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.21.2/2021-07-05/bin/linux/amd64/kubectl.sha256
        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.21.2/2021-07-05/bin/linux/arm64/kubectl.sha256
      • Kubernetes 1.20

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.20.4/2021-04-12/bin/linux/amd64/kubectl.sha256
        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.20.4/2021-04-12/bin/linux/arm64/kubectl.sha256
      • Kubernetes 1.19

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.19.6/2021-01-05/bin/linux/amd64/kubectl.sha256
        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.19.6/2021-01-05/bin/linux/arm64/kubectl.sha256
      • Kubernetes 1.18

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/linux/amd64/kubectl.sha256
        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/linux/arm64/kubectl.sha256
      • Kubernetes 1.17

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.17.12/2020-11-02/bin/linux/amd64/kubectl.sha256
        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.17.12/2020-11-02/bin/linux/arm64/kubectl.sha256
    2. Controlla il checksum SHA-256 per il file binario scaricato.

      openssl sha1 -sha256 kubectl
    3. Confronta il checksum SHA-256 generato nell'output del comando con il file SHA-256 scaricato. I due valori devono corrispondere.

  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 con il comando seguente:

    kubectl version --short --client
Windows

Per installare kubectl su Windows

  1. Aprire un terminale PowerShell.

  2. Da Amazon S3 eseguire il download del file binario kubectl fornito da Amazon EKS per la versione Kubernetes del cluster.

    • Kubernetes 1.21

      curl -o kubectl.exe https://amazon-eks.s3.us-west-2.amazonaws.com/1.21.2/2021-07-05/bin/windows/amd64/kubectl.exe
    • Kubernetes 1.20

      curl -o kubectl.exe https://amazon-eks.s3.us-west-2.amazonaws.com/1.20.4/2021-04-12/bin/windows/amd64/kubectl.exe
    • Kubernetes 1.19

      curl -o kubectl.exe https://amazon-eks.s3.us-west-2.amazonaws.com/1.19.6/2021-01-05/bin/windows/amd64/kubectl.exe
    • Kubernetes 1.18

      curl -o kubectl.exe https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/windows/amd64/kubectl.exe
    • Kubernetes 1.17

      curl -o kubectl.exe https://amazon-eks.s3.us-west-2.amazonaws.com/1.17.12/2020-11-02/bin/windows/amd64/kubectl.exe
  3. (Facoltativo) Verificare il file binario scaricato con il checksum SHA-256 relativo al file binario.

    1. Scaricare il checksum SHA-256 per la versione Kubernetes del cluster per Windows.

      • Kubernetes 1.21

        curl -o kubectl.exe.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.21.2/2021-07-05/bin/windows/amd64/kubectl.exe.sha256
      • Kubernetes 1.20

        curl -o kubectl.exe.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.20.4/2021-04-12/bin/windows/amd64/kubectl.exe.sha256
      • Kubernetes 1.19

        curl -o kubectl.exe.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.19.6/2021-01-05/bin/windows/amd64/kubectl.exe.sha256
      • Kubernetes 1.18

        curl -o kubectl.exe.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/windows/amd64/kubectl.exe.sha256
      • Kubernetes 1.17

        curl -o kubectl.exe.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.17.12/2020-11-02/bin/windows/amd64/kubectl.exe.sha256
    2. Controlla il checksum SHA-256 per il file binario scaricato.

      Get-FileHash kubectl.exe
    3. Confronta il checksum SHA-256 generato nell'output del comando con il file SHA-256 scaricato. I due devono corrispondere, anche se l'output di PowerShell sarà in caratteri maiuscoli.

  4. Copia il file binario in una cartella in PATH. Se si dispone di una directory esistente nel PATH dedicata 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 al 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 con il comando seguente:

    kubectl version --short --client