Installa il AWS SAM CLI - AWS Serverless Application Model
Installazione di AWS SAM CLIRisoluzione degli errori di installazionePassaggi successivi

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

Installa il AWS SAM CLI

Installa l'ultima versione di AWS Serverless Application Model Interfaccia a riga di comando (AWS SAM CLI) sui sistemi operativi supportati.

Per informazioni sulla gestione di una versione attualmente installata di AWS SAM CLI, incluso come aggiornare, disinstallare o gestire le nightly build, vedi. Gestione delle AWS SAMCLI versioni

È la prima volta che installi il AWS SAM CLI?

Completa tutti i prerequisiti indicati nella sezione precedente prima di procedere. Questo include:

  1. Iscrizione a un AWS conto.

  2. Creazione di un IAM utente amministrativo.

  3. Creazione di un ID della chiave di accesso e di una chiave di accesso segreta.

  4. Installazione di AWS CLI.

  5. Configurazione AWS credenziali.

Argomenti

Installazione di AWS SAM CLI

Nota

A partire da settembre 2023, AWS non manterrà più il AWS gestiti Homebrew programma di installazione per AWS SAM CLI (aws/tap/aws-sam-cli). Se si utilizza Homebrew per installare e gestire il AWS SAM CLI, vedi le seguenti opzioni:

  • Per continuare a utilizzare Homebrew, puoi utilizzare il programma di installazione gestito dalla community. Per ulteriori informazioni, consulta Gestire il AWS SAMCLI con Homebrew.

  • Si consiglia di utilizzare uno dei metodi di installazione proprietari descritti in questa pagina. Prima di utilizzare uno di questi metodi, consultaPassa da Homebrew.

  • Per ulteriori dettagli, fare riferimento alla versione di rilascio: 1.121.0.

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

x86_64 - command line installer

  1. Download di AWS SAM CLI file.zip in una directory a tua scelta.

  2. (Facoltativo) È possibile verificare l'integrità del programma di installazione prima dell'installazione. Per istruzioni, consulta Facoltativo: verifica l'integrità del AWS SAM CLI Installer (Programma di installazione).

  3. Decomprimi i file di installazione in una directory a tua scelta. Di seguito è riportato un esempio di utilizzo della sam-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 il AWS SAM CLI eseguendo l'installeseguibile. Questo eseguibile si trova nella directory utilizzata nel passaggio precedente. Di seguito è riportato un esempio di utilizzo della sam-installation sottodirectory:

    $ sudo ./sam-installation/install

  5. Verifica l'installazione.

    $ sam --version

    Per confermare l'avvenuta installazione, dovrebbe apparire un output che sostituisce il seguente testo tra parentesi con l'ultima versione disponibile:

     SAM CLI, <latest version>
arm64 - command line installer

  1. Download di AWS SAM CLI file.zip in una directory a tua scelta.

  2. (Facoltativo) È possibile verificare l'integrità del programma di installazione prima dell'installazione. Per istruzioni, consulta Facoltativo: verifica l'integrità del AWS SAM CLI Installer (Programma di installazione).

  3. Decomprimi i file di installazione in una directory a tua scelta. Di seguito è riportato un esempio di utilizzo della sam-installation sottodirectory.

    Nota

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

    $ unzip aws-sam-cli-linux-arm64.zip -d sam-installation

  4. Installa il AWS SAM CLI eseguendo l'installeseguibile. Questo eseguibile si trova nella directory utilizzata nel passaggio precedente. Di seguito è riportato un esempio di utilizzo della sam-installation sottodirectory:

    $ sudo ./sam-installation/install

  5. Verifica l'installazione.

    $ sam --version

    Per confermare l'avvenuta installazione, dovrebbe apparire un output simile al seguente, ma che sostituisca il testo tra parentesi con la versione più recente: SAM CLI

     SAM CLI, <latest version>

Fasi dell'installazione

Utilizzate il programma di installazione del pacchetto per installare AWS SAM CLI. Inoltre, il programma di installazione del pacchetto offre due metodi di installazione tra cui scegliere: GUIe riga di comando. È possibile eseguire l'installazione per tutti gli utenti o solo per l'utente corrente. Per l'installazione per tutti gli utenti, è richiesta l'autorizzazione di superutente.

GUI - All users
Per scaricare il pacchetto di installazione e installare il AWS SAM CLI
Nota

Se in precedenza hai installato il AWS SAM CLI attraverso Homebrew oppure pip, è necessario prima disinstallarlo. Per istruzioni, consulta Disinstallazione di AWS SAMCLI.

  1. Scarica macOS in una directory pkg a tua scelta:

    Nota

    È possibile verificare l'integrità del programma di installazione prima dell'installazione. Per istruzioni, consulta Facoltativo: verifica l'integrità del AWS SAM CLI Installer (Programma di installazione).

  2. Esegui il file scaricato e segui le istruzioni sullo schermo per continuare con i passaggi di Introduzione, Read Me e Licenza.

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

  4. Per Tipo di installazione, scegli dove AWS SAM CLI verrà installato e premi Installa. La posizione predefinita consigliata è/usr/local/aws-sam-cli.

    Nota

    Per richiamare il AWS SAM CLI con il sam comando, il programma di installazione crea automaticamente un collegamento simbolico tra /usr/local/bin/sam e una delle due cartelle /usr/local/aws-sam-cli/sam di installazione scelte.

  5. Il AWS SAM CLI verrà installato e verrà visualizzato il messaggio «Installazione avvenuta con successo». Premere Chiudi.

Per verificare la corretta installazione

  • Verificare che AWS SAM CLI è stato installato correttamente e che il collegamento simbolico sia configurato eseguendo: 

    $ which sam
/usr/local/bin/sam
$ sam --version
SAM CLI, <latest version>
GUI - Current user
Per scaricare e installare AWS SAM CLI
Nota

Se in precedenza hai installato il AWS SAM CLI attraverso Homebrew oppure pip, è necessario prima disinstallarlo. Per istruzioni, consulta Disinstallazione di AWS SAMCLI.

  1. Scarica macOS in una directory pkg a tua scelta:

    Nota

    È possibile verificare l'integrità del programma di installazione prima dell'installazione. Per istruzioni, consulta Facoltativo: verifica l'integrità del AWS SAM CLI Installer (Programma di installazione).

  2. Esegui il file scaricato e segui le istruzioni sullo schermo per continuare con i passaggi di Introduzione, Read Me e Licenza.

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

  4. Per Tipo di installazione, procedi come segue:

    1. Scegli dove AWS SAM CLI verrà installato. Il percorso predefinito è /usr/local/aws-sam-cli. Seleziona una posizione per la quale disponi delle autorizzazioni di scrittura. Per modificare la posizione di installazione, seleziona locale e scegli la tua posizione. Al termine, premi Continua.

    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.

  5. Il AWS SAM CLI verrà installato e verrà visualizzato il messaggio «Installazione avvenuta con successo». Premere Chiudi.

Per creare un collegamento simbolico

  • Per invocare il AWS SAM CLI con il sam comando, è necessario creare manualmente un collegamento simbolico tra AWS SAM CLI programma 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 l'utente dispone dei permessi di scrittura per$PATH, non sudo è necessario. In caso contrario, sudo è richiesto.

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

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

Per verificare la corretta installazione

  • Verificare che AWS SAM CLI è stato installato correttamente e che il collegamento simbolico sia configurato eseguendo: 

    $ which sam
/usr/local/bin/sam
$ sam --version
SAM CLI, <latest version>
Command line - All users
Per scaricare e installare AWS SAM CLI
Nota

Se in precedenza hai installato il AWS SAM CLI attraverso Homebrew oppure pip, è necessario prima disinstallarlo. Per istruzioni, consulta Disinstallazione di AWS SAMCLI.

  1. Scarica macOS in una directory pkg a tua scelta:

    Nota

    È possibile verificare l'integrità del programma di installazione prima dell'installazione. Per istruzioni, consulta Facoltativo: verifica l'integrità del AWS SAM CLI Installer (Programma di installazione).

  2. 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 il AWS SAM CLI con il sam comando, l'installatore crea automaticamente un collegamento simbolico tra e. /usr/local/bin/sam /usr/local/aws-sam-cli/sam

Per verificare la corretta installazione

  • Verificare che AWS SAM CLI è stato installato correttamente e che il collegamento simbolico sia configurato eseguendo: 

    $ which sam
/usr/local/bin/sam
$ sam --version
SAM CLI, <latest version>
Command line - Current user
Per scaricare e installare AWS SAM CLI
Nota

Se in precedenza hai installato il AWS SAM CLI attraverso Homebrew oppure pip, è necessario prima disinstallarlo. Per istruzioni, consulta Disinstallazione di AWS SAMCLI.

  1. Scarica macOS in una directory pkg a tua scelta:

    Nota

    È possibile verificare l'integrità del programma di installazione prima dell'installazione. Per istruzioni, consulta Facoltativo: verifica l'integrità del AWS SAM CLI Installer (Programma di installazione).

  2. Determinate una directory di installazione per la quale disponete dei permessi di scrittura. Quindi, create un xml file utilizzando il modello e modificatelo in modo che rifletta la directory di installazione. La directory deve già esistere.

    Ad esempio, se sostituisci path-to-my-directory con/Users/myUser/Desktop, la cartella del aws-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>

  3. Salva il xml 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 a AWS SAM CLI programma.

  4. Esegui quanto segue per installare AWS 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.
Per creare un collegamento simbolico

  • Per invocare il AWS SAM CLI con il sam comando, è necessario creare manualmente un collegamento simbolico tra AWS SAM CLI programma 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 l'utente dispone dei permessi di scrittura per$PATH, non sudo è necessario. In caso contrario, sudo è richiesto.

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

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

Per verificare la corretta installazione

  • Verificare che AWS SAM CLI è stato installato correttamente e che il collegamento simbolico sia configurato eseguendo: 

    $ which sam
/usr/local/bin/sam
$ sam --version
SAM CLI, <latest version>

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

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

  1. Scarica il AWS SAM CLI 64 bit.

  2. (Facoltativo) È possibile verificare l'integrità del programma di installazione prima dell'installazione. Per istruzioni, consulta Facoltativo: verifica l'integrità del AWS SAM CLI Installer (Programma di installazione).

  3. Verifica l'installazione.

    Dopo aver completato l'installazione, verificatela aprendo un nuovo prompt o PowerShell prompt dei comandi. Dovresti essere in grado di richiamare sam dalla riga di comando.

    sam --version

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

    SAM CLI, <latest version>

  4. Abilita percorsi lunghi (solo Windows 10 e versioni successive).

    Importante

    Il AWS SAM CLI potrebbe interagire con percorsi di file che superano il limite massimo di percorso di Windows. Ciò può causare errori durante l'esecuzione sam init a causa delle MAX_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 di app per Microsoft Windows.

  5. Installa Git.

    Per scaricare applicazioni di esempio utilizzando il sam init comando, è necessario installare anche Git. Per istruzioni, vedi Installazione di Git.

Risoluzione degli errori di installazione

Linux

Errore Docker: «Impossibile connettersi al demone Docker. Il demone docker è in esecuzione su questo host?»

In alcuni casi, per fornire le autorizzazioni per accedere ec2-user al demone Docker, potrebbe essere necessario riavviare l'istanza. Se ricevi questo errore, prova a riavviare l'istanza.

Errore di shell: «comando non trovato»

Se ricevi questo errore, la tua shell non riesce a localizzare il AWS SAM CLI eseguibile nel percorso. Verifica la posizione della directory in cui hai installato il AWS SAM CLI eseguibile, quindi verifica che la directory si trovi sul tuo percorso.

AWS SAM CLI errore: «/lib64/libc.so.6: versione `GLIBC_2.14' non trovata (richiesta da /usr/local/ /dist/libz.so.1)» aws-sam-cli

Se ricevi questo errore, stai utilizzando una versione di Linux non supportata e la versione glibc integrata non è aggiornata. Prova una delle seguenti soluzioni:

  • Aggiorna il tuo host Linux alla versione a 64 bit di una distribuzione recente di CentOS, Fedora, Ubuntu o Amazon Linux 2.

  • Segui le istruzioni per. Installa il AWS SAM CLI

macOS

L'installazione non è riuscita

Immagine del AWS SAM CLI programma di installazione che mostra un messaggio di installazione non riuscita

Se si sta installando il AWS SAM CLI per il tuo utente e hai selezionato una directory di installazione per la quale non disponi dei permessi di scrittura, potrebbe verificarsi questo errore. Prova una delle seguenti soluzioni:

  1. Seleziona una directory di installazione diversa per la quale disponi dei permessi di scrittura.

  2. Eliminare il programma di installazione. Quindi, scaricalo ed eseguilo di nuovo.

Passaggi successivi

Per saperne di più sul AWS SAM CLI e per iniziare a creare applicazioni serverless personalizzate, consulta quanto segue: