Perché compilare dall’origine?Passaggi rapidi Passaggio 1: configurare tutti i requisiti Fase 2: Configurazione dell'installazione del codice sorgente AWS CLI Fase 3: Creazione del AWS CLI Fase 4: Installazione di AWS CLI Fase 5: Verifica dell'installazione AWS CLI Esempi di flussi di lavoro Risoluzione degli errori di AWS CLI installazione e disinstallazione Fasi successive

Compilazione e installazione del file AWS CLI dal codice sorgente

Questo argomento descrive come installare o aggiornare dall’origine l’ultima versione di AWS Command Line Interface (AWS CLI) sui sistemi operativi supportati.

Per informazioni sulle ultime versioni di AWS CLI, consulta il Changelog della AWS CLI versione 2 su. GitHub

Importante

AWS CLI le versioni 1 e 2 utilizzano lo stesso nome di aws comando. Se in precedenza hai installato AWS CLI la versione 1, vediGuida alla migrazione per la AWS CLI versione 2.

Argomenti

Perché compilare dall’origine?
Passaggi rapidi
Passaggio 1: configurare tutti i requisiti
Fase 2: Configurazione dell'installazione del codice sorgente AWS CLI
Fase 3: Creazione del AWS CLI
Fase 4: Installazione di AWS CLI
Fase 5: Verifica dell'installazione AWS CLI
Esempi di flussi di lavoro
Risoluzione degli errori di AWS CLI installazione e disinstallazione
Fasi successive

Perché compilare dall’origine?

AWS CLI È disponibile come programmi di installazione predefiniti per la maggior parte delle piattaforme e degli ambienti, nonché come immagine Docker.

In genere, questi programmi di installazione forniscono la copertura per la maggior parte dei casi d’uso. Le istruzioni per l’installazione dall’origine servono a risolvere i casi d’uso non coperti dai programmi di installazione. Alcuni di questi casi d’uso sono i seguenti:

I programmi di installazione predefiniti non supportano l’ambiente in uso. Ad esempio, ARM a 32 bit non è supportato dai programmi di installazione predefiniti.
I programmi di installazione predefiniti hanno dipendenze che non sono presenti nell’ambiente. Ad esempio, Alpine Linux utilizza musl, ma gli attuali programmi di installazione richiedono glibc, il che impedisce il funzionamento immediato dei programmi di installazione predefiniti.
I programmi di installazione predefiniti richiedono risorse a cui l’ambiente limita l’accesso. Ad esempio, i sistemi con hardening della sicurezza potrebbero non fornire le autorizzazioni per la memoria condivisa. Questo comportamento è necessario per il programma di installazione aws bloccato.
I programmi di installazione predefiniti spesso rappresentano un ostacolo per i manutentori dei gestori di pacchetti, in quanto è preferibile avere il pieno controllo sul processo di compilazione del codice e dei pacchetti. La compilazione dall’origine consente ai manutentori della distribuzione di utilizzare un processo più semplice per mantenere AWS CLI aggiornato. L'abilitazione dei manutentori fornisce ai clienti più up-to-date versioni di AWS CLI quando si installa da un gestore di pacchetti di terze parti come, e. brew yum apt
I clienti che dispongono della AWS CLI funzionalità di patch richiedono la creazione e l'installazione del codice AWS CLI sorgente. Ciò è particolarmente importante per i membri della community che desiderano testare le modifiche apportate al codice sorgente prima di apportare la modifica al AWS CLI GitHub repository.

Passaggi rapidi

Nota

Si presume che tutti gli esempi di codice vengano eseguiti dalla root della directory di origine.

Per creare e installare il file AWS CLI dal codice sorgente, segui i passaggi descritti in questa sezione. AWS CLI utilizza GNU Autotools per l’installazione dall’origine. Nel caso più semplice, AWS CLI può essere installato dal codice sorgente eseguendo i comandi di esempio predefiniti dalla radice del AWS CLI GitHub repository.

Impostare tutti i requisiti per l’ambiente. Ciò include la possibilità di eseguire file generati da GNU Autotools e installare Python 3.8 o versioni successive.
Nel tuo terminale, vai al livello superiore della cartella dei AWS CLI sorgenti ed esegui il ./configure comando. Questo comando verifica la presenza di tutte le dipendenze richieste nel sistema e genera un Makefile per la compilazione e l’installazione di AWS CLI in base alle configurazioni rilevate e specificate.
Linux and macOS
Il seguente esempio di ./configure comando imposta la configurazione di build per l' AWS CLI utilizzo delle impostazioni predefinite.
```
$ ./configure
```
Windows PowerShell
Prima di eseguire qualsiasi chiamata ai comandi MSYS2, è necessario conservare la directory di lavoro corrente:
```
PS C:\> $env:CHERE_INVOKING = 'yes'
```
Quindi usa il seguente esempio di ./configure comando per impostare la configurazione di build per l' AWS CLI utilizzo del percorso locale dell'eseguibile Python, l'installazione in C:\Program Files\ AWSCLI e il download di tutte le dipendenze.
```
PS C:\> C:\msys64\usr\bin\bash  -lc " PYTHON='C:\path\to\python.exe' ./configure --prefix='C:\Program Files\AWSCLI' --with-download-deps "
```
Per i dettagli, le opzioni di configurazione disponibili e le informazioni sulle impostazioni predefinite, consulta la sezione Fase 2: Configurazione dell'installazione del codice sorgente AWS CLI.
Esegui il comando make. Questo comando crea il file in AWS CLI base alle impostazioni di configurazione.

Il seguente comando make di esempio compila con le opzioni predefinite utilizzando le impostazioni ./configure esistenti.
Linux and macOS
```
$ make
```
Windows PowerShell
```
PS C:\> C:\msys64\usr\bin\bash -lc "make" 
```
Per i dettagli e le opzioni di compilazione disponibili, consulta la sezione Fase 3: Creazione del AWS CLI.
Esegui il comando make install. Questo comando installa il build AWS CLI nella posizione configurata del sistema.

Il seguente esempio di make install comando installa il comando build AWS CLI e crea collegamenti simbolici nelle posizioni configurate utilizzando le impostazioni di comando predefinite.
Linux and macOS
```
$ make install
```
Windows PowerShell
```
PS C:\> C:\msys64\usr\bin\bash -lc "make install" 
```
Dopo l'installazione, aggiungi il percorso a AWS CLI utilizzando quanto segue:
```
PS C:\> $Env:PATH +=";C:\Program Files\AWSCLI\bin\"
```
Per i dettagli e le opzioni di installazione disponibili, consulta la sezione Fase 4: Installazione di AWS CLI.
Conferma l'installazione AWS CLI con successo utilizzando il seguente comando:
```
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Windows/10 exe/AMD64 prompt/off
```
Per il passaggi della risoluzione dei problemi di installazione, consulta la sezione Risoluzione degli errori di AWS CLI installazione e disinstallazione.

Passaggio 1: configurare tutti i requisiti

Per compilare il AWS CLI codice sorgente è necessario completare prima quanto segue:

Nota

Si presume che tutti gli esempi di codice vengano eseguiti dalla root della directory di origine.

Scaricate il AWS CLI codice sorgente eseguendo il forking del AWS CLI GitHub repository o scaricando il tarball dei sorgenti. Seguire una delle seguenti istruzioni:

Fork e clona il repository da.AWS CLIGitHub Per maggiori informazioni, consulta Fork a repo nei Documenti. GitHub

Scaricare il tarball di origine più recente da https://awscli.amazonaws.com/awscli.tar.gz ed estrarne il contenuto utilizzando i seguenti comandi:


$ curl "https://awscli.amazonaws.com/awscli.tar.gz" -o "awscli.tar.gz"
$ tar -xzf awscli.tar.gz

Nota

Per scaricare una versione specifica, utilizza il seguente formato di collegamento: /awscli- .tar.gz https://awscli.amazonaws.com versionnumber

Ad esempio, per la versione 2.10.0 il link è il seguente: /awscli- .tar.gz https://awscli.amazonaws.com 2.10.0

Le versioni di origine sono disponibili a partire dalla versione 2.10.0 di AWS CLI.

(Facoltativo) Verificare l’integrità del file zip scaricato completando i seguenti passaggi:

Puoi utilizzare le fasi seguenti per verificare le firme tramite lo strumento GnuPG.

I AWS CLI file del pacchetto di installazione sono firmati crittograficamente utilizzando firme PGP. .zip Se i file sono in qualche modo danneggiati o alterati, questa verifica non va a buon fine e l’installazione deve essere arrestata.
Scarica e installa il comando gpg utilizzando il programma di gestione dei pacchetti. Per ulteriori informazioni su GnuPG, consulta il sito Web GnuPG.

Per creare il file della chiave pubblica, crea un file di testo e incolla il testo seguente.

Per riferimento, di seguito sono riportati i dettagli della chiave pubblica.


Key ID:           A6310ACC4672
Type:             RSA
Size:             4096/4096
Created:          2019-09-18
Expires:          2026-07-07
User ID:          AWS CLI Team <aws-cli@amazon.com>
Key fingerprint:  FB5D B77F D5C1 18B8 0511  ADA8 A631 0ACC 4672 475C

Importa la chiave AWS CLI pubblica con il seguente comando, sostituendola public-key-file-name con il nome del file della chiave pubblica che hai creato.


$ gpg --import public-key-file-name
gpg: /home/username/.gnupg/trustdb.gpg: trustdb created
gpg: key A6310ACC4672475C: public key "AWS CLI Team <aws-cli@amazon.com>" imported
gpg: Total number processed: 1
gpg:               imported: 1

Scarica il file della AWS CLI firma per il pacchetto scaricato all'indirizzo https://awscli.amazonaws.com /awscli.tar.gz.sig. Il percorso e il nome sono identici a quelli del file tarball corrispondente, ma con estensione .sig. Salvare il file nello stesso percorso del file tarball. In alternativa, utilizzare il seguente blocco di comandi:
```
$ curl awscliv2.sig https://awscli.amazonaws.com/ -o awscli.tar.gz.sig
```

Verifica la firma, passando entrambi i nomi file .sig e .zip scaricati come parametri del comando gpg.


$ gpg --verify awscliv2.sig awscli.tar.gz

L’output visualizzato dovrebbe essere simile al seguente:


gpg: Signature made Mon Nov  4 19:00:01 2019 PST
gpg:                using RSA key FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
gpg: Good signature from "AWS CLI Team <aws-cli@amazon.com>" [unknown]
gpg: WARNING: This key is not certified with a trusted signature!
gpg:          There is no indication that the signature belongs to the owner.
Primary key fingerprint: FB5D B77F D5C1 18B8 0511  ADA8 A631 0ACC 4672 475C

Importante

L’avviso nell’output è previsto e non indica un problema. Si verifica perché non esiste una catena di fiducia tra la tua chiave PGP personale (se ne hai una) e la chiave PGP. AWS CLI Per ulteriori informazioni, consulta Web of trust.

Mostra più

Mostra meno

È disponibile un ambiente in grado di eseguire file generati da GNU Autotools come configure e Makefile. Questi file sono ampiamente portabili nelle piattaforme POSIX.
Linux and macOS

Se Autotools non è installato nell’ambiente o è necessario aggiornarlo, seguire le istruzioni di installazione disponibili in How do I install the Autotools (as user)? o Basic Installation nella Documentazione di GNU.

Windows PowerShell
avvertimento
Se si utilizza un ambiente Windows, è consigliabile utilizzare i programmi di installazione predefiniti. Per le istruzioni di installazione dei programmi di installazione predefiniti, consulta Installazione o aggiornamento alla versione più recente di AWS CLI.

Poiché Windows non è dotato di una shell compatibile con POSIX, è necessario installare software aggiuntivo per installare il codice sorgente. AWS CLI MSYS2fornisce una raccolta di strumenti e librerie per aiutare a creare e installare software Windows, in particolare per lo scripting basato su POSIX utilizzato da Autotools.
Installa. MSYS2 Per informazioni sull'installazione e l'uso MSYS2, consulta le istruzioni di installazione e utilizzo nella MSYS2 Documentazione.

Apri il MSYS2 terminale e installa gli autotools usando il seguente comando.

$ pacman -S autotools
Nota
Quando si utilizzano gli esempi di codice di configurazione, compilazione e installazione riportati in questa guida per Windows, si presuppone il percorso di MSYS2 installazione predefinito diC:\msys64\usr\bin\bash. Quando chiami MSYS2 inside of PowerShell utilizzerai il seguente formato, con il comando bash tra virgolette:
PS C:\> C:\msys64\usr\bin\bash -lc "command example"
Il seguente comando di esempio chiama il comando ./configure.
PS C:\> C:\msys64\usr\bin\bash -lc "./configure"
È installato un interprete Python 3.8 o versioni successive. La versione minima di Python richiesta segue le stesse tempistiche della politica di supporto Python ufficiale per and Tools. AWS SDKs Un interprete è supportato solo 6 mesi dopo la sua data. end-of-support
(Facoltativo) Installare tutte le dipendenze della libreria Python di compilazione e runtime di AWS CLI. Il comando ./configure informa l’utente se mancano delle dipendenze e come installarle.

È possibile installare e utilizzare automaticamente queste dipendenze tramite la configurazione, consulta Download delle dipendenze per ulteriori informazioni.

Fase 2: Configurazione dell'installazione del codice sorgente AWS CLI

La configurazione per la creazione e l'installazione di AWS CLI viene specificata utilizzando lo configure script. Per la documentazione di tutte le opzioni di configurazione, eseguire lo script configure con l’opzione --help:

Posizione di installazione

L'installazione sorgente di AWS CLI utilizza due directory configurabili per installare: AWS CLI

libdir- Directory principale in cui AWS CLI verrà installato. Il percorso di AWS CLI installazione è<libdir-value>/aws-cli. Il valore libdir predefinito per Linux e macOS è /usr/local/lib, pertanto la directory di installazione predefinita è /usr/local/lib/aws-cli.
bindir- Directory in cui sono installati AWS CLI gli eseguibili. Il percorso predefinito è /usr/local/bin.

Le seguenti opzioni configure controllano le directory utilizzate:

--prefix: imposta il prefisso di directory da utilizzare per l’installazione. Il valore predefinito per Linux e macOS è /usr/local.
--libdir: imposta la libdir da utilizzare per l’installazione di AWS CLI. Il valore predefinito è <prefix-value>/lib. Se entrambi --libdir e --prefix non sono specificati, l’impostazione predefinita per Linux e macOS è /usr/local/lib/.
--bindir- Imposta bindir da utilizzare per l'installazione di AWS CLI aws ed aws_completer eseguibili. Il valore predefinito è <prefix-value>/bin. Se entrambi bindir e --prefix non sono specificati, l’impostazione predefinita per Linux e macOS è /usr/local/bin/.

Interprete Python

Nota

Si consiglia vivamente di specificare l’interprete Python durante l’installazione per Windows.

Lo ./configure script seleziona automaticamente un interprete Python 3.8 o successivo installato da utilizzare nella creazione e nell'esecuzione AWS CLI della macro using the Autoconf. AM_PATH_PYTHON

L’interprete Python da utilizzare può essere impostato in modo esplicito utilizzando la variabile di ambiente PYTHON durante l’esecuzione dello script configure:

Download delle dipendenze

Per impostazione predefinita, è necessario che tutte le dipendenze di build e runtime di siano già installate nel AWS CLI sistema. Sono incluse le dipendenze della libreria Python. Tutte le dipendenze vengono controllate durante l’esecuzione dello script configure e se nel sistema mancano delle dipendenze Python, lo script configure genera errori.

Il seguente codice di esempio genera errori quando nel sistema mancano le dipendenze:

Linux and macOS


$ ./configure 
checking for a Python interpreter with version >= 3.8... python
checking for python... /Users/username/.envs/env3.11/bin/python
checking for python version... 3.11
checking for python platform... darwin
checking for GNU default python prefix... ${prefix}
checking for GNU default python exec_prefix... ${exec_prefix}
checking for python script directory (pythondir)... ${PYTHON_PREFIX}/lib/python3.11/site-packages
checking for python extension module directory (pyexecdir)... ${PYTHON_EXEC_PREFIX}/lib/python3.11/site-packages
checking for --with-install-type... system-sandbox
checking for --with-download-deps... Traceback (most recent call last):
  File "<frozen runpy>", line 198, in _run_module_as_main
  File "<frozen runpy>", line 88, in _run_code
  File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 125, in <module>
    main()
  File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 121, in main
    parsed_args.func(parsed_args)
  File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 49, in validate
    validate_env(parsed_args.artifact)
  File "/Users/username/aws-code/aws-cli/./backends/build_system/validate_env.py", line 68, in validate_env
    raise UnmetDependenciesException(unmet_deps, in_venv)
validate_env.UnmetDependenciesException: Environment requires following Python dependencies:

awscrt (required: ('>=0.12.4', '<0.17.0')) (version installed: None)

We recommend using --with-download-deps flag to automatically create a virtualenv and download the dependencies.

If you want to manage the dependencies yourself instead, run the following pip command:
/Users/username/.envs/env3.11/bin/python -m pip install --prefer-binary 'awscrt>=0.12.4,<0.17.0'

configure: error: "Python dependencies not met."

Windows PowerShell


PS C:\> C:\msys64\usr\bin\bash -lc "./configure" 
checking for a Python interpreter with version >= 3.8... python
checking for python... /Users/username/.envs/env3.11/bin/python
checking for python version... 3.11
checking for python platform... darwin
checking for GNU default python prefix... ${prefix}
checking for GNU default python exec_prefix... ${exec_prefix}
checking for python script directory (pythondir)... ${PYTHON_PREFIX}/lib/python3.11/site-packages
checking for python extension module directory (pyexecdir)... ${PYTHON_EXEC_PREFIX}/lib/python3.11/site-packages
checking for --with-install-type... system-sandbox
checking for --with-download-deps... Traceback (most recent call last):
  File "<frozen runpy>", line 198, in _run_module_as_main
  File "<frozen runpy>", line 88, in _run_code
  File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 125, in <module>
    main()
  File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 121, in main
    parsed_args.func(parsed_args)
  File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 49, in validate
    validate_env(parsed_args.artifact)
  File "/Users/username/aws-code/aws-cli/./backends/build_system/validate_env.py", line 68, in validate_env
    raise UnmetDependenciesException(unmet_deps, in_venv)
validate_env.UnmetDependenciesException: Environment requires following Python dependencies:

awscrt (required: ('>=0.12.4', '<0.17.0')) (version installed: None)

We recommend using --with-download-deps flag to automatically create a virtualenv and download the dependencies.

If you want to manage the dependencies yourself instead, run the following pip command:
/Users/username/.envs/env3.11/bin/python -m pip install --prefer-binary 'awscrt>=0.12.4,<0.17.0'

configure: error: "Python dependencies not met."

Per installare automaticamente le dipendenze Python richieste, utilizzare l’opzione --with-download-deps. Quando si utilizza questo flag, il processo di compilazione esegue le seguenti operazioni:

Salta il controllo delle dipendenze della libreria Python.
Configura le impostazioni per scaricare tutte le dipendenze Python richieste e utilizzare solo le dipendenze scaricate per compilare AWS CLI durante la compilazione di make.

Il seguente comando configure di esempio utilizza l’opzione --with-download-deps per scaricare e utilizzare le dipendenze Python:

Tipo di installazione

Il processo di installazione dall’origine supporta i seguenti tipi di installazione:

system-sandbox- (Impostazione predefinita) Crea un ambiente virtuale Python isolato, lo installa AWS CLI nell'ambiente virtuale e collega simbolicamente al aws_completer file eseguibile nell'ambiente virtuale. aws Questa installazione di AWS CLI dipende direttamente dall'interprete Python selezionato per il suo runtime.

Questo è un meccanismo di installazione leggero per installarlo su un sistema e segue le migliori pratiche di Python eseguendo il sandboxing dell'installazione in un ambiente virtuale. AWS CLI Questa installazione è destinata ai clienti che desiderano installare il file AWS CLI dal codice sorgente nel modo più semplice possibile con l'installazione abbinata all'installazione di Python.
portable-exe- Lo blocca AWS CLI in un eseguibile autonomo che può essere distribuito in ambienti con architetture simili. Questo è lo stesso processo utilizzato per generare gli eseguibili ufficiali predefiniti di AWS CLI. portable-exe blocca in una copia dell’interprete Python scelto nel passaggio configure da utilizzare per il runtime di AWS CLI. Questo consente di spostarlo su altri computer che potrebbero non avere un interprete Python.

Questo tipo di compilazione è utile perché è possibile assicurarsi che l’installazione di AWS CLI non sia abbinata alla versione di Python installata nell’ambiente e distribuire una compilazione su altri sistemi in cui potrebbe non essere installato Python. Ciò consente di controllare le dipendenze e la sicurezza degli eseguibili utilizzati. AWS CLI

Per configurare il tipo di installazione, utilizzare l’opzione --with-install-type e specificare il valore portable-exe o system-sandbox.

Il seguente comando ./configure di esempio specifica il valore portable-exe:

Fase 3: Creazione del AWS CLI

Usa il make comando per crearlo AWS CLI usando le tue impostazioni di configurazione:

Nota

Quando si utilizza il comando `make`, i seguenti passaggi vengono completati in background:

Un ambiente virtuale viene creato nella directory di compilazione utilizzando il modulo Python venv. L’ambiente virtuale viene avviato con una versione di pip fornita nella libreria standard Python.
Le dipendenze della libreria Python vengono copiate. A seconda se il flag --with-download-deps è stato specificato nel comando configure, questo passaggio esegue una delle seguenti operazioni:
- --with-download-deps è specificato. Le dipendenze Python eseguono l’installazione pip. Sono incluse wheel, setuptools e tutte le dipendenze di runtime AWS CLI . Se si sta compilando portable-exe, viene installato pyinstaller. Questi requisiti sono tutti specificati nei file di blocco generati da pip-compile.
- --with-download-deps non è specificato. Le librerie Python del pacchetto del sito dell’interprete Python più eventuali script (ad esempio pyinstaller) vengono copiati nell’ambiente virtuale utilizzato per la compilazione.
Viene eseguito pip install direttamente sulla AWS CLI codebase per eseguire una compilazione offline e nell'albero e l'installazione di AWS CLI nell'ambiente virtuale di compilazione. Questa installazione utilizza i flag pip --no-build-isolation , in-tree-build --use-feature=, -- e. no-cache-dir --no-index
(Facoltativo) Se --install-type è impostato su portable-exe nel comando configure, viene compilato un eseguibile standalone utilizzando pyinstaller.

Mostra più

Mostra meno

Fase 4: Installazione di AWS CLI

Il make install comando installa il build AWS CLI nella posizione configurata sul sistema.

La regola make install supporta la variabile DESTDIR. Quando è specificata, questa variabile imposta per il percorso specificato il prefisso del percorso di installazione già configurato durante l’installazione di AWS CLI. Per impostazione predefinita, non è impostato alcun valore per questa variabile.

Nota

Durante l’esecuzione di `make install`, i seguenti passaggi vengono completati in background

Sposta uno dei seguenti elementi nella directory di installazione configurata:
- Se il tipo di installazione è system-sandbox, sposta l’ambiente virtuale compilato.
- Se il tipo di installazione è portable-exe, sposta l’eseguibile standalone compilato.
Crea collegamenti simbolici per gli eseguibili aws e aws_completer nella directory bin configurata.

Mostra più

Mostra meno

Fase 5: Verifica dell'installazione AWS CLI

Conferma l' AWS CLI avvenuta installazione utilizzando il seguente comando:


$ aws --version
aws-cli/2.27.41 Python/3.11.6 Windows/10 exe/AMD64 prompt/off

Se il comando aws non viene riconosciuto, potrebbe essere necessario riavviare il terminale per aggiornare i nuovi collegamenti simbolici. Se riscontrate altri problemi dopo l'installazione o la disinstallazione di AWS CLI, consultate le procedure comuni Risoluzione degli errori relativi a AWS CLI per la risoluzione dei problemi

Esempi di flussi di lavoro

Questa sezione fornisce alcuni esempi di flussi di lavoro di base per l’installazione dall’origine.

Installazione di base per Linux e macOS

L'esempio seguente è un flusso di lavoro di installazione di base in cui AWS CLI viene installato nella posizione predefinita di/usr/local/lib/aws-cli.


$ cd path/to/cli/respository/
$ ./configure
$ make
$ make install

Installazione automatizzata per Windows

Nota

È necessario eseguire l'esecuzione PowerShell come amministratore per utilizzare questo flusso di lavoro.

MSYS2 può essere utilizzato in modo automatizzato in un'impostazione CI, vedere Utilizzo MSYS2 in CI nella MSYS2 documentazione.

Downloaded Tarball

Scaricare il file awscli.tar.gz, estrarre e installare AWS CLI. Quando si utilizzano i comandi seguenti, sostituire i percorsi seguenti:

C:\msys64\usr\bin\bashcon la posizione del MSYS2 percorso.
.\awscli-2.x.x\ con il nome della cartella awscli.tar.gz estratta.
PYTHON='C:\path\to\python.exe' con il percorso Python locale.

Il seguente esempio di codice automatizza la creazione e l'installazione di AWS CLI from PowerShell MSYS2 using e specifica quale installazione locale di Python usare:


PS C:\> curl "https://awscli.amazonaws.com/awscli.tar.gz" -o "awscliv2.zip"  #  Download the awscli.tar.gz file in the current working directory
PS C:\> tar -xvzf .\awscli.tar.gz #  Extract awscli.tar.gz file
PS C:\> cd .\awscli-2.x.x\ #  Navigate to the root of the extracted files
PS C:\> $env:CHERE_INVOKING = 'yes' #  Preserve the current working directory
PS C:\> C:\msys64\usr\bin\bash  -lc " PYTHON='C:\path\to\python.exe' ./configure --prefix='C:\Program Files\AWSCLI' --with-download-deps " 
PS C:\> C:\msys64\usr\bin\bash  -lc "make"
PS C:\> C:\msys64\usr\bin\bash  -lc "make install"
PS C:\> $Env:PATH +=";C:\Program Files\AWSCLI\bin\"
PS C:\> aws --version
aws-cli/2.27.41 Python/3.11.6 Windows/10 source-sandbox/AMD64

GitHub Repository

Scaricare il file awscli.tar.gz, estrarre e installare AWS CLI. Quando si utilizzano i comandi seguenti, sostituire i percorsi seguenti:

C:\msys64\usr\bin\bashcon la posizione del percorso. MSYS2
C:path\to\cli\repository\con il percorso del AWS CLI repository clonato da. GitHub Per maggiori informazioni, consulta Fork a repo nei Documenti GitHub
PYTHON='C:\path\to\python.exe' con il percorso Python locale.

Il seguente esempio di codice automatizza la creazione e l'installazione di AWS CLI from PowerShell MSYS2 using e specifica quale installazione locale di Python usare:


PS C:\> cd C:path\to\cli\repository\
PS C:\> $env:CHERE_INVOKING = 'yes' #  Preserve the current working directory
PS C:\> C:\msys64\usr\bin\bash  -lc " PYTHON='C:\path\to\python.exe' ./configure --prefix='C:\Program Files\AWSCLI' --with-download-deps " 
PS C:\> C:\msys64\usr\bin\bash  -lc "make"
PS C:\> C:\msys64\usr\bin\bash  -lc "make install"
PS C:\> $Env:PATH +=";C:\Program Files\AWSCLI\bin\"
PS C:\> aws --version

Container Alpine Linux

Di seguito è riportato un esempio di Dockerfile che può essere utilizzato per ottenere un’installazione funzionante di AWS CLI in un container Alpine Linux come alternativa ai file binari predefiniti per Alpine. Quando usate questo esempio, sostituite AWSCLI_VERSION con il numero di versione desiderato AWS CLI :


FROM python:3.8-alpine AS builder

ENV AWSCLI_VERSION=2.10.1

RUN apk add --no-cache \
    curl \
    make \
    cmake \
    gcc \
    g++ \
    libc-dev \
    libffi-dev \
    openssl-dev \
    && curl https://awscli.amazonaws.com/awscli-${AWSCLI_VERSION}.tar.gz | tar -xz \
    && cd awscli-${AWSCLI_VERSION} \
    && ./configure --prefix=/opt/aws-cli/ --with-download-deps \
    && make \
    && make install

FROM python:3.8-alpine

RUN apk --no-cache add groff

COPY --from=builder /opt/aws-cli/ /opt/aws-cli/

ENTRYPOINT ["/opt/aws-cli/bin/aws"]

Questa immagine viene creata e AWS CLI richiamata da un contenitore simile a quello creato su Amazon Linux 2:


$ docker build --tag awscli-alpine .
$ docker run --rm -it awscli-alpine --version
aws-cli/2.2.1 Python/3.8.11 Linux/5.10.25-linuxkit source-sandbox/x86_64.alpine.3 prompt/off

La dimensione finale di questa immagine è inferiore alla dimensione dell'immagine AWS CLI Docker ufficiale. Per informazioni sull’immagine Docker ufficiale, consulta Esecuzione delle immagini ufficiali di Amazon ECR Public o Docker per AWS CLI.

Risoluzione degli errori di AWS CLI installazione e disinstallazione

Per i passaggi della risoluzione dei problemi di installazione, consulta Risoluzione degli errori relativi a AWS CLI per le procedure più comuni. 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 di AWS CLI.

Per eventuali problemi non descritti nelle guide alla risoluzione dei problemi, cerca i problemi con l'source-distributionetichetta nel AWS CLI Repository su GitHub. Se nessun problema esistente riguarda i tuoi errori, crea un nuovo problema per ricevere assistenza dai AWS CLI manutentori.

Fasi successive

Dopo aver installato il AWS CLI, è necessario eseguire un. Configurazione del AWS CLI

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Rilasci precedenti

Amazon ECR Public/Docker

Compilazione e installazione del file AWS CLI dal codice sorgente

Importante

Argomenti

Perché compilare dall’origine?

Passaggi rapidi

Nota

Passaggio 1: configurare tutti i requisiti

Nota

Nota

Importante

avvertimento

Nota

Fase 2: Configurazione dell'installazione del codice sorgente AWS CLI

Le opzioni più importanti sono:

Posizione di installazione

Interprete Python

Nota

Download delle dipendenze

Tipo di installazione

Fase 3: Creazione del AWS CLI

Nota

Quando si utilizza il comando make, i seguenti passaggi vengono completati in background:

Fase 4: Installazione di AWS CLI

Nota

Durante l’esecuzione di make install, i seguenti passaggi vengono completati in background

Fase 5: Verifica dell'installazione AWS CLI

Esempi di flussi di lavoro

Installazione di base per Linux e macOS

Installazione automatizzata per Windows

Nota

Container Alpine Linux

Risoluzione degli errori di AWS CLI installazione e disinstallazione

Fasi successive

Quando si utilizza il comando `make`, i seguenti passaggi vengono completati in background:

Durante l’esecuzione di `make install`, i seguenti passaggi vengono completati in background