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.

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, 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.

Windows

Para atualizar o AWS SAMCLI, repita as etapas de instalação do Windows Instale o AWS SAM CLI 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

2. Exclua o symlink.

   sudo rm /usr/local/bin/sam

3. 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 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.

   2. /path-to — Caminho para onde você instalou o programa AWS SAMCLI. O local padrão é /usr/local.

2. Remova o AWS SAMCLI $PATH modificando e executando o seguinte:

   $ sudo rm -rf /path-to-symlink-directory/sam

   1. 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.

   2. path-to-symlink-directory— Sua variável de $PATH ambiente. O local padrão é /usr/local/bin.

3. 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”.

2. Escolha o resultado chamado AWS SAM Interface da linha de comando e escolha Desinstalar para executar o desinstalador.

3. 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 no AWS SAM para desinstalar a versão do Homebrew gerenciada.

2. 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.

Linux

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

1. Baixe o instalador do pacote sam-cli-nightlyno aws-sam-cli GitHubrepositório.

2. Siga as etapas de instalação do AWS SAMCLI 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-nightlyno aws-sam-cli GitHubrepositório.

2. Siga as etapas de instalação do AWS SAMCLI 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. Para instalar a compilação noturna no Windows, execute as mesmas etapas do Instale o AWS SAM CLI, 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<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

1. Desinstale a Homebrew compilação AWS SAMCLI noturna instalada.

   $ brew uninstall aws-sam-cli-nightly

2. Verifique se a compilação AWS SAMCLI noturna está desinstalada executando o seguinte:

   $ sam-nightly --version
   zsh: command not found: sam-nightly

3. 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

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

2. 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) > 

3. Instale a AWS SAMCLI em seu ambiente virtual.

   (venv) $ pip install --upgrade aws-sam-cli

4. Verifique se o AWS SAMCLI está instalado corretamente.

   (venv) $ sam --version
   SAM CLI, version 1.94.0

5. 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

1. Execute o seguinte:

   $ brew install aws-sam-cli

2. 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

1. Execute o seguinte:

   $ brew uninstall aws-sam-cli

2. 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

2. Verifique se o AWS SAMCLI foi desinstalado:

   $ which sam
   sam not found

3. 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

4. Remova os arquivos em cache do instalador AWS gerenciado:

   $ brew cleanup aws/tap

5. Atualize o Homebrew e todas as fórmulas:

   $ brew update

6. Instale a versão gerenciada pela comunidade do AWS SAMCLI:

   $ brew install aws-sam-cli

7. 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, consulteAWS SAM CLI solução de problemas.