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 seguendo le istruzioni in Fase 1: Installare AWS CLI.
Per informazioni sulla gestione di una versione attualmente installata di AWS SAM CLI, incluso come aggiornare, disinstallare o gestire le build notturne, vedi Gestione delle AWS SAMCLI versioni.
È la prima volta che installi AWS SAM CLI?
Completa tutto prerequisiti nella sezione precedente prima di andare avanti. Questo include:
-
Iscriversi a un AWS account.
-
Configurazione dell'accesso sicuro a AWS.
-
Installazione di AWS CLI.
-
Configurazione AWS credenziali.
Installazione di AWS SAM CLI
A partire da settembre 2023, AWS non manterrà più il AWS gestite Homebrew installatore per AWS SAM CLI (aws/tap/aws-sam-cli). Se usi Homebrew per installare e gestire AWS SAM CLI, vedi le seguenti opzioni:
-
Per continuare a usare 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 documentati in questa pagina. Prima di utilizzare uno di questi metodi, vedere Passa da Homebrew.
-
Per ulteriori dettagli, fare riferimento a Versione di rilascio: 1.121.0.
Per installare AWS SAM CLI, segui le istruzioni per il tuo sistema operativo.
- x86_64 - command line installer
-
-
Scarica il AWS SAM CLI file.zip in una cartella a tua scelta.
-
(Opzionale) È possibile verificare l'integrità del programma di installazione prima dell'installazione. Per istruzioni, consulta l’argomento Facoltativo: verifica l'integrità del AWS SAM CLI Installer (Programma di installazione).
-
Decomprimi i file di installazione in una directory a tua scelta. Di seguito è riportato un esempio di utilizzo di sam-installation sottodirectory.
Se il sistema operativo non dispone del comando unzip integrato, utilizza un comando equivalente.
$ unzip aws-sam-cli-linux-x86_64.zip -d sam-installation
-
Installa il AWS SAM CLI eseguendo il install eseguibile. Questo eseguibile si trova nella directory utilizzata nel passaggio precedente. Di seguito è riportato un esempio di utilizzo di sam-installation sottodirectory:
$ sudo ./sam-installation/install
-
Verifica l'installazione.
$ sam --version
Per confermare la corretta installazione, dovresti vedere un output che sostituisce il seguente testo tra parentesi con l'ultima versione disponibile:
SAM CLI, <latest version>
- arm64 - command line installer
-
-
Scaricate il AWS SAM CLI file.zip in una cartella a tua scelta.
-
(Opzionale) È possibile verificare l'integrità del programma di installazione prima dell'installazione. Per istruzioni, consulta l’argomento Facoltativo: verifica l'integrità del AWS SAM CLI Installer (Programma di installazione).
-
Decomprimi i file di installazione in una directory a tua scelta. Di seguito è riportato un esempio di utilizzo di sam-installation sottodirectory.
Se il sistema operativo non dispone del comando unzip integrato, utilizza un comando equivalente.
$ unzip aws-sam-cli-linux-arm64.zip -d sam-installation
-
Installa il AWS SAM CLI eseguendo il install eseguibile. Questo eseguibile si trova nella directory utilizzata nel passaggio precedente. Di seguito è riportato un esempio di utilizzo di sam-installation sottodirectory:
$ sudo ./sam-installation/install
-
Verifica l'installazione.
$ sam --version
Per confermare la corretta installazione, dovresti vedere un output come il seguente, ma che sostituisce il testo tra parentesi con l'ultima versione di SAM CLI:
SAM CLI, <latest version>
Fasi dell'installazione
Usa 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: GUI e riga di comando. È possibile installare per tutti gli utenti o solo il tuo utente corrente. Per l'installazione per tutti gli utenti, è richiesta l'autorizzazione del superutente.
AWS SAM La CLI non supporta versioni di macOS precedenti a macOS 13.x. Esegui l'upgrade a una versione supportata di macOS o installa AWS SAM CLI con Homebrew.
- GUI - All users
-
Per scaricare il programma di installazione del pacchetto e installare AWS SAM CLI
Se in precedenza è stato installato AWS SAM CLI attraverso Homebrew o pip, devi prima disinstallarlo. Per istruzioni, consulta l’argomento Disinstallazione di AWS SAMCLI.
-
Scarica macOS pkg in una cartella a tua scelta:
-
Esegui il file scaricato e segui le istruzioni sullo schermo per continuare Introduzione, Leggimi, e Licenza passaggi.
-
Per Seleziona destinazione, seleziona Installa per tutti gli utenti di questo computer.
-
Per Tipo di installazione, scegli dove AWS SAM CLI verrà installato e premere Installa. La posizione predefinita consigliata è /usr/local/aws-sam-cli.
Per invocare il AWS SAM CLI con il sam comando, il programma di installazione crea automaticamente un collegamento simbolico tra /usr/local/bin/sam e uno dei due /usr/local/aws-sam-cli/sam o la cartella di installazione che hai scelto.
-
La AWS SAM CLI installerà e L'installazione è avvenuta con successo verrà visualizzato il messaggio. Premere Chiudi.
Per verificare una corretta installazione
-
Verificare che il AWS SAM CLI è installato correttamente e il collegamento simbolico è configurato eseguendo:
$ which sam
/usr/local/bin/sam
$ sam --version
SAM CLI, <latest version>
- GUI - Current user
-
Per scaricare e installare AWS SAM CLI
Se in precedenza hai installato AWS SAM CLI attraverso Homebrew o pip, devi prima disinstallarlo. Per istruzioni, consulta l’argomento Disinstallazione di AWS SAMCLI.
-
Scarica macOS pkg in una cartella a tua scelta:
-
Esegui il file scaricato e segui le istruzioni sullo schermo per continuare Introduzione, Leggimi, e Licenza passaggi.
-
Per Seleziona destinazione, seleziona Installa solo per me. Se non vedi questa opzione, vai al passaggio successivo.
-
Per Tipo di installazione, procedi come segue:
-
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 il percorso di installazione, seleziona locale e scegli la tua posizione. Premere Continua quando è finito.
-
Se non hai avuto la possibilità di scegliere Installa solo per me nel passaggio precedente, seleziona Cambia la posizione di installazione > Installa solo per me e premi Continua.
-
Premere Installare.
-
Il AWS SAM CLI installerà e L'installazione è avvenuta con successo verrà visualizzato il messaggio. 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 collegamento 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, sudo non è richiesto. In caso contrario, sudo è richiesto.
-
path-to — Percorso in cui è stato installato AWS SAM CLI programma. Ad esempio, /Users/myUser/Desktop.
-
path-to-symlink-directory — Il tuo $PATH variabile d'ambiente. Il percorso predefinito è /usr/local/bin.
Per verificare una corretta installazione
-
Verificare che il AWS SAM CLI è installato correttamente e il collegamento simbolico è 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
Se in precedenza hai installato AWS SAM CLI attraverso Homebrew o pip, devi prima disinstallarlo. Per istruzioni, consulta l’argomento Disinstallazione di AWS SAMCLI.
-
Scarica macOS pkg in una cartella a tua scelta:
-
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.
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 /usr/local/aws-sam-cli/sam.
Per verificare una corretta installazione
-
Verificare che il AWS SAM CLI è installato correttamente e il collegamento simbolico è 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
Se in precedenza hai installato AWS SAM CLI attraverso Homebrew o pip, devi prima disinstallarlo. Per istruzioni, consulta l’argomento Disinstallazione di AWS SAMCLI.
-
Scarica macOS pkg in una cartella a tua scelta:
-
Determina una directory di installazione in cui disponi delle autorizzazioni di scrittura. Quindi, crea un xml utilizzando il modello e modificalo in modo che rifletta la directory di installazione. La cartella deve già esistere.
Ad esempio, se sostituisci path-to-my-directory con /Users/myUser/Desktop, il aws-sam-cli la cartella del 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>
-
Salva il xml 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 visualizzare le preferenze che verranno applicate al AWS SAM CLI programma.
-
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 collegamento 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, sudo non è richiesto. In caso contrario, sudo è richiesto.
-
path-to — Percorso in cui è stato installato AWS SAM CLI programma. Ad esempio, /Users/myUser/Desktop.
-
path-to-symlink-directory — Il tuo $PATH variabile d'ambiente. Il percorso predefinito è /usr/local/bin.
Per verificare una corretta installazione
-
Verificare che AWS SAM CLI è installato correttamente e il collegamento simbolico è 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 file MSI.
-
Scarica il AWS SAM CLI 64 bit.
-
(Opzionale) È possibile verificare l'integrità del programma di installazione prima dell'installazione. Per istruzioni, consulta l’argomento Facoltativo: verifica l'integrità del AWS SAM CLI Installer (Programma di installazione).
-
Verifica l'installazione.
Dopo aver completato l'installazione, verificatela aprendo un nuovo prompt dei comandi o PowerShell prompt. Dovresti essere in grado di invocare sam dalla riga di comando.
sam --version
Dopo una corretta installazione di AWS SAM CLI, dovresti vedere un output come il seguente:
SAM CLI, <latest version>
-
Abilita percorsi lunghi (solo Windows 10 e versioni successive).
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 di Windows 10 MAX_PATH limitazioni. Per risolvere questo problema, è necessario configurare il nuovo comportamento dei percorsi lunghi.
Per abilitare i percorsi lunghi, vedi Abilita i percorsi lunghi in Windows 10, versione 1607 e successive nel Documentazione sullo sviluppo di app per Microsoft Windows.
-
Installa Git.
Per scaricare applicazioni di esempio utilizzando sam init comando, devi installare anche Git. Per istruzioni, vedi Installare 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 ec2-user per accedere 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 AWS SAM CLI eseguibile, quindi verifica che la directory sia sul tuo percorso.
AWS SAM CLI errore: «/lib64/libc.so.6: versione `GLIBC_2.14' non trovata (richiesta da/usr/local/aws-sam-cli/dist/libz.so.1)»
Se ricevi questo errore, stai utilizzando una versione di Linux non supportata e la versione integrata di glibc non è aggiornata. Prova una delle seguenti opzioni:
-
Aggiorna il tuo host Linux alla versione a 64 bit di una recente distribuzione di CentOS, Fedora, Ubuntu o Amazon Linux 2.
-
Segui le istruzioni per Installa il AWS SAM CLI.
macOS
L'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 opzioni:
-
Seleziona una directory di installazione diversa per la quale disponi delle autorizzazioni di scrittura.
-
Elimina il programma di installazione. Quindi, scaricalo ed eseguilo nuovamente.
Fasi successive
Per saperne di più su AWS SAM CLI e per iniziare a creare le tue applicazioni serverless, consulta quanto segue: