As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Gerenciar versões do AWS SAM CLI
Gerencie suas versões da interface de linha de AWS Serverless Application Model comando (AWS SAMCLI) por meio de atualização, downgrade e desinstalação. Opcionalmente, você pode baixar e instalar a compilação AWS SAMCLI noturna.
**Topics**
+ [Atualizar o AWS SAM CLI](#manage-sam-cli-versions-upgrade)
+ [Desinstalando o AWS SAMCLI](#manage-sam-cli-versions-uninstall)
+ [Pare de usar o Homebrew para gerenciar o AWS SAMCLI](#manage-sam-cli-versions-switch)
+ [Gerenciando a AWS SAMCLI compilação noturna](#manage-sam-cli-versions-nightly-build)
+ [Instalar a AWS SAM CLI em um ambiente virtual usando o pip](#manage-sam-cli-versions-install-virtual)
+ [Gerenciamento o AWS SAM CLI com o Homebrew](#manage-sam-cli-versions-homebrew)
+ [Solução de problemas](#manage-sam-cli-versions-troubleshoot)
## Atualizar o AWS SAM CLI
### Linux
Para atualizar o AWS SAMCLI no Linux, siga as instruções de instalação em [Instalar o AWS SAM CLI](install-sam-cli.md#install-sam-cli-instructions), mas adicione a opção `--update` ao comando de instalação, da seguinte forma:
```
sudo ./sam-installation/install --update
```
### macOS
O AWS SAMCLI deve ser atualizado pelo mesmo método usado para instalá-lo. Recomendamos que você use o instalador do pacote para instalar e atualizar AWS SAMCLI o.
Para atualizar o AWS SAMCLI usando o instalador de pacotes, instale a versão mais recente do pacote. Para obter instruções, consulte [Instalar o AWS SAM CLI](install-sam-cli.md#install-sam-cli-instructions).
### Windows
Para atualizar o AWS SAMCLI, repita as etapas de instalação do Windows [Instale o AWS SAM CLI](install-sam-cli.md) novamente.
## Desinstalando o AWS SAMCLI
### Linux
Para desinstalar o AWS SAMCLI no Linux, você deve excluir o symlink e o diretório de instalação executando os seguintes comandos:
1. Localize o symlink e instale caminhos.
+ Encontre o link simbólico usando o **which** comando:
```
which sam
```
A saída mostra o caminho em que os AWS SAM binários estão localizados, por exemplo:
```
/usr/local/bin/sam
```
+ Encontre o diretório para o qual o link simbólico aponta usando o **ls** comando:
```
ls -l /usr/local/bin/sam
```
No exemplo a seguir, o diretório de instalação é `/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. Exclua o symlink.
```
sudo rm /usr/local/bin/sam
```
1. Exclua o diretório de instalação.
```
sudo rm -rf /usr/local/aws-sam-cli
```
### macOS
Desinstale o AWS SAMCLI por meio do mesmo método usado para instalá-lo. Recomendamos que você use o instalador do pacote para instalar AWS SAMCLI o.
Se você instalou o AWS SAMCLI usando o instalador do pacote, siga estas etapas para desinstalar.
**Para desinstalar o AWS SAM CLI**
1. Remova o programa AWS SAMCLI modificando e executando o seguinte:
```
$ sudo rm -rf /path-to/aws-sam-cli
```
1. *sudo*— Se o seu usuário tiver permissões de gravação no local onde o AWS SAMCLI programa está instalado, não **sudo** é necessário. Caso contrário, o **sudo** será obrigatório.
1. */path-to*— Caminho até onde você instalou o AWS SAMCLI programa. O local padrão é `/usr/local`.
1. Remova o AWS SAMCLI `$PATH` modificando e executando o seguinte:
```
$ sudo rm -rf /path-to-symlink-directory/sam
```
1. *sudo*— Se o seu usuário tiver permissões de gravação para`$PATH`, não **sudo** é necessário. Caso contrário, o **sudo** será obrigatório.
1. *path-to-symlink-directory*— Sua variável de `$PATH` ambiente. O local padrão é `/usr/local/bin`.
1. Verifique se o AWS SAMCLI está desinstalado executando o seguinte:
```
$ sam --version
command not found: sam
```
### Windows
Para desinstalar o AWS SAMCLI usando as Configurações do Windows, siga estas etapas:
1. No menu Iniciar, procure por “Adicionar ou remover programas”.
1. Escolha o resultado chamado **AWS SAM Interface da linha de comando** e escolha **Desinstalar** para executar o desinstalador.
1. Confirme que você deseja desinstalar AWS SAMCLI o.
## Pare de usar o Homebrew para gerenciar o AWS SAMCLI
Se você usa Homebrew para instalar e atualizar o AWS SAMCLI, recomendamos usar um método AWS compatível. Siga estas instruções para mudar para um método compatível.
**Para deixar de usar o Homebrew**
1. Siga as instruções em [Desinstalando uma CLI Homebrew instalada AWS SAM](#manage-sam-cli-versions-homebrew-uninstall) para desinstalar a versão do Homebrew gerenciada.
1. Siga as instruções em [Instale o AWS SAM CLI](install-sam-cli.md) para instalar a CLI AWS SAM usando um método compatível.
## Gerenciando a AWS SAMCLI compilação noturna
Você pode baixar e instalar a versão AWS SAMCLI noturna. Ela contém uma versão de pré-lançamento do código AWS SAMCLI que pode ser menos estável do que a versão de produção. Quando instalado, você pode usar a compilação noturna com o comando `sam-nightly`. Você pode instalar e usar as versões de produção e compilação noturna do AWS SAMCLI ao mesmo tempo.
**nota**
A compilação noturna não contém uma versão de pré-lançamento da imagem de compilação. Por isso, criar seu aplicativo sem servidor com a opção **--use-container** usa a versão de produção mais recente da imagem de compilação.
### Instalando a compilação AWS SAMCLI noturna
Para instalar a AWS SAMCLI versão noturna, siga estas instruções.
#### Linux
Você pode instalar a versão de compilação noturna do AWS SAMCLI na plataforma Linux x86\$164 usando o instalador do pacote.
**Para instalar a compilação AWS SAMCLI noturna**
1. Baixe o instalador do pacote [sam-cli-nightly](https://github.com/aws/aws-sam-cli/releases/sam-cli-nightly/)no *aws-sam-cli GitHubrepositório.*
1. Siga as etapas de [instalação do AWS SAMCLI](install-sam-cli.md) para instalar o pacote de compilação noturna.
#### macOS
Você pode instalar a versão de compilação noturna do AWS SAMCLI na macOS usando o instalador do pacote de compilação noturna.
**Para instalar a compilação AWS SAMCLI noturna**
1. Baixe o instalador do pacote para sua plataforma [sam-cli-nightly](https://github.com/aws/aws-sam-cli/releases/sam-cli-nightly/)no *aws-sam-cli GitHubrepositório.*
1. Siga as etapas de [instalação do AWS SAMCLI](install-sam-cli.md) para instalar o pacote de compilação noturna.
#### Windows
A versão de compilação noturna do AWS SAMCLI está disponível com este link para download: [AWS SAMCLI compilação noturna](https://github.com/aws/aws-sam-cli/releases/download/sam-cli-nightly/AWS_SAM_CLI_64_PY3.msi). Para instalar a compilação noturna no Windows, execute as mesmas etapas do [Instale o AWS SAM CLI](install-sam-cli.md), mas use o link de download da compilação noturna.
Para verificar se você instalou a versão de compilação noturna, execute o comando **sam-nightly --version**. A saída desse comando está no formato `1.X.Y.dev`, por exemplo:
```
SAM CLI, version 1.20.0.dev202103151200
```
### Mude do Homebrew para o instalador de pacotes
Se você estiver usando o Homebrew para instalar e atualizar a compilação AWS SAMCLI noturna e quiser passar a usar o instalador de pacotes, siga estas etapas.
**Para mudar do Homebrew para o instalador de pacotes**
1. Desinstale a Homebrew compilação AWS SAMCLI noturna instalada.
```
$ brew uninstall aws-sam-cli-nightly
```
1. Verifique se a compilação AWS SAMCLI noturna está desinstalada executando o seguinte:
```
$ sam-nightly --version
zsh: command not found: sam-nightly
```
1. Siga as etapas da seção anterior para instalar a compilação AWS SAMCLI noturna.
## Instalar a AWS SAM CLI em um ambiente virtual usando o pip
Recomendamos usar o instalador de pacotes nativo para instalar AWS SAMCLI o. Se você precisar usar o pip, recomendamos que você instale a AWS SAM CLI em um ambiente virtual. Isso garante um ambiente de instalação limpo e um ambiente isolado caso ocorram erros.
**nota**
Em 24 de outubro de 2023, AWS SAM CLI o suporte para o. Python 3.7 Para saber mais, consulte [AWS SAMCLI descontinuando o suporte para Python 3.7](important-notes.md#important-notes-2023-10-python).
**Como instalar a AWS SAM CLI em um ambiente virtual**
1. Em um diretório inicial de sua escolha, crie um ambiente virtual e dê um nome a ele.
------
#### [ Linux / macOS ]
```
$ mkdir project
$ cd project
$ python3 -m venv venv
```
------
#### [ Windows ]
```
> mkdir project
> cd project
> py -3 -m venv venv
```
------
1. Ative o ambiente virtual.
------
#### [ Linux / macOS ]
```
$ . venv/bin/activate
```
O prompt mudará para mostrar que seu ambiente virtual está ativo.
```
(venv) $
```
------
#### [ Windows ]
```
> venv\Scripts\activate
```
O prompt mudará para mostrar que seu ambiente virtual está ativo.
```
(venv) >
```
------
1. Instale a AWS SAMCLI em seu ambiente virtual.
```
(venv) $ pip install --upgrade aws-sam-cli
```
1. Verifique se o AWS SAMCLI está instalado corretamente.
```
(venv) $ sam --version
SAM CLI, version 1.94.0
```
1. Use o comando `deactivate` para sair do ambiente virtual. Sempre que você iniciar uma nova sessão, deverá ativar novamente o ambiente.
## Gerenciamento o AWS SAM CLI com o Homebrew
**nota**
A partir de setembro de 2023, não AWS manterá mais o Homebrew instalador AWS gerenciado do AWS SAMCLI (`aws/tap/aws-sam-cli`). Para continuar usando o Homebrew, use o instalador gerenciado pela comunidade (`aws-sam-cli`). A partir de setembro de 2023, qualquer comando Homebrew que faça referência a `aws/tap/aws-sam-cli` será redirecionado para o `aws-sam-cli`.
Recomendamos que você use nossos métodos de [instalação](install-sam-cli.md) e [atualização](#manage-sam-cli-versions-upgrade) compatíveis.
### Instalar a AWS SAMCLI usando o Homebrew
**nota**
Essas instruções usam o AWS SAMCLI Homebrew instalador gerenciado pela comunidade. Para obter mais suporte, consulte o repositório *[homebrew-core](https://github.com/Homebrew/homebrew-core/issues)*.
**Para instalar o AWS SAM CLI**
1. Execute o seguinte:
```
$ brew install aws-sam-cli
```
1. Verifique a instalação:
```
$ sam --version
```
Após a instalação bem-sucedida do AWS SAMCLI, você deverá ver uma saída como a seguinte:
```
SAM CLI, version 1.94.0
```
### Atualizando o uso do AWS SAMCLI Homebrew
Para atualizar a AWS SAM CLI usando o Homebrew, execute este comando:
```
$ brew upgrade aws-sam-cli
```
### Desinstalando uma CLI Homebrew instalada AWS SAM
Se a AWS SAMCLI foi instalada usando o Homebrew, siga estas etapas para desinstalá-la.
**Para desinstalar o AWS SAM CLI**
1. Execute o seguinte:
```
$ brew uninstall aws-sam-cli
```
1. Verifique se o AWS SAMCLI está desinstalado executando o seguinte:
```
$ sam --version
command not found: sam
```
### Como mudar para o instalador Homebrew gerenciado pela comunidade
Se você estiver usando o Homebrew instalador AWS gerenciado (`aws/tap/aws-sam-cli`) e preferir continuar usandoHomebrew, recomendamos mudar para o Homebrew instalador gerenciado pela comunidade (`aws-sam-cli`).
Para alternar em um único comando, execute o seguinte:
```
$ brew uninstall aws-sam-cli && brew untap aws/tap && brew cleanup aws/tap && brew update && brew install aws-sam-cli
```
Siga estas instruções para executar cada comando individualmente.
**Para mudar para o Homebrew instalador gerenciado pela comunidade**
1. Desinstale a Homebrew versão AWS gerenciada do AWS SAMCLI:
```
$ brew uninstall aws-sam-cli
```
1. Verifique se o AWS SAMCLI foi desinstalado:
```
$ which sam
sam not found
```
1. Remova o AWS SAMCLI toque AWS gerenciado:
```
$ brew untap aws/tap
```
Se você receber um erro como o seguinte, adicione a opção `--force` e tente novamente.
```
Error: Refusing to untap aws/tap because it contains the following installed formulae or casks:
aws-sam-cli-nightly
```
1. Remova os arquivos em cache do instalador AWS gerenciado:
```
$ brew cleanup aws/tap
```
1. Atualize o Homebrew e todas as fórmulas:
```
$ brew update
```
1. Instale a versão gerenciada pela comunidade do AWS SAMCLI:
```
$ brew install aws-sam-cli
```
1. Verifique se a instalação do AWS SAM CLI foi bem-sucedida.
```
$ sam --version
SAM CLI, version 1.94.0
```
## Solução de problemas
Se você encontrar erros ao instalar ou usar o AWS SAMCLI, consulte[AWS SAM CLI solução de problemas](sam-cli-troubleshooting.md).