Installazione, aggiornamento e disinstallazione della versione 1 della AWS CLI su macOS - AWS Command Line Interface

Questa documentazione è valida solo per la Versione 1 della AWS CLI. Per la documentazione relativa alla versione 2 della AWS CLI, consulta la Guida per l’utente per la Versione 2.

Installazione, aggiornamento e disinstallazione della versione 1 della AWS CLI su macOS

Puoi installare AWS Command Line Interface (AWS CLI) versione 1 e le relative dipendenze su macOS usando il programma di installazione in bundle o pip.

Prerequisiti

Prima di installare la versione 1 della AWS CLI su macOS, assicurati di aver installato Python 3.8 o versioni successive. Per istruzioni sull'installazione, consulta la pagina del download di Python nel manuale Beginner Guidedi Python.

Matrice di supporto per la versione Python

Versione AWS CLI Versione di Python supportata
1.39.0 (attuale) Python 3.9+
1.32.0-1.38.38 Python 3.8+
1.27.0-1.31.x Python 3.7+
1.20.0-1.26.x Python 3.6+
1.19.0-1.19.x Python 2.7+, Python 3.6+
1.17-1.18.x Python 2.7+, Python 3.4+
1.0-1.16.x Python 2.6 e versioni precedenti, Python 3.3 e versioni precedenti

Installazione, aggiornamento e disinstallazione della versione 1 della AWS CLI su macOS utilizzando il programma di installazione in bundle

In Linux o macOS, puoi utilizzare il programma di installazione in bundle per installare la versione 1 della AWS Command Line Interface (AWS CLI). Il programma di installazione in bundle include tutte le dipendenze e può essere utilizzato offline.

Non supporta l'installazione in percorsi che contengono spazi.

Installazione della versione 1 della AWS CLI mediante il programma di installazione in bundle con sudo

La procedura riportata di seguito consente di installare la versione 1 della AWS CLI dalla riga di comando su qualsiasi build di macOS.

Il seguente è un riepilogo dei comandi di installazione che puoi tagliare e incollare per eseguirli come un singolo set di comandi.

Per la versione più recente della AWS CLI, utilizza il seguente blocco di comandi:

$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip" unzip awscli-bundle.zip sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws

Per una versione specifica della AWS CLI, aggiungi un trattino e il numero di versione al nome del file. In questo esempio, il nome del file per la versione 1.16.312 sarebbe awscli-bundle-1.16.312.zip, con il seguente comando risultante:

$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip" unzip awscli-bundle.zip sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
Come installare la versione 1 della AWS CLI mediante il programma di installazione in bundle
  1. Scarica il programma di installazione in bundle della versione 1 della AWS CLI in uno dei seguenti modi:

    • Download con il comando curl.

      Per la versione più recente della AWS CLI, utilizza il seguente blocco di comandi:

      $ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"

      Per una versione specifica della AWS CLI, aggiungi un trattino e il numero di versione al nome del file. In questo esempio, il nome del file per la versione 1.16.312 sarebbe awscli-bundle-1.16.312.zip, con il seguente comando risultante:

      $ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
    • Download utilizzando il link diretto.

      Per la versione più recente della AWS CLI: https://s3.amazonaws.com/aws-cli/awscli-bundle.zip

      Per una versione specifica della AWS CLI, aggiungi un trattino e il numero di versione al nome del file. In questo esempio, il nome del file per la versione 1.16.312 sarebbe awscli-bundle-1.16.312.zip, con il seguente URL risultante https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip

  2. Estrazione (decompressione) dei file dal pacchetto. Se non disponi di unzip, usa il programma di gestione dei pacchetti integrato della distribuzione macOs per eseguire l'installazione.

    $ unzip awscli-bundle.zip
  3. Esegui il programma di installazione. Il programma di installazione installa l'AWS CLI in /usr/local/aws e crea il link simbolico aws nella cartella /usr/local/bin. Utilizzando l'opzione -b per creare un link simbolico, si elimina la necessità di specificare la cartella di installazione nella variabile $PATH dell'utente. Questo dovrebbe consentire a tutti gli utenti di richiamare l'AWS CLI digitando aws da qualsiasi directory.

    $ sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws

    Per default, lo script di installazione viene eseguito con la versione di Python di default del sistema. Se è installata una versione alternativa di Python e si intende utilizzare questa per installare l'AWS CLI, eseguire lo script del programma di installazione con tale versione dal percorso assoluto dell'eseguibile di Python, come segue.

    $ sudo /usr/local/bin/python3.7 awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
  4. Verifica che l'AWS CLI sia installata correttamente.

    $ aws --version aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6

    Se si verifica un errore, consulta Risoluzione degli errori per la AWS CLI.

Installazione della versione 1 della AWS CLI mediante il programma di installazione in bundle senza sudo

Se non disponi delle autorizzazioni sudo o desideri installare AWS CLI solo per l'utente corrente, puoi utilizzare una versione modificata dei comandi precedenti. I primi due comandi sono gli stessi.

Per la versione più recente della AWS CLI, utilizza il seguente blocco di comandi:

$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip" unzip awscli-bundle.zip ./awscli-bundle/install -b ~/bin/aws

Per una versione specifica della AWS CLI, aggiungi un trattino e il numero di versione al nome del file. In questo esempio, il nome del file per la versione 1.16.312 sarebbe awscli-bundle-1.16.312.zip, con il seguente comando risultante:

$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip" unzip awscli-bundle.zip ./awscli-bundle/install -b ~/bin/aws
Per installare la versione 1 della AWS CLI per l’utente corrente
  1. Scarica il programma di installazione in bundle della versione 1 della AWS CLI in uno dei seguenti modi:

    • Download con il comando curl.

      Per la versione più recente della AWS CLI, utilizza il seguente blocco di comandi:

      $ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"

      Per una versione specifica della AWS CLI, aggiungi un trattino e il numero di versione al nome del file. In questo esempio, il nome del file per la versione 1.16.312 sarebbe awscli-bundle-1.16.312.zip, con il seguente comando risultante:

      $ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
    • Download utilizzando il link diretto.

      Per la versione più recente della AWS CLI: https://s3.amazonaws.com/aws-cli/awscli-bundle.zip

      Per una versione specifica della AWS CLI, aggiungi un trattino e il numero di versione al nome del file. In questo esempio, il nome del file per la versione 1.16.312 sarebbe awscli-bundle-1.16.312.zip, con il seguente URL risultante https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip

  2. Estrarre i file dal pacchetto. Se non disponi di unzip, usa il programma di gestione dei pacchetti integrato della distribuzione Linux per eseguire l'installazione.

    $ unzip awscli-bundle.zip
  3. Esegui il programma di installazione. Il programma di installazione installa l'AWS CLI in /usr/local/aws e crea il link simbolico aws nella directory /usr/local/bin. L'ultimo comando utilizza il parametro -b per specificare la cartella in cui il programma di installazione posiziona il file di collegamento simbolico aws. È necessario disporre delle autorizzazioni di scrittura nella directory specificata.

    $ ./awscli-bundle/install -b ~/bin/aws

    In questo modo AWS CLI viene installata nella posizione predefinita (~/.local/lib/aws) e viene creato un link simbolico in ~/bin/aws. Per il corretto funzionamento del link simbolico, ~/bin deve trovarsi nella variabile di ambiente $PATH.

    $ echo $PATH | grep ~/bin // See if $PATH contains ~/bin (output will be empty if it doesn't) $ export PATH=~/bin:$PATH // Add ~/bin to $PATH if necessary
  4. Assicurati che la cartella in cui è installata la versione 1 della AWS CLI sia parte della variabile $PATH.

    1. Trova lo script del profilo della tua shell nella tua cartella utente. Se non hai la certezza di quale sia la tua shell, esegui echo $SHELL.

      $ ls -a ~ . .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads
      • Bash: .bash_profile, .profile o .bash_login

      • Zsh.zshrc

      • Tcsh: .tcshrc, .cshrc o .login.

    2. Aggiungi un comando di esportazione al termine dello script del profilo simile a quello dell'esempio seguente.

      export PATH=~/.local/bin:$PATH

      Questo comando inserisce il percorso, ~/.local/bin in questo esempio, all'inizio della variabile PATH corrente.

    3. Ricarica il profilo nella sessione corrente per rendere effettive tali modifiche.

      $ source ~/.bash_profile
  5. Verifica che l'AWS CLI sia installata correttamente.

    $ aws --version aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6

    Se si verifica un errore, consulta Risoluzione degli errori per la AWS CLI.

Disinstallazione del programma di installazione in bundle della versione 1 della AWS CLI

  1. Il programma di installazione in bundle inserisce tutto all'interno della directory di installazione tranne il collegamento simbolico opzionale, quindi per disinstallare, è sufficiente eliminare quei due elementi.

    $ sudo rm -rf /usr/local/aws $ sudo rm /usr/local/bin/aws
  2. (Facoltativo) Rimuovi le informazioni condivise relative all’SDK AWS e alle impostazioni della AWS CLI nella cartella .aws.

    avvertimento

    Queste impostazioni di configurazione e credenziali sono condivise tra tutti gli AWS SDK e la AWS CLI. Se rimuovi questa cartella, nessun AWS SDK ancora presente sul sistema potrà accedervi.

    La posizione predefinita della cartella .aws varia a seconda della piattaforma. Per impostazione predefinita, la cartella si trova in ~/.aws/. Se l’utente dispone dell’autorizzazione di scrittura in questa directory, non è necessario utilizzare sudo.

    $ sudo rm ~/.aws/

Installazione, aggiornamento e disinstallazione della versione 1 della AWS CLI mediante pip

È possibile utilizzare pip direttamente per installare AWS CLI.

Installazione pip.

Se non disponi già di pip installato, puoi installarlo utilizzando lo script fornito da Python Packaging Authority. Esegui pip --version per vedere se la versione di Linux di cui disponi include già Python e pip. Se disponi di Python versione 3 o successiva installato, ti consigliamo di utilizzare il comando pip3.

  1. Utilizza il comando curl per scaricare lo script di installazione. Il comando seguente utilizza il parametro -O (lettera maiuscola O) per specificare che il file scaricato deve essere archiviato nella cartella corrente utilizzando lo stesso nome che ha sull'host remoto.

    $ curl -O https://bootstrap.pypa.io/get-pip.py
  2. Esegui lo script con il comando python o python3 per scaricare e installare la versione più recente di pip e gli altri pacchetti di supporto necessari. Quando includi l'opzione --user, lo script installa pip nel percorso ~/.local/bin.

    $ python3 get-pip.py --user

Installazione e aggiornamento dell'AWS CLI utilizzando pip

  1. Utilizzare il comando pip o pip3 per installare AWS CLI. Se disponi di Python versione 3 successiva, ti consigliamo di utilizzare il comando pip3.

    Per la versione più recente della AWS CLI, utilizza il seguente blocco di comandi:

    $ pip3 install awscli --upgrade --user

    Per una versione specifica della AWS CLI, aggiungi due segni uguale = e il numero di versione al nome del file. In questo esempio, il nome del file per la versione 1:16:312 sarebbe ==1:16:312, con il risultante comando seguente:

    $ pip3 install awscli==1.16.312 --upgrade --user
    Nota

    Attieniti alle regole di utilizzo delle virgolette appropriate per il tuo terminale. Per utilizzare il carattere =, potresti dover utilizzare virgolette singole o doppie per eseguire correttamente l’escape. L’esempio seguente esegue l’escape utilizzando virgolette singole:

    $ pip3 install 'awscli==1.16.312' --upgrade --user
  2. Verifica che l'AWS CLI sia installata correttamente.

    $ aws --version aws-cli/1.40.41 Python/3.11.6 Darwin/23.3.0 botocore/1.18.6

    Se il programma non è presente, aggiungilo al percorso della riga di comando.

Aggiunta dell’eseguibile della versione 1 della AWS CLI al percorso della riga di comando macOS

Dopo avere eseguito l'installazione con pip, potrebbe essere necessario aggiungere il programma aws alla variabile di ambiente PATH del sistema operativo in uso. La posizione del programma dipende dal percorso di installazione di Python.

Esempio Percorso di installazione di AWS CLI - macOS con Python 3.6 e pip (modalità utente)
~/Library/Python/3.7/bin

Sostituisci la versione di Python di cui disponi con la versione dell'esempio precedente.

Se non conosci il percorso di installazione di Python, esegui which python.

$ which python /usr/local/bin/python

L'output potrebbe essere il percorso a un link simbolico, non il programma effettivo. Esegui ls -al per vedere a cosa punta.

$ ls -al /usr/local/bin/python ~/Library/Python/3.7/bin/python3.7

pip installa i programmi nella stessa cartella che contiene l'applicazione Python. Aggiungi questa cartella alla variabile PATH.

Per modificare la variabile PATH
  1. Individua lo script del profilo della shell nella cartella utente. Se non hai la certezza di quale sia la tua shell, esegui echo $SHELL.

    $ ls -a ~ . .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads
    • Bash.bash_profile, .profile, o .bash_login

    • Zsh.zshrc

    • Tcsh.tcshrc, .cshrc, o .login

  2. Aggiungi un comando di esportazione allo script del tuo profilo.

    export PATH=~/.local/bin:$PATH

    Questo comando aggiunge un percorso, in questo esempio ~/.local/bin, per la variabile PATH corrente.

  3. Carica il profilo aggiornato nella sessione corrente.

    $ source ~/.bash_profile

Disinstallazione dell'AWS CLI utilizzando pip

  1. Se la versione 1 della AWS CLI è stata installata utilizzando pip, devi anche disinstallarla utilizzando pip.

    $ pip uninstall awscli

    Se utilizzi Python versione 2 o 3, potresti dover utilizzare il comando pip2 o pip3. Utilizza il comando aws --version per determinare la versione di Python associata alla versione 1 della AWS CLI installata.

    $ pip3 uninstall awscli

    Potrebbe essere necessario riavviare la finestra del prompt dei comandi o il computer per rimuovere tutti i file.

  2. (Facoltativo) Rimuovi le informazioni condivise relative all’SDK AWS e alle impostazioni della AWS CLI nella cartella .aws.

    avvertimento

    Queste impostazioni di configurazione e credenziali sono condivise tra tutti gli AWS SDK e la AWS CLI. Se rimuovi questa cartella, nessun AWS SDK ancora presente sul sistema potrà accedervi.

    La posizione predefinita della cartella .aws varia a seconda della piattaforma. Per impostazione predefinita, la cartella si trova in ~/.aws/. Se l’utente dispone dell’autorizzazione di scrittura in questa directory, non è necessario utilizzare sudo.

    $ sudo rm -rf ~/.aws/

Risoluzione degli errori di installazione e disinstallazione della AWS CLI

Se riscontri problemi dopo l’installazione o la disinstallazione della AWS CLI, consulta la procedura Risoluzione degli errori per la AWS CLI per la risoluzione dei problemi. Per le procedure di risoluzione dei problemi più importanti, consulta Errori di comando non trovato, Il comando aws --version restituisce una versione diversa da quella installata e Il comando aws --version restituisce una versione dopo la disinstallazione della AWS CLI.