Installazione del AWS SAMCLI - 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 del AWS SAMCLI

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

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

È la prima volta che installi il? AWS SAM CLI

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

  1. Registrazione di un AWS account.

  2. Creazione di un utente IAM amministrativo.

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

  4. Installazione di AWS CLI.

  5. Configurazione delle AWS credenziali.

Installazione di AWS SAMCLI

Nota

A partire da settembre 2023, AWS non manterrà più il programma di Homebrew installazione AWS gestito per AWS SAMCLI (aws/tap/aws-sam-cli). Se utilizzi Homebrew per installare e gestire il AWS SAMCLI, consulta le seguenti opzioni:

  • Per continuare a utilizzareHomebrew, 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, consultaPassa da Homebrew.

Per installare AWS SAMCLI, segui le istruzioni relative al tuo sistema operativo.

arm64 - command line installer
  1. Scarica il AWS SAMCLIfile.zip in una directory a tua scelta.

  2. (Facoltativo) È possibile verificare l'integrità del programma di installazione prima dell'installazione. Per istruzioni, consulta Verifica l'integrità del AWS SAMCLI 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 AWS SAMCLI 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, dovresti vedere un output come il seguente, ma che sostituisce il testo tra parentesi con l'ultima versione SAM CLI:

     SAM CLI, <latest version>
x86_64 - command line installer
  1. Scarica il AWS SAMCLIfile.zip in una directory a tua scelta.

  2. (Facoltativo) È possibile verificare l'integrità del programma di installazione prima dell'installazione. Per istruzioni, consulta Verifica l'integrità del AWS SAMCLI 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 AWS SAMCLI 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>

Installa il file AWS SAMCLI utilizzando il relativo programma di installazione del pacchetto.

Nota

Il programma di installazione del pacchetto è disponibile in x86_64 e arm64 opzioni. Scegli il pacchetto più adatto al tuo Mac hardware:

  • x86_64— Da utilizzare per Macs far funzionare i Intel processori.

  • arm64— Utilizzare per Macs far funzionare il Apple silicio.

Per ulteriori informazioni, vedere MacComputer with Apple silicon.

Utilizzo del programma di installazione del pacchetto

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

  1. GUI

  2. Riga di comando

È possibile eseguire l'installazione per tutti gli utenti o solo per l'utente corrente. Per eseguire l'installazione per tutti gli utenti, è richiesta l'autorizzazione di superutente.

Fasi di installazione

Installa il AWS SAMCLI utilizzando una delle seguenti opzioni.

GUI - All users
Per scaricare il programma di installazione del pacchetto
Nota

Se hai già installato il AWS SAMCLI Through Homebrew orpip, devi prima disinstallarlo. Per istruzioni, consulta Disinstallazione di AWS SAMCLI.

Per verificare il programma di installazione del pacchetto (opzionale)
Per installare AWS SAMCLI
  1. Esegui il file scaricato e segui le istruzioni sullo schermo per continuare con i passaggi Introduzione, Read Me e Licenza.

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

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

    Nota

    Per richiamarla AWS SAMCLI 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.

  4. AWS SAMCLIVerrà visualizzato il messaggio «L'installazione è avvenuta con successo». Premere Chiudi.

Per verificare la corretta installazione
  • Verifica che sia AWS SAMCLI installato correttamente e che il tuo link simbolico sia configurato eseguendo:

    $ which sam /usr/local/bin/sam $ sam --version SAM CLI, <latest version>
GUI - Current user
Per scaricare il programma di installazione del pacchetto
Nota

Se hai già installato il AWS SAMCLI Through Homebrew orpip, devi prima disinstallarlo. Per istruzioni, consulta Disinstallazione di AWS SAMCLI.

Per verificare il programma di installazione del pacchetto (opzionale)
Per installare AWS SAMCLI
  1. Esegui il file scaricato e segui le istruzioni sullo schermo per continuare con i passaggi Introduzione, Read Me e Licenza.

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

  3. Per Tipo di installazione, procedi come segue:

    1. Scegli dove AWS SAMCLI 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.

  4. AWS SAMCLIVerrà installato e verrà visualizzato il messaggio «L'installazione è avvenuta con successo». Premere Chiudi.

Per creare un collegamento simbolico
  • Per richiamarlo AWS SAMCLI con il sam comando, è necessario creare manualmente un collegamento simbolico tra il AWS SAMCLI programma e il proprio. $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, sudo non è necessario. In caso contrario, sudo è richiesto.

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

    • path-to-symlink-directory— La tua variabile di $PATH ambiente. Il percorso predefinito è /usr/local/bin.

Per verificare la corretta installazione
  • Verifica che sia AWS SAMCLI installato correttamente e che il tuo link simbolico sia configurato eseguendo:

    $ which sam /usr/local/bin/sam $ sam --version SAM CLI, <latest version>
Command line - All users
Per scaricare il programma di installazione del pacchetto
Nota

Se hai già installato il AWS SAMCLI Through Homebrew orpip, devi prima disinstallarlo. Per istruzioni, consulta Disinstallazione di AWS SAMCLI.

Per verificare il programma di installazione del pacchetto (opzionale)
Per installare AWS SAMCLI
  • Modificare ed eseguire 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 richiamarlo AWS SAMCLI 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 l'avvenuta installazione
  • Verifica che sia AWS SAMCLI installato correttamente e che il tuo link simbolico sia configurato eseguendo:

    $ which sam /usr/local/bin/sam $ sam --version SAM CLI, <latest version>
Command line - Current user
Per scaricare il programma di installazione del pacchetto
Nota

Se hai già installato il AWS SAMCLI Through Homebrew orpip, devi prima disinstallarlo. Per istruzioni, consulta Disinstallazione di AWS SAMCLI.

Per verificare il programma di installazione del pacchetto (opzionale)
Per installare AWS SAMCLI
  1. Determina una directory di installazione per la quale disponi 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 si sostituisce path-to-my-directorycon/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>
  2. 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 al AWS SAMCLI programma.

  3. Esegui quanto segue per installare AWS SAMCLI:

    $ 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 richiamarlo AWS SAMCLI con il sam comando, è necessario creare manualmente un collegamento simbolico tra il AWS SAMCLI programma e il proprio. $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, sudo non è necessario. In caso contrario, sudo è richiesto.

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

    • path-to-symlink-directory— La tua variabile di $PATH ambiente. Il percorso predefinito è /usr/local/bin.

Per verificare la corretta installazione
  • Verifica che sia AWS SAMCLI installato correttamente e che il tuo link 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 installarli AWS SAMCLI utilizzando il file MSI.

  1. Scarica la AWS SAMCLI versione a 64 bit.

    Nota

    Se usi una versione a 32 bit di Windows, vediInstallazione di AWS SAMCLI su 32 bit Windows.

  2. (Facoltativo) È possibile verificare l'integrità del programma di installazione prima dell'installazione. Per istruzioni, consulta Verifica l'integrità del AWS SAMCLI 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 SAMCLI, si dovrebbe vedere un risultato simile al seguente:

    SAM CLI, <latest version>
  4. Abilita percorsi lunghi (solo Windows 10 e versioni successive).

    Importante

    AWS SAMCLIPotrebbero 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 dei problemi

Se riscontri problemi durante l'installazione di AWS SAMCLI, consultaErrori di installazione.

Passaggi successivi

Per ulteriori informazioni AWS SAMCLI e per iniziare a creare applicazioni serverless personalizzate, consulta quanto segue: