Gestire AWS SAM CLI versioni - AWS Serverless Application Model

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

Gestire AWS SAM CLI versioni

Gestisci la tua interfaccia AWS Serverless Application Model a riga di comando (AWS SAM CLI) versioni tramite aggiornamento, downgrade e disinstallazione. Facoltativamente, è possibile scaricare e installare AWS SAM CLI costruzione notturna.

Aggiornamento del AWS SAM CLI

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

sudo ./sam-installation/install --update

La AWS SAM CLI deve essere aggiornato con lo stesso metodo usato per installarlo. Si consiglia di utilizzare il programma di installazione del pacchetto per installare e aggiornare il AWS SAM CLI.

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

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

Disinstallazione di AWS SAM CLI

Per disinstallare AWS SAM CLI 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

Disinstalla AWS SAM CLI con lo stesso metodo utilizzato per installarlo. Si consiglia di utilizzare il programma di installazione del pacchetto per installare AWS SAM CLI.

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

Per disinstallare AWS SAM CLI
  1. Rimuovere il AWS SAM CLI programma modificando ed eseguendo quanto segue:

    $ sudo rm -rf /path-to/aws-sam-cli
    1. sudo— Se l'utente dispone dei permessi di scrittura su dove AWS SAM CLI il programma è installato, non sudo è richiesto. In caso contrario, sudo è richiesto.

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

  2. Rimuovi il AWS SAM CLI $PATHmodificando 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 SAM CLI viene disinstallato eseguendo quanto segue:

    $ sam --version command not found: sam

Per disinstallare AWS SAM CLI 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 SAM CLI.

Passa dall'uso Homebrew per gestire il AWS SAM CLI

Se si utilizza Homebrew per installare e aggiornare AWS SAM CLI, 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 su Disinstallazione di un HomebrewAWS SAM CLI installata per disinstallare il Homebrew versione gestita.

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

Gestire il AWS SAM CLI costruzione notturna

Puoi scaricare e installare il AWS SAM CLI costruzione notturna. Contiene una versione preliminare di AWS SAM CLI codice che potrebbe essere meno stabile rispetto alla versione di produzione. Una volta installato, puoi usare il nightly build con il sam-nightly comando. È possibile installare e utilizzare sia la versione di produzione che quella di compilazione notturna di AWS SAM CLI allo stesso tempo.

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 di AWS SAM CLI costruzione notturna

Per installare il AWS SAM CLI nightly build, segui queste istruzioni.

È possibile installare la versione nightly build di AWS SAM CLI sul Linux piattaforma x86_64 che utilizza il programma di installazione del pacchetto.

Per installare il AWS SAM CLI costruzione notturna
  1. Scarica il programma di installazione del pacchetto da sam-cli-nightlyaws-sam-cli GitHub repository.

  2. Segui i passaggi per l'installazione di AWS SAM CLIper installare il pacchetto nightly build.

È possibile installare la versione nightly build di AWS SAM CLI on macOS, utilizzando il programma di installazione del pacchetto nightly build.

Per installare il AWS SAM CLI costruzione notturna
  1. Scarica il programma di installazione del pacchetto per la tua piattaforma dal sam-cli-nightlyaws-sam-cli GitHub repository.

  2. Segui i passaggi per l'installazione di AWS SAM CLIper installare il pacchetto nightly build.

La versione nightly build di AWS SAM CLI è disponibile con questo link per il download: AWS SAM CLI costruzione notturna. Per installare nightly build su Windows, esegui gli stessi passaggi diInstalla il AWS SAMCLI, 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 usando Homebrew per installare e aggiornare il AWS SAM CLI nightly build e desideri passare all'utilizzo del programma di installazione del pacchetto, segui questi passaggi.

Per passare da Homebrew al programma di installazione del pacchetto
  1. Disinstalla il Homebrew installato AWS SAM CLI costruzione notturna.

    $ brew uninstall aws-sam-cli-nightly
  2. Verificare che AWS SAM CLI nightly build viene disinstallato eseguendo quanto segue:

    $ sam-nightly --version zsh: command not found: sam-nightly
  3. Segui i passaggi della sezione precedente per installare AWS SAM CLI costruzione notturna.

Installazione di AWS SAM CLI in un ambiente virtuale utilizzando pip

Si consiglia di utilizzare il programma di installazione nativo del pacchetto per installare AWS SAM CLI. Se è necessario utilizzare pip, ti consigliamo di installare il AWS SAM CLI 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 sta interrompendo il supporto per Python 3.7. Per saperne di più, consultaAWS SAM CLI interruzione del supporto per Python 3.7.

Per installare il AWS SAM CLI 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. Installa AWS SAM CLI nel tuo ambiente virtuale.

    (venv) $ pip install --upgrade aws-sam-cli
  4. Verifica che il AWS SAM CLI è 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 SAM CLI con Homebrew

Nota

A partire da settembre 2023, AWS non manterrà più la AWS gestione Homebrew programma di installazione per AWS SAM CLI (aws/tap/aws-sam-cli). Per continuare a utilizzare Homebrew, puoi usare il programma di installazione gestito dalla community (aws-sam-cli). A partire da settembre 2023, qualsiasi Homebrew comando a cui i riferimenti aws/tap/aws-sam-cli verranno reindirizzati. aws-sam-cli

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

Installazione di AWS SAM CLI utilizzo di Homebrew

Nota

Queste istruzioni utilizzano il programma gestito dalla community AWS SAM CLI Homebrew installatore. Per ulteriore assistenza, consulta il repository homebrew-core.

Per installare il AWS SAM CLI
  1. Esegui il seguente codice:

    $ brew install aws-sam-cli
  2. Verifica l'installazione:

    $ sam --version

    Dopo una corretta installazione di AWS SAM CLI, dovresti vedere un risultato simile al seguente:

    SAM CLI, version 1.94.0

Aggiornamento del AWS SAM CLI utilizzo di Homebrew

Per aggiornare il AWS SAM CLI utilizzo di Homebrew, esegui il seguente comando:

$ brew upgrade aws-sam-cli

Disinstallazione di un HomebrewAWS SAM CLI installata

Se AWS SAM CLI è stato installato utilizzando Homebrew, segui questi passaggi per disinstallarlo.

Per disinstallare il AWS SAM CLI
  1. Esegui il seguente codice:

    $ brew uninstall aws-sam-cli
  2. Verificare che AWS SAM CLI viene disinstallato eseguendo quanto segue:

    $ sam --version command not found: sam

Passaggio alla modalità gestita dalla community Homebrew Installer (Programma di installazione)

Se si utilizza il file AWS gestito Homebrew installer (aws/tap/aws-sam-cli) e preferisci continuare a usare Homebrew, ti consigliamo di passare alla versione gestita dalla community Homebrew programma di installazione (aws-sam-cli).

Per passare a un singolo 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 alla versione gestita dalla community Homebrew Installer (Programma di installazione)
  1. Disinstalla il AWS file gestito Homebrew versione di AWS SAM CLI:

    $ brew uninstall aws-sam-cli
  2. Verificare che AWS SAM CLI è stato disinstallato:

    $ which sam sam not found
  3. Rimuovi il file gestito AWS AWS SAM CLI toccare:

    $ 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 SAM CLI:

    $ brew install aws-sam-cli
  7. Verificare che AWS SAM CLI è stato installato con successo:

    $ sam --version SAM CLI, version 1.94.0

Risoluzione dei problemi

Se si verificano errori durante l'installazione o l'utilizzo di AWS SAM CLI, consulta AWS SAM CLI risoluzione dei problemi.