Gerenciar versões do AWS SAM CLI - AWS Serverless Application Model
Atualizar o AWS SAM CLIDesinstalando o AWS SAMCLIMudar de HomebrewGerenciando a AWS SAMCLI compilação noturnaInstalar a AWS SAM CLI em um ambiente virtual usando o pipGerenciamento o AWS SAM CLI com o HomebrewSolução de problemas

Gerenciar versões do AWS SAM CLI

Gerencie suas versões da interface de linha de comando AWS Serverless Application Model (AWS SAMCLI) por meio de atualização, downgrade e desinstalação. Opcionalmente, você pode baixar e instalar a compilação AWS SAM CLI noturna.

Atualizar o AWS SAM CLI

Para atualizar o AWS SAM CLI 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 SAM CLI deve ser atualizado pelo mesmo método usado para instalá-lo. Recomendamos que você use o instalador do pacote para instalar e atualizar o AWS SAM CLI.

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

Desinstalando o AWS SAMCLI

Para desinstalar o AWS SAM CLI 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

Desinstale o AWS SAM CLI por meio do mesmo método usado para instalá-lo. Recomendamos que você use o instalador de pacote para instalar o arquivo AWS SAM CLI.

Se você instalou o AWS SAM CLI usando o instalador do pacote, siga estas etapas para desinstalar.

Para desinstalar o AWS SAM CLI

  1. Remova o programa AWS SAM CLI 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 SAM CLI 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 SAM CLI. O local padrão é /usr/local.

  2. Remova o AWS SAM CLI $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 ambiente $PATH. O local padrão é /usr/local/bin.

  3. Verifique se o AWS SAM CLI está desinstalado executando o seguinte: 

    $ sam --version
command not found: sam

Para desinstalar o AWS SAM CLI 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 deseja desinstalar a AWS SAM CLI.

Pare de usar o Homebrew para gerenciar o AWS SAMCLI

Se você usa o 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 SAM CLI noturna. Ela contém uma versão de pré-lançamento do código AWS SAM CLI 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 SAM CLI 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 SAM CLI versão noturna, siga estas instruções.

Você pode instalar a versão de compilação noturna do AWS SAM CLI na plataforma Linux x86_64 usando o instalador do pacote.

Para instalar a compilação AWS SAMCLI noturna

  1. Baixe o instalador do pacote do sam-cli-nightly no repositório aws-sam-cli GitHub.

  2. 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 SAM CLI 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 em sam-cli-nightly no repositório aws-sam-cli GitHub.

  2. 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 SAM CLI 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 SAM CLI 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 SAM CLI noturna instalada.

    $ brew uninstall aws-sam-cli-nightly

  2. Verifique se a compilação AWS SAM CLI 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 SAM CLI noturna.

Instalar a AWS SAM CLI em um ambiente virtual usando o pip

Recomendamos usar o instalador do pacote para instalar o AWS SAM CLI. 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

A partir de 24 de outubro de 2023, AWS SAM CLI o suporte para o Python 3.7 está descontinuado. 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 SAM CLI em seu ambiente virtual.

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

  4. Verifique se o AWS SAM CLI 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, o AWS não manterá mais o instalador AWS para o Homebrew .AWS SAM CLI (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 instalador AWS SAM CLI Homebrew 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 SAM CLI, o resultado deverá ser parecido com o 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 SAM CLI 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 SAM CLI 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 AWS instalador Homebrew gerenciado (aws/tap/aws-sam-cli) e preferir continuar usando o Homebrew, recomendamos mudar para o instalador Homebrew 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 versão AWS Homebrew gerenciada do AWS SAM CLI:

    $ brew uninstall aws-sam-cli

  2. Verifique se o AWS SAM CLI foi desinstalado:

    $ which sam
sam not found

  3. Remova o tap AWS gerenciado pelo AWS SAM CLI:

    $ 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 SAM CLI:

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