Gestione delle AWS SAMCLI versioni

Gestisci le versioni dell'interfaccia a riga di AWS Serverless Application Model comando (AWS SAMCLI) tramite l'aggiornamento, il downgrade e la disinstallazione. Facoltativamente, puoi scaricare e installare la nightly build. AWS SAMCLI

Aggiornamento del AWS SAMCLI

Linux

Per eseguire l'aggiornamento AWS SAMCLI su Linux, segui le istruzioni di installazione riportate inInstallazione di AWS SAM CLI, ma aggiungi l'--updateopzione al comando install, come segue:

sudo ./sam-installation/install --update

macOS

AWS SAMCLIDeve essere aggiornato con lo stesso metodo utilizzato per installarlo. Si consiglia di utilizzare il programma di installazione del pacchetto per installare e aggiornare il. AWS SAMCLI

Per aggiornarlo AWS SAMCLI utilizzando il programma di installazione del pacchetto, installa la versione più recente del pacchetto. Per istruzioni, consulta Installazione di AWS SAM CLI.

Windows

Per aggiornare il AWS SAMCLI, ripeti Installa il AWS SAM CLI nuovamente la procedura di installazione di Windows.

Disinstallazione di AWS SAMCLI

Linux

Per disinstallarlo AWS SAMCLI su Linux, è necessario eliminare il collegamento simbolico e la directory di installazione eseguendo i seguenti comandi:

1. Individuare il collegamento simbolico e i percorsi di installazione.

   • Trovate il collegamento simbolico usando il which comando:

     which sam

     L'output mostra il percorso in cui si trovano i AWS SAM file binari, ad esempio:

      /usr/local/bin/sam

   • Trova la directory a cui punta il collegamento simbolico usando il ls comando:

     ls -l /usr/local/bin/sam

     Nell'esempio seguente, la directory di installazione è/usr/local/aws-sam-cli.

      lrwxrwxrwx 1 ec2-user ec2-user 49 Oct 22 09:49 /usr/local/bin/sam -> /usr/local/aws-sam-cli/current/bin/sam

2. Eliminare il collegamento simbolico.

   sudo rm /usr/local/bin/sam

3. Eliminare la directory di installazione.

   sudo rm -rf /usr/local/aws-sam-cli

macOS

Disinstallalo AWS SAMCLI con lo stesso metodo utilizzato per installarlo. Si consiglia di utilizzare il programma di installazione del pacchetto per installare. AWS SAMCLI

Se hai installato il pacchetto AWS SAMCLI utilizzando il programma di installazione del pacchetto, segui questi passaggi per disinstallarlo.

Per disinstallare il AWS SAMCLI

1. Rimuovere il AWS SAMCLI programma modificando ed eseguendo quanto segue:

   $ sudo rm -rf /path-to/aws-sam-cli

   1. sudo — Se l'utente dispone dei permessi di scrittura sulla posizione in cui è installato il AWS SAMCLI programma, non sudo è necessario. In caso contrario, sudo è richiesto.

   2. /path-to — Percorso in cui è stato installato il programma. AWS SAMCLI Il percorso predefinito è /usr/local.

2. Rimuovi il file AWS SAMCLI $PATH modificando ed eseguendo quanto segue:

   $ sudo rm -rf /path-to-symlink-directory/sam

   1. sudo — Se l'utente dispone dei permessi di scrittura per$PATH, non sudo è necessario. In caso contrario, sudo è richiesto.

   2. path-to-symlink-directory— La tua variabile di $PATH ambiente. Il percorso predefinito è /usr/local/bin.

3. Verificate che AWS SAMCLI sia disinstallato eseguendo quanto segue:

   $ sam --version
   command not found: sam

Windows

Per disinstallarlo AWS SAMCLI utilizzando le impostazioni di Windows, procedi nel seguente modo:

1. Dal menu Start, cerca «Aggiungi o rimuovi programmi».

2. Scegli il risultato denominato AWS SAM Command Line Interface, quindi scegli Disinstalla per avviare il programma di disinstallazione.

3. Conferma di voler disinstallare il. AWS SAMCLI

Passa dall'uso Homebrew alla gestione di AWS SAMCLI

Se si utilizza Homebrew per installare e aggiornare il AWS SAMCLI, si consiglia di utilizzare un metodo AWS supportato. Segui queste istruzioni per passare a un metodo supportato.

Per passare dall'uso Homebrew

1. Segui le istruzioni riportate in Disinstallazione di una CLI Homebrew installata AWS SAM per disinstallare la versione Homebrew gestita.

2. Segui le istruzioni su Installa il AWS SAM CLI per installare la AWS SAM CLI utilizzando un metodo supportato.

Gestire la build AWS SAMCLI notturna

Puoi scaricare e installare la AWS SAMCLI build notturna. Contiene una versione preliminare del AWS SAMCLI codice che potrebbe essere meno stabile della versione di produzione. Una volta installato, è possibile utilizzare il nightly build con il comando. sam-nightly È possibile installare e utilizzare contemporaneamente sia la versione di produzione che quella nightly build AWS SAMCLI di.

Nota

La nightly build non contiene una versione preliminare dell'immagine di build. Per questo motivo, la creazione di un'applicazione serverless con l'--use-containeropzione utilizza l'ultima versione di produzione dell'immagine di build.

Installazione della AWS SAMCLI nightly build

Per installare la AWS SAMCLI nightly build, segui queste istruzioni.

Linux

È possibile installare la versione nightly build di AWS SAMCLI sulla piattaforma Linux x86_64 utilizzando il programma di installazione del pacchetto.

Per installare AWS SAMCLI la nightly build

1. Scarica il programma di installazione del pacchetto dal repository sam-cli-nightly. aws-sam-cli GitHub

2. Segui i passaggi per AWS SAMCLIinstallare il pacchetto nightly build.

macOS

È possibile installare la versione nightly build di AWS SAMCLI onmacOS, utilizzando il programma di installazione del pacchetto nightly build.

Per installare la versione nightly build AWS SAMCLI

1. Scarica il programma di installazione del pacchetto per la tua piattaforma dal repository sam-cli-nightly. aws-sam-cli GitHub

2. Segui i passaggi per AWS SAMCLIinstallare il pacchetto nightly build.

Windows

La versione nightly build di AWS SAMCLI è disponibile con questo link per il download: AWS SAMCLInightly build. Per installare la versione nightly build su Windows, esegui gli stessi passaggi diInstalla il AWS SAM CLI, ma utilizza invece il link per il download di nightly build.

Per verificare di aver installato la versione nightly build, esegui il comando. sam-nightly --version L'output di questo comando è nel formato1.X.Y.dev<YYYYMMDDHHmm>, ad esempio:

SAM CLI, version 1.20.0.dev202103151200

Passa da Homebrew al programma di installazione del pacchetto

Se stai utilizzando Homebrew per installare e aggiornare la AWS SAMCLI nightly build e desideri passare all'utilizzo del programma di installazione del pacchetto, segui questi passaggi.

Per passare dal programma di installazione del Homebrew pacchetto

1. Disinstalla la build AWS SAMCLI nightly Homebrew installata.

   $ brew uninstall aws-sam-cli-nightly

2. Verifica che la AWS SAMCLI nightly build sia disinstallata eseguendo quanto segue:

   $ sam-nightly --version
   zsh: command not found: sam-nightly

3. Segui i passaggi della sezione precedente per installare la nightly build. AWS SAMCLI

Installare il file AWS SAMCLI in un ambiente virtuale utilizzando pip

Si consiglia di utilizzare il programma di installazione nativo del pacchetto per installare. AWS SAMCLI Se è necessario utilizzarlopip, si consiglia di installarlo AWS SAMCLI in un ambiente virtuale. Ciò garantisce un ambiente di installazione pulito e un ambiente isolato in caso di errori.

Nota

A partire dal 24 ottobre 2023, AWS SAM CLI il supporto perPython 3.7. Per ulteriori informazioni, consulta AWS SAM CLI interruzione del supporto per Python 3.7.

Per installarlo AWS SAMCLI in un ambiente virtuale

1. Da una directory iniziale di tua scelta, crea un ambiente virtuale e assegnagli un nome.

   Linux / macOS

   $ mkdir project
   $ cd project
   $ python3 -m venv venv

   Windows

   > mkdir project
   > cd project
   > py -3 -m venv venv

2. Attiva l'ambiente virtuale

   Linux / macOS

   $ . venv/bin/activate

   La richiesta cambia per mostrare che l'ambiente virtuale è attivo.

   (venv) $ 

   Windows

   > venv\Scripts\activate

   Il prompt cambia per mostrare che l'ambiente virtuale è attivo.

   (venv) > 

3. Installalo AWS SAMCLI nel tuo ambiente virtuale.

   (venv) $ pip install --upgrade aws-sam-cli

4. Verifica che AWS SAMCLI sia installato correttamente.

   (venv) $ sam --version
   SAM CLI, version 1.94.0

5. Puoi utilizzare il comando deactivate per chiudere l'ambiente virtuale. Quando avvii una nuova sessione, devi attivare nuovamente l'ambiente.

Gestire il AWS SAMCLI con Homebrew

Nota

A partire da settembre 2023, AWS non manterrà più il programma di Homebrew installazione AWS gestito per AWS SAMCLI ()aws/tap/aws-sam-cli. Per continuare a utilizzareHomebrew, puoi utilizzare il programma di installazione gestito dalla community ()aws-sam-cli. A partire da settembre 2023, qualsiasi Homebrew comando a cui fa riferimento aws/tap/aws-sam-cli verrà reindirizzato a. aws-sam-cli

Ti consigliamo di utilizzare i nostri metodi di installazione e aggiornamento supportati.

Installazione dell' AWS SAMCLIutilizzo Homebrew

Nota

Queste istruzioni utilizzano il programma di AWS SAMCLI Homebrew installazione gestito dalla comunità. Per ulteriore assistenza, consulta il repository homebrew-core.

Per installare il AWS SAMCLI

1. Esegui il seguente codice:

   $ brew install aws-sam-cli

2. Verifica l'installazione:

   $ sam --version

   Dopo la corretta installazione di AWS SAMCLI, si dovrebbe vedere un risultato simile al seguente:

   SAM CLI, version 1.94.0

Aggiornamento dell'utilizzo AWS SAMCLIHomebrew

Per aggiornare l' AWS SAMCLIutilizzoHomebrew, esegui il seguente comando:

$ brew upgrade aws-sam-cli

Disinstallazione di una CLI Homebrew installata AWS SAM

Se AWS SAMCLI è stato installato utilizzandoHomebrew, segui questi passaggi per disinstallarlo.

Per disinstallare il AWS SAMCLI

1. Esegui il seguente codice:

   $ brew uninstall aws-sam-cli

2. Verificare che AWS SAMCLI sia disinstallato eseguendo quanto segue:

   $ sam --version
   command not found: sam

Passaggio al programma di installazione gestito Homebrew dalla community

Se utilizzi il programma di Homebrew installazione AWS gestito (aws/tap/aws-sam-cli) e preferisci continuare a usarloHomebrew, ti consigliamo di passare al programma di Homebrew installazione gestito dalla community ()aws-sam-cli.

Per passare a un solo comando, esegui quanto segue:

$ brew uninstall aws-sam-cli && brew untap aws/tap && brew cleanup aws/tap && brew update && brew install aws-sam-cli

Segui queste istruzioni per eseguire ogni comando singolarmente.

Per passare al programma di Homebrew installazione gestito dalla community

1. Disinstalla la Homebrew versione AWS gestita di AWS SAMCLI:

   $ brew uninstall aws-sam-cli

2. Verifica che sia AWS SAMCLI stato disinstallato:

   $ which sam
   sam not found

3. Rimuovi il AWS SAMCLI rubinetto AWS gestito:

   $ brew untap aws/tap

   Se ricevi un errore come il seguente, aggiungi l'--forceopzione e riprova.

   Error: Refusing to untap aws/tap because it contains the following installed formulae or casks:
   aws-sam-cli-nightly

4. Rimuovi i file memorizzati nella cache per il programma di installazione AWS gestito:

   $ brew cleanup aws/tap

5. Aggiornamento Homebrew e tutte le formule:

   $ brew update

6. Installa la versione gestita dalla community di AWS SAMCLI:

   $ brew install aws-sam-cli

7. Verifica che AWS SAMCLI sia installato correttamente:

   $ sam --version
   SAM CLI, version 1.94.0

Risoluzione dei problemi

Se riscontri errori durante l'installazione o l'utilizzo di AWS SAMCLI, consultaAWS SAMCLIrisoluzione dei problemi.