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.
Tópicos
Atualizar o AWS SAM CLI
Para atualizar o AWS SAMCLI no Linux, siga as instruções de instalação em Instalar o AWS SAM CLI, mas adicione a opção --update
ao comando de instalação, da seguinte forma:
sudo ./sam-installation/install --update
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.
Para atualizar o AWS SAMCLI, repita as etapas de instalação do Windows Instale o AWS SAM CLI novamente.
Desinstalando o AWS SAMCLI
Para desinstalar o AWS SAMCLI no Linux, você deve excluir o symlink e o diretório de instalação executando os seguintes comandos:
-
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
-
-
Exclua o symlink.
sudo rm /usr/local/bin/sam
-
Exclua o diretório de instalação.
sudo rm -rf /usr/local/aws-sam-cli
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
-
Remova o programa AWS SAMCLI modificando e executando o seguinte:
$
sudo
rm -rf/path-to
/aws-sam-cli-
sudo
— Se o usuário tiver permissões de escrita no local onde o programa AWS SAMCLI está instalado, o sudo não é necessário. Caso contrário, o sudo será obrigatório. -
/path-to
— Caminho para onde você instalou o programa AWS SAMCLI. O local padrão é/usr/local
.
-
-
Remova o AWS SAMCLI
$PATH
modificando e executando o seguinte:$
sudo
rm -rf/path-to-symlink-directory
/sam-
sudo
— Se seu usuário tiver permissões de escrita no$PATH
, o sudo não é necessário. Caso contrário, o sudo será obrigatório. -
path-to-symlink-directory
— Sua variável de$PATH
ambiente. O local padrão é/usr/local/bin
.
-
-
Verifique se o AWS SAMCLI está desinstalado executando o seguinte:
$
sam --version
command not found: sam
Para desinstalar o AWS SAMCLI usando as Configurações do Windows, siga estas etapas:
-
No menu Iniciar, procure por “Adicionar ou remover programas”.
-
Escolha o resultado chamado AWS SAM Interface da linha de comando e escolha Desinstalar para executar o desinstalador.
-
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
-
Siga as instruções em Desinstalando uma CLI Homebrew instalada no AWS SAM para desinstalar a versão do Homebrew gerenciada.
-
Siga as instruções em Instale o AWS SAM CLI 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.
Você pode instalar a versão de compilação noturna do AWS SAMCLI na plataforma Linux x86_64 usando o instalador do pacote.
Para instalar a compilação AWS SAMCLI noturna
-
Baixe o instalador do pacote sam-cli-nightly
no aws-sam-cli GitHubrepositório. -
Siga as etapas de instalação do AWS SAMCLI para instalar o pacote de compilação noturna.
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
-
Baixe o instalador do pacote para sua plataforma sam-cli-nightly
no aws-sam-cli GitHubrepositório. -
Siga as etapas de instalação do AWS SAMCLI para instalar o pacote de compilação noturna.
A versão de compilação noturna do AWS SAMCLI está disponível com este link para download: AWS SAMCLI 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<YYYYMMDDHHmm>
, 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
-
Desinstale a Homebrew compilação AWS SAMCLI noturna instalada.
$
brew uninstall aws-sam-cli-nightly
-
Verifique se a compilação AWS SAMCLI noturna está desinstalada executando o seguinte:
$
sam-nightly --version
zsh: command not found: sam-nightly -
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.
Como instalar a AWS SAM CLI em um ambiente virtual
-
Em um diretório inicial de sua escolha, crie um ambiente virtual e dê um nome a ele.
-
Ative o ambiente virtual.
-
Instale a AWS SAMCLI em seu ambiente virtual.
(venv) $
pip install --upgrade aws-sam-cli
-
Verifique se o AWS SAMCLI está instalado corretamente.
(venv) $
sam --version
SAM CLI, version1.94.0
-
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 e atualização 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
Para instalar o AWS SAM CLI
-
Execute o seguinte:
$
brew install aws-sam-cli
-
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 SAMCLIHomebrew
Para atualizar a AWS SAM CLI usando o Homebrew, execute este comando:
$
brew upgrade aws-sam-cli
Desinstalando uma CLI Homebrew instalada no AWS SAM
Se a AWS SAMCLI foi instalada usando o Homebrew, siga estas etapas para desinstalá-la.
Para desinstalar o AWS SAM CLI
-
Execute o seguinte:
$
brew uninstall aws-sam-cli
-
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
-
Desinstale a Homebrew versão AWS gerenciada do AWS SAMCLI:
$
brew uninstall aws-sam-cli
-
Verifique se o AWS SAMCLI foi desinstalado:
$
which sam
sam not found -
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
-
Remova os arquivos em cache do instalador AWS gerenciado:
$
brew cleanup aws/tap
-
Atualize o Homebrew e todas as fórmulas:
$
brew update
-
Instale a versão gerenciada pela comunidade do AWS SAMCLI:
$
brew install aws-sam-cli
-
Verifique se a instalação do AWS SAM CLI foi bem-sucedida.
$
sam --version
SAM CLI, version1.94.0
Solução de problemas
Se você encontrar erros ao instalar ou usar o AWS SAMCLI, consulteAWS SAM CLI solução de problemas.