Gestione delle AWS SAMCLI 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à.

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

Aggiornamento del AWS SAMCLI

Per eseguire l'aggiornamento 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

AWS SAMCLIDeve 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 aggiornarlo 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 SAMCLI, ripeti Installazione del AWS SAMCLI nuovamente la procedura di installazione di Windows.

Disinstallazione di AWS SAMCLI

Per disinstallarlo AWS SAM CLI su Linux, è necessario eliminare il symlink 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

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

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

Per disinstallare il AWS SAMCLI
  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 sulla posizione in cui è installato il AWS SAM CLI programma, non sudo è necessario. In caso contrario, sudo è richiesto.

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

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

    $ sam --version command not found: sam

Per disinstallarlo 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 SAMCommand Line Interface, quindi scegli Disinstalla per avviare il programma di disinstallazione.

  3. Conferma di voler disinstallare il. AWS SAM CLI

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 Installazione del AWS SAMCLI per installare la AWS SAM CLI utilizzando un metodo supportato.

Gestire la build AWS SAMCLI notturna

Puoi scaricare e installare la AWS SAM CLI nightly build. Contiene una versione preliminare del AWS SAM CLI 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 SAM CLI 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 SAM CLI nightly build, segui queste istruzioni.

È possibile installare la versione nightly build di AWS SAM CLI 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.

Puoi installare la versione nightly build di AWS SAM CLI onmacOS, usando 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.

La versione nightly build di AWS SAMCLI è disponibile con questo link per il download: nightly build. AWS SAMCLI Per installare la versione nightly build su Windows, esegui gli stessi passaggi diInstallazione del 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 utilizzando Homebrew per installare e aggiornare la AWS SAM CLI 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 SAM CLI nightly Homebrew installata.

    $ brew uninstall aws-sam-cli-nightly
  2. Verifica che la AWS SAM CLI 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 SAM CLI

Installare il file AWS SAMCLI in un ambiente virtuale utilizzando pip

Si consiglia di utilizzare il programma di installazione del pacchetto nativo per installare. AWS SAM CLI Se è necessario utilizzarlopip, si consiglia di installarlo 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 il supporto perPython 3.7. Per ulteriori informazioni, vedi AWS SAMCLIinterruzione 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 SAM CLI nel tuo ambiente virtuale.

    (venv) $ pip install --upgrade aws-sam-cli
  4. Verifica che AWS SAM CLI 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 SAM CLI (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 SAM CLI 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 SAM CLI è 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 SAM CLI sia disinstallato eseguendo quanto segue:

    $ sam --version command not found: sam

Passaggio al programma di installazione gestito Homebrew dalla community

Se utilizzate il programma di Homebrew installazione AWS gestito (aws/tap/aws-sam-cli) e preferite continuare a utilizzarloHomebrew, vi consigliamo di passare al programma di Homebrew installazione gestito dalla comunità (). 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 SAM CLI stato disinstallato:

    $ which sam sam not found
  3. Rimuovi il AWS SAM CLI 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 SAM CLI sia installato correttamente:

    $ sam --version SAM CLI, version 1.94.0

Risoluzione dei problemi

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