Installazione dell'interfaccia a riga di comando AWS SAM - 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à.

Installazione dell'interfaccia a riga di comando AWS SAM

Installa l'ultima versione diAWS Serverless Application Model Command Line Interface (AWS SAMCLI) sui sistemi operativi supportati.

Per informazioni su come gestire una versione dellaAWS SAM CLI attualmente installata, incluso come aggiornare, disinstallare o gestire le build notturne, vedereGestione delle versioniAWS SAM CLI.

Importante

Prima di continuare, completa tutti i prerequisiti nella sezione precedente.

Installazione dell'interfaccia a riga di comando AWS SAM

Per installare laAWS SAM CLI, segui le istruzioni relative al tuo sistema operativo.

x86_64 - command line installer
  1. Scarica il fileAWS SAM CLI .zip in una directory a tua scelta.

  2. Verifica l'integrità e l'autenticità dei file di installazione scaricati generando un valore hash utilizzando il seguente comando:

    sha256sum aws-sam-cli-linux-x86_64.zip

    L'output dovrebbe essere simile al seguente esempio:

     <64-character SHA256 hash value> aws-sam-cli-linux-x86_64.zip

    Confronta il valore hash SHA-256 a 64 caratteri con quello per la versioneAWS SAM CLI desiderata nelle note sulla releaseAWS SAM CLI su GitHub.

  3. Decomprimi i file di installazione nellasam-installation/ sottodirectory.

    Nota

    Se il sistema operativo non dispone del comando unzip integrato, utilizzare un comando equivalente.

    unzip aws-sam-cli-linux-x86_64.zip -d sam-installation
  4. Installa la CLI di AWS SAM.

    sudo ./sam-installation/install
  5. Verifica l'installazione.

    sam --version

    In caso di installazione con successo, dovresti visualizzare l'output simile al seguente:

     SAM CLI, version 1.58.0
ARM - command line installer
  1. Utilizzalopip per installare laAWS SAM CLI.

    pip install aws-sam-cli
  2. Verifica l'installazione.

    sam --version

    In caso di installazione con successo, dovresti visualizzare l'output simile al seguente:

     SAM CLI, version 1.58.0
Homebrew
Importante

Devi averloHomebrew installato sulla tua macchina Linux. Per l'installazioneinstructions, vedereInstallazioneHomebrew da utilizzare con laAWS SAM CLI.

Per installare laAWS SAM CLI utilizzandoHomebrew, esegui i seguenti comandi:

brew tap aws/tap brew install aws-sam-cli

Verifica l'installazione.

sam --version

Una volta completata con successo l'installazione dellaAWS SAM CLI, dovresti visualizzare l'output simile al seguente:

SAM CLI, version 1.58.0

Installa laAWS SAM CLI utilizzando il relativo programma di installazione dei pacchetti o tramiteHomebrew.

Usare l'installer di pacchetti

Il programma di installazione del pacchetto dispone di due metodi di installazione tra cui scegliere:

  1. GUI

  2. Riga di comando

Puoi eseguire l'installazione per tutti gli utenti o solo per il tuo attuale utente. Per l'installazione per tutti gli utenti, è richiesta l'autorizzazione dell'utente root.

Fasi di installazione

Installare laAWS SAM CLI con una delle seguenti opzioni.

GUI - All users
Scarica il programma di installazione del pacchetto
Nota

Se in precedenza hai installato laAWS SAM CLI tramiteHomebrew opip, devi prima disinstallarla. Per istruzioni, consulta Disinstallazione dellaAWS SAM CLI.

  1. Per iniziare l'installazione, scarica macOSpkg in una directory a tua scelta:

  2. Verifica l'integrità e l'autenticità del programma di installazione scaricato generando un valore hash utilizzando il seguente comando:

    $ shasum -a 256 path-to-pkg-installer/name-of-pkg-installer # Examples $ shasum -a 256 /Users/myUser/Downloads/aws-sam-cli-macos-arm64.pkg $ shasum -a 256 /Users/myUser/Downloads/aws-sam-cli-macos-x86_64.pkg

    Confronta il tuo valore hash SHA-256 a 64 caratteri con il valore corrispondente nelGitHub repository delle note di rilascio dellaAWS SAM CLI.

Installare laAWS SAM CLI
  1. Esegui il file scaricato e segui le istruzioni sullo schermo per continuare con i passaggi Introduzione, Leggimi e Licenza.

  2. Per Destination Select, seleziona Installa per tutti gli utenti di questo computer.

  3. Per il tipo di installazione, scegli dove installare laAWS SAM CLI e premi Installa. La posizione predefinita consigliata è/usr/local/aws-sam-cli.

    Nota

    Per richiamare laAWS SAM CLI con ilsam comando, il programma di installazione crea automaticamente un collegamento simbolico tra/usr/local/bin/sam l'una/usr/local/aws-sam-cli/sam o l'altra cartella di installazione scelta.

  4. LaAWS SAM CLI verrà installata e verrà visualizzato il messaggio L'installazione è andata a buon fine. Premi Chiudi.

Verifica l'installazione
  • Verifica che laAWS SAM CLI sia installata correttamente e che il tuo collegamento simbolico sia configurato eseguendo:

    $ which sam /usr/local/bin/sam $ sam --version SAM CLI, version 1.66.0
GUI - Current user
Scarica il programma di installazione del pacchetto
Nota

Se in precedenza hai installato laAWS SAM CLI tramiteHomebrew opip, devi prima disinstallarla. Per istruzioni, consulta Disinstallazione dellaAWS SAM CLI.

  1. Per iniziare l'installazione, scarica macOSpkg in una directory a tua scelta:

  2. Verifica l'integrità e l'autenticità del programma di installazione scaricato generando un valore hash utilizzando il seguente comando:

    $ shasum -a 256 path-to-pkg-installer/name-of-pkg-installer # Examples $ shasum -a 256 /Users/myUser/Downloads/aws-sam-cli-macos-arm64.pkg $ shasum -a 256 /Users/myUser/Downloads/aws-sam-cli-macos-x86_64.pkg

    Confronta il tuo valore hash SHA-256 a 64 caratteri con il valore corrispondente nelGitHub repository delle note di rilascio dellaAWS SAM CLI.

Installare laAWS SAM CLI
  1. Esegui il file scaricato e segui le istruzioni sullo schermo per continuare con i passaggi Introduzione, Leggimi e Licenza.

  2. Per Destination Select, seleziona Installa solo per me. Se non vedi questa opzione, vai al passaggio successivo.

  3. Per il tipo di installazione, segui la procedura riportata di seguito:

    1. Scegli dove installare laAWS SAM CLI. Il percorso predefinito è /usr/local/aws-sam-cli. Seleziona una località per la quale disponi delle autorizzazioni di scrittura. Per modificare la posizione di installazione, seleziona locale e scegli la tua posizione. Premi Continua quando hai finito.

    2. Se non hai avuto la possibilità di scegliere Installa solo per me nel passaggio precedente, seleziona Cambia posizione di installazione > Installa solo per me e premi Continua.

    3. Premi Installa.

  4. LaAWS SAM CLI verrà installata e verrà visualizzato il messaggio L'installazione è andata a buon fine. Premi Chiudi.

Crea un collegamento simbolico
  • Per richiamare laAWS SAM CLI con ilsam comando, devi creare manualmente un collegamento simbolico tra il programmaAWS SAM CLI e il tuo$PATH. Crea il tuo link simbolico modificando ed eseguendo il seguente comando:

    $ sudo ln -s /path-to/aws-sam-cli/sam /path-to-symlink-directory/sam
    • sudo: se il tuo utente ha i permessi di scrittura per$PATH, nonsudo è richiesto. In caso contrario, sudo è richiesto.

    • path-to — Percorso in cui è stato installato il programmaAWS SAM CLI. Ad esempio, /Users/myUser/Desktop.

    • path-to-symlink-directory— La tua variabile d'$PATHambiente. Il percorso predefinito è /usr/local/bin.

Verifica l'installazione
  • Verifica che laAWS SAM CLI sia installata correttamente e che il tuo collegamento simbolico sia configurato eseguendo:

    $ which sam /usr/local/bin/sam $ sam --version SAM CLI, version 1.66.0
Command line - All users
Scarica il programma di installazione del pacchetto
Nota

Se in precedenza hai installato laAWS SAM CLI tramiteHomebrew opip, devi prima disinstallarla. Per istruzioni, consulta Disinstallazione dellaAWS SAM CLI.

  1. Per iniziare l'installazione, scarica macOSpkg in una directory a tua scelta:

  2. Verifica l'integrità e l'autenticità del programma di installazione scaricato generando un valore hash utilizzando il seguente comando:

    $ shasum -a 256 path-to-pkg-installer/name-of-pkg-installer # Examples $ shasum -a 256 /Users/myUser/Downloads/aws-sam-cli-macos-arm64.pkg $ shasum -a 256 /Users/myUser/Downloads/aws-sam-cli-macos-x86_64.pkg

    Confronta il tuo valore hash SHA-256 a 64 caratteri con il valore corrispondente nelGitHub repository delle note di rilascio dellaAWS SAM CLI.

Installare laAWS SAM CLI
  • Modifica ed esegui lo script di installazione:

    $ sudo installer -pkg path-to-pkg-installer/name-of-pkg-installer -target / installer: Package name is AWS SAM CLI installer: Upgrading at base path / installer: The upgrade was successful.
    Nota

    Per richiamare laAWS SAM CLI con ilsam comando, l'installatore crea automaticamente un collegamento simbolico tra/usr/local/bin/sam e/usr/local/aws-sam-cli/sam.

Verifica l'installazione
  • Verifica che laAWS SAM CLI sia installata correttamente e che il tuo collegamento simbolico sia configurato eseguendo:

    $ which sam /usr/local/bin/sam $ sam --version SAM CLI, version 1.66.0
Command line - Current user
Scarica il programma di installazione del pacchetto
Nota

Se in precedenza hai installato laAWS SAM CLI tramiteHomebrew opip, devi prima disinstallarla. Per istruzioni, consulta Disinstallazione dellaAWS SAM CLI.

  1. Per iniziare l'installazione, scarica macOSpkg in una directory a tua scelta:

  2. Verifica l'integrità e l'autenticità del programma di installazione scaricato generando un valore hash utilizzando il seguente comando:

    $ shasum -a 256 path-to-pkg-installer/name-of-pkg-installer # Examples $ shasum -a 256 /Users/myUser/Downloads/aws-sam-cli-macos-arm64.pkg $ shasum -a 256 /Users/myUser/Downloads/aws-sam-cli-macos-x86_64.pkg

    Confronta il tuo valore hash SHA-256 a 64 caratteri con il valore corrispondente nelGitHub repository delle note di rilascio dellaAWS SAM CLI.

Installare laAWS SAM CLI
  1. Determina una directory di installazione in cui disponi delle autorizzazioni di scrittura. Quindi, create unxml file utilizzando il modello e modificatelo in modo che rifletta la directory di installazione. L'elenco deve esistere già.

    Ad esempio, se si sostituisce path-to-my-directorycon/Users/myUser/Desktop, la cartella delaws-sam-cli programma verrà installata lì.

    <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <array> <dict> <key>choiceAttribute</key> <string>customLocation</string> <key>attributeSetting</key> <string>path-to-my-directory</string> <key>choiceIdentifier</key> <string>default</string> </dict> </array> </plist>
  2. Salva ilxml file e verifica che sia valido eseguendo quanto segue:

    $ installer -pkg path-to-pkg-installer \ -target CurrentUserHomeDirectory \ -showChoicesAfterApplyingChangesXML path-to-your-xml-file

    L'output dovrebbe mostrare le preferenze che verranno applicate al programmaAWS SAM CLI.

  3. Esegui la procedura riportata di seguito per installare laAWS SAM CLI:

    $ installer -pkg path-to-pkg-installer \ -target CurrentUserHomeDirectory \ -applyChoiceChangesXML path-to-your-xml-file # Example output installer: Package name is AWS SAM CLI installer: choices changes file 'path-to-your-xml-file' applied installer: Upgrading at base path base-path-of-xml-file installer: The upgrade was successful.
Crea un collegamento simbolico
  • Per richiamare laAWS SAM CLI con ilsam comando, devi creare manualmente un collegamento simbolico tra il programmaAWS SAM CLI e il tuo$PATH. Crea il tuo link simbolico modificando ed eseguendo il seguente comando:

    $ sudo ln -s /path-to/aws-sam-cli/sam /path-to-symlink-directory/sam
    • sudo: se il tuo utente ha i permessi di scrittura per$PATH, nonsudo è richiesto. In caso contrario, sudo è richiesto.

    • path-to — Percorso in cui è stato installato il programmaAWS SAM CLI. Ad esempio, /Users/myUser/Desktop.

    • path-to-symlink-directory— La tua variabile d'$PATHambiente. Il percorso predefinito è /usr/local/bin.

Verifica l'installazione
  • Verifica che laAWS SAM CLI sia installata correttamente e che il tuo collegamento simbolico sia configurato eseguendo:

    $ which sam /usr/local/bin/sam $ sam --version SAM CLI, version 1.66.0
Homebrew
Importante

Devi averloHomebrew installato sul tuo computer. Per le istruzioni di installazione, vedereInstallazioneHomebrew da utilizzare con laAWS SAM CLI.

Segui questi passaggi per installare laAWS SAM CLI utilizzandoHomebrew:

brew tap aws/tap brew install aws-sam-cli

Verifica l'installazione:

sam --version

Dopo aver installato con successo laAWS SAM CLI, dovresti visualizzare l'output simile al seguente:

SAM CLI, version 1.58.0

I file Windows Installer (MSI) sono i file di installazione dei pacchetti per il sistema operativo Windows.

Segui questi passaggi per installare laAWS SAM CLI utilizzando il file MSI.

  1. Installa laAWS SAM CLI a 64 bit.

    Nota

    Se si utilizza una versione a 32 bit di Windows, vedereInstallazione dellaAWS SAM CLI su Windows a 32 bit.

  2. Verifica l'installazione.

    Dopo aver completato l'installazione, verificala aprendo un nuovo prompt o PowerShell prompt dei comandi. L'invocazione dovrebbe essere possibilesam dalla riga di comando.

    sam --version

    Dopo aver installato con successo laAWS SAM CLI, dovresti visualizzare l'output simile al seguente:

    SAM CLI, version 1.58.0
  3. Abilita percorsi lunghi (solo Windows 10 e versioni successive).

    Importante

    Il repository dei modelli di appAWS SAM CLI contiene alcuni percorsi di file lunghi che possono causare errori durante l'esecuzione asam init causa delleMAX_PATH limitazioni di Windows 10. Per risolvere questo problema, è necessario configurare il nuovo comportamento dei percorsi lunghi.

    Per abilitare percorsi lunghi, vedi Abilitare percorsi lunghi in Windows 10, versione 1607 e successive nella documentazione sullo sviluppo delle app di Microsoft Windows.

  4. Installa Git.

    Per scaricare applicazioni di esempio utilizzando ilsam init comando, è necessario installare anche Git. Per istruzioni, consulta Installazione di Git.

Risoluzione dei problemi

Se riscontri problemi durante l'installazione dellaAWS SAM CLI, vediRisoluzione degli errori di installazione.

Fasi successive

Per ulteriori informazioni sull'interfaccia aAWS SAM riga di comando e per iniziare a compilare le proprie applicazioni serless, consulta la procedura riportata di seguito: