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

Guida alla migrazione per la AWS CLI versione 2

Questa sezione contiene le istruzioni per aggiornare la AWS CLI versione 1 alla AWS CLI versione 2. La AWS CLI versione 2 si basa sulla AWS CLI versione 1 e include funzionalità e miglioramenti basati sul feedback della community. La AWS CLI versione 2 è la versione principale più recente di AWS CLI e supporta tutte le funzionalità più recenti. Alcune funzionalità introdotte nella versione 2 non sono compatibili con la versione 1 ed è necessario eseguire l’aggiornamento per accedere a tali funzionalità.

Per evitare problemi imprevisti, prima di migrare alla versione 2, scopri le differenze tra le versioni. La AWS CLI versione 2 include nuove funzionalità e modifiche che potrebbero richiedere l'aggiornamento degli script o dei comandi per garantire la compatibilità con le versioni precedenti.

AWS CLI le versioni 1 e 2 utilizzano lo stesso nome di aws comando. Se sono state installate entrambe le versioni, il computer utilizza la prima trovata nel percorso di ricerca. Ciò potrebbe far sì che il nome del aws comando richiami la vecchia AWS CLI versione, anche quando è installata quella nuova.

Per eseguire l'aggiornamento alla AWS CLI versione 2, segui una delle seguenti istruzioni:

Utilizzo degli strumenti di migrazione AWS CLI per mitigare le interruzioni

Esistono cambiamenti nel comportamento tra la versione AWS CLI 1 e la AWS CLI versione 2 che potrebbero richiedere l'aggiornamento degli script o dei comandi. L'aggiornamento alla versione AWS CLI 2 senza verificare che gli script esistenti siano migrati in modo sicuro rischia di riscontrare effetti imprevisti durante l'esecuzione degli script con AWS CLI versione 2, come apportare modifiche involontarie alle risorse degli account. AWS

Esistono due strumenti di proprietà che è possibile utilizzare per guidare la AWS migrazione. Indipendentemente dallo strumento utilizzato, si consiglia di fare riferimento Interruzione delle modifiche tra AWS CLI la versione 1 e la AWS CLI versione 2 alla Nuove funzionalità e modifiche nella AWS CLI versione 2 guida.

Aggiorna la modalità di debug

La modalità di debug dell'aggiornamento è una funzionalità della AWS CLI versione 1 disponibile nelle 1.44.0 versioni e successive. Quando questa funzionalità è abilitata, ogni comando AWS CLI eseguito viene controllato per determinare se è probabile che abbia un comportamento diverso nella versione AWS CLI 2, supponendo che l'ambiente di esecuzione rimanga lo stesso. Se un comando eseguito ha un comportamento diverso nella versione AWS CLI 2, verrà visualizzato un avviso accanto all'output del comando con le azioni suggerite che possono essere intraprese per preservare il comportamento della versione 1 della AWS CLI nella versione AWS CLI 2.

Il motivo principale per cui si utilizza la modalità di debug di aggiornamento per guidare la migrazione è che offre un'elevata copertura per rilevare se i comandi subiranno un cambiamento di comportamento. 14 delle 15 modifiche principali descritte in Interruzione delle modifiche tra AWS CLI la versione 1 e la AWS CLI versione 2 possono essere rilevate con la modalità di debug di aggiornamento. Utilizzo della modalità di aggiornamento di debug per aggiornare la versione AWS CLI 1 alla versione AWS CLI 2 Per i limiti di questa funzionalità, consulta Limitazioni la sezione dedicata. D'altra parte, lo svantaggio principale dell'utilizzo della modalità di debug di aggiornamento è che il suo output è rilevante solo all'interno del suo ambiente di esecuzione; se le impostazioni di configurazione della AWS CLI cambiano nell'ambiente dopo la migrazione alla versione AWS CLI 2, potrebbero comunque verificarsi modifiche sostanziali e dovresti verificare nuovamente utilizzando la modalità di debug di aggiornamento nell'ambiente aggiornato.

AWS Strumento di migrazione CLI da v1 a v2

Lo strumento di migrazione AWS CLI v1-to-v2 è uno strumento autonomo che può essere utilizzato con Python 3.9 e versioni successive. Questo strumento è un linter statico che funziona indipendentemente dalla AWS CLI. Elenca gli script di bash contenenti comandi della versione 1 della AWS CLI che possono avere un comportamento diverso nella versione CLI 2. AWS Per la maggior parte dei comandi che rileva come suscettibili di avere un comportamento diverso nella versione AWS CLI 2, può aggiornare automaticamente il comando all'interno dello script per preservare il comportamento della AWS CLI versione 1 nella AWS versione CLI 2.

Il motivo principale per utilizzare lo strumento di migrazione da AWS CLI v1 a v2 per guidare la migrazione è che può aggiornare automaticamente gli script per preservare il comportamento della CLI versione 1 nella versione AWS CLI 2, risparmiando tempo e AWS fatica nell'effettuare gli aggiornamenti da soli. D'altra parte, lo svantaggio principale dell'utilizzo dello strumento di migrazione è che offre una copertura inferiore per rilevare se i comandi subiranno un cambiamento di comportamento. Essendo uno strumento statico, non verifica le modifiche di comportamento determinate in fase di esecuzione.

Scelta tra la modalità di debug dell'aggiornamento e AWS lo strumento di migrazione CLI da v1 a v2

La tabella seguente evidenzia le principali differenze tra la modalità di debug dell'aggiornamento e lo strumento di migrazione AWS CLI da v1 a v2 e può essere utilizzata per aiutarti a scegliere lo strumento giusto per il tuo caso d'uso.

La tabella seguente mostra quali Interruzione delle modifiche tra AWS CLI la versione 1 e la AWS CLI versione 2 sono supportati in ciascuno dei due strumenti di migrazione.

Argomenti aggiuntivi in questa sezione