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 SAMCLI
**Topics**
+ [Aggiornamento del AWS SAMCLI](#manage-sam-cli-versions-upgrade)
+ [Disinstallazione di AWS SAMCLI](#manage-sam-cli-versions-uninstall)
+ [Passa dall'uso Homebrew alla gestione di AWS SAMCLI](#manage-sam-cli-versions-switch)
+ [Gestire la build AWS SAMCLI notturna](#manage-sam-cli-versions-nightly-build)
+ [Installare il file AWS SAMCLI in un ambiente virtuale utilizzando pip](#manage-sam-cli-versions-install-virtual)
+ [Gestire il AWS SAMCLI con Homebrew](#manage-sam-cli-versions-homebrew)
+ [Risoluzione dei problemi](#manage-sam-cli-versions-troubleshoot)
## Aggiornamento del AWS SAMCLI
### Linux
Per eseguire l'aggiornamento AWS SAMCLI su Linux, segui le istruzioni di installazione riportate in[Installazione di AWS SAMCLI](install-sam-cli.md#install-sam-cli-instructions), ma aggiungi l'`--update`opzione al comando install, come segue:
```
sudo ./sam-installation/install --update
```
### macOS
AWS SAMCLIDeve essere aggiornato con lo stesso metodo utilizzato per installarlo. Si consiglia di utilizzare il programma di installazione del pacchetto per installare e aggiornare il. AWS SAMCLI
Per aggiornarlo AWS SAMCLI utilizzando il programma di installazione del pacchetto, installa la versione più recente del pacchetto. Per istruzioni, consulta [Installazione di AWS SAMCLI](install-sam-cli.md#install-sam-cli-instructions).
### Windows
Per aggiornare il AWS SAMCLI, ripeti [Installa il AWS SAMCLI](install-sam-cli.md) nuovamente la procedura di installazione di Windows.
## Disinstallazione di AWS SAMCLI
### Linux
Per disinstallare AWS SAMCLI su Linux, è necessario eliminare il collegamento simbolico 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
```
1. Eliminare il collegamento simbolico.
```
sudo rm /usr/local/bin/sam
```
1. Eliminare la directory di installazione.
```
sudo rm -rf /usr/local/aws-sam-cli
```
### macOS
Disinstallalo AWS SAMCLI 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 SAMCLI utilizzando il programma di installazione del pacchetto, segui questi passaggi per disinstallarlo.
**Per disinstallare il AWS SAMCLI**
1. Rimuovere il AWS SAMCLI 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 SAMCLI programma, non **sudo** è necessario. In caso contrario, **sudo** è richiesto.
1. */path-to*— Percorso in cui è stato installato il AWS SAMCLI programma. Il percorso predefinito è `/usr/local`.
1. Rimuovere il file AWS SAMCLI `$PATH` modificando ed eseguendo quanto segue:
```
$ sudo rm -rf /path-to-symlink-directory/sam
```
1. *sudo*— Se l'utente dispone dei permessi di scrittura`$PATH`, non **sudo** è necessario. In caso contrario, **sudo** è richiesto.
1. *path-to-symlink-directory*— La tua variabile di `$PATH` ambiente. Il percorso predefinito è `/usr/local/bin`.
1. Verificate che AWS SAMCLI sia disinstallato eseguendo quanto segue:
```
$ sam --version
command not found: sam
```
### Windows
Per disinstallarlo AWS SAMCLI utilizzando le impostazioni di Windows, procedi nel seguente modo:
1. Dal menu Start, cerca «Aggiungi o rimuovi programmi».
1. Scegli il risultato denominato **AWS SAM Command Line Interface**, quindi scegli **Disinstalla** per avviare il programma di disinstallazione.
1. Conferma di voler disinstallare il. AWS SAMCLI
## 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](#manage-sam-cli-versions-homebrew-uninstall) per disinstallare la versione Homebrew gestita.
1. Segui le istruzioni su [Installa il AWS SAMCLI](install-sam-cli.md) per installare la AWS SAM CLI utilizzando un metodo supportato.
## Gestire la build AWS SAMCLI notturna
Puoi scaricare e installare la AWS SAMCLI build notturna. Contiene una versione preliminare del AWS SAMCLI 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 SAMCLI 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-container**opzione utilizza l'ultima versione di produzione dell'immagine di build.
### Installazione della AWS SAMCLI nightly build
Per installare la AWS SAMCLI versione notturna, segui queste istruzioni.
#### Linux
È possibile installare la versione nightly build di AWS SAMCLI sulla piattaforma Linux x86\$164 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](https://github.com/aws/aws-sam-cli/releases/sam-cli-nightly/). aws-sam-cli GitHub*
1. Segui i passaggi per [AWS SAMCLIinstallare il](install-sam-cli.md) pacchetto nightly build.
#### macOS
È possibile installare la versione nightly build di AWS SAMCLI onmacOS, utilizzando 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](https://github.com/aws/aws-sam-cli/releases/sam-cli-nightly/). aws-sam-cli GitHub*
1. Segui i passaggi per [AWS SAMCLIinstallare il](install-sam-cli.md) pacchetto nightly build.
#### Windows
La versione nightly build di AWS SAMCLI è disponibile con questo link per il download: [AWS SAMCLInightly](https://github.com/aws/aws-sam-cli/releases/download/sam-cli-nightly/AWS_SAM_CLI_64_PY3.msi) build. Per installare la versione nightly build su Windows, esegui gli stessi passaggi di[Installa il AWS SAMCLI](install-sam-cli.md), 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 formato`1.X.Y.dev`, 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 SAMCLI 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 SAMCLI nightly Homebrew installata.
```
$ brew uninstall aws-sam-cli-nightly
```
1. Verifica che la AWS SAMCLI nightly build sia disinstallata eseguendo quanto segue:
```
$ sam-nightly --version
zsh: command not found: sam-nightly
```
1. Segui i passaggi della sezione precedente per installare la nightly build. AWS SAMCLI
## Installare il file AWS SAMCLI in un ambiente virtuale utilizzando pip
Si consiglia di utilizzare il programma di installazione nativo del pacchetto per installare. AWS SAMCLI Se è necessario utilizzarlopip, si consiglia di installarlo AWS SAMCLI 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, consulta [AWS SAMCLIinterruzione del supporto per Python 3.7](important-notes.md#important-notes-2023-10-python).
**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
```
------
1. 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) >
```
------
1. Installalo AWS SAMCLI nel tuo ambiente virtuale.
```
(venv) $ pip install --upgrade aws-sam-cli
```
1. Verifica che AWS SAMCLI sia installato correttamente.
```
(venv) $ sam --version
SAM CLI, version 1.94.0
```
1. 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 SAMCLI ()`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](install-sam-cli.md) e [aggiornamento](#manage-sam-cli-versions-upgrade) supportati.
### Installazione dell' AWS SAMCLIutilizzo Homebrew
**Nota**
Queste istruzioni utilizzano il programma di AWS SAMCLI Homebrew installazione gestito dalla comunità. Per ulteriore assistenza, consulta il repository *[homebrew-core](https://github.com/Homebrew/homebrew-core/issues)*.
**Per installare il AWS SAMCLI**
1. Esegui il seguente codice:
```
$ brew install aws-sam-cli
```
1. 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 SAMCLI Homebrew
Per aggiornare l' AWS SAMCLIutilizzoHomebrew, esegui il seguente comando:
```
$ brew upgrade aws-sam-cli
```
### Disinstallazione di una CLI Homebrew installata AWS SAM
Se AWS SAMCLI è stato installato utilizzandoHomebrew, segui questi passaggi per disinstallarlo.
**Per disinstallare il AWS SAMCLI**
1. Esegui il seguente codice:
```
$ brew uninstall aws-sam-cli
```
1. Verificare che AWS SAMCLI sia disinstallato eseguendo quanto segue:
```
$ sam --version
command not found: sam
```
### Passaggio al programma di installazione gestito Homebrew dalla community
Se stai usando il programma di Homebrew installazione AWS gestito (`aws/tap/aws-sam-cli`) e preferisci continuare a usarloHomebrew, ti consigliamo di passare al programma di Homebrew installazione gestito dalla community ()`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
```
1. Verifica che sia AWS SAMCLI stato disinstallato:
```
$ which sam
sam not found
```
1. Rimuovi il AWS SAMCLI rubinetto AWS gestito:
```
$ brew untap aws/tap
```
Se ricevi un errore come il seguente, aggiungi l'`--force`opzione e riprova.
```
Error: Refusing to untap aws/tap because it contains the following installed formulae or casks:
aws-sam-cli-nightly
```
1. Rimuovi i file memorizzati nella cache per il programma di installazione AWS gestito:
```
$ brew cleanup aws/tap
```
1. Aggiornamento Homebrew e tutte le formule:
```
$ brew update
```
1. Installa la versione gestita dalla community di AWS SAMCLI:
```
$ brew install aws-sam-cli
```
1. Verifica che AWS SAMCLI sia installato correttamente:
```
$ sam --version
SAM CLI, version 1.94.0
```
## Risoluzione dei problemi
Se riscontri errori durante l'installazione o l'utilizzo di AWS SAMCLI, consulta[AWS SAMCLIrisoluzione dei problemi](sam-cli-troubleshooting.md).