Instale o AWS SAM CLI

Instale a versão mais recente da interface de linha de comando do AWS Serverless Application Model (CLI do AWS SAM) nos sistemas operacionais compatíveis ao seguir as instruções em Etapa 4: instalar o AWS CLI.

Para obter informações sobre como gerenciar uma versão atualmente instalada do AWS SAM CLI, incluindo como atualizar, desinstalar ou gerenciar compilações noturnas, consulte Gerenciar versões do AWS SAM CLI.

É a primeira vez que você instala o AWS SAM CLI?

Conclua todos os pré-requisitos na seção anterior antes de prosseguir. Isso inclui:

1. Cadastrar-se para obter uma conta da AWS.

2. Configurar o acesso seguro da AWS.

3. Como criar um ID de chave de acesso e a chave de acesso secreta.

4. Instalar o AWS CLI.

5. Configurar credenciais do AWS.

Tópicos

• Instalar o AWS SAM CLI

• Solução de problemas de erros de instalação do

• Próximas etapas

• Opcional: verificar a integridade do instalador da CLI do AWS SAM

Instalar o AWS SAM CLI

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). Se você usa o Homebrew para instalar e gerenciar o AWS SAMCLI, consulte as seguintes opções:

• Para continuar usando o Homebrew, use o instalador gerenciado pela comunidade. Para obter mais informações, consulte Gerenciamento o AWS SAM CLI com o Homebrew.

• Recomendamos o uso de um dos métodos de instalação primários documentados nesta página. Antes de usar um desses métodos, consulte Mudar de Homebrew.

• Para obter detalhes adicionais, consulte a Versão de lançamento: 1.121.0.

Para instalar a AWS SAM CLI, siga as instruções do seu sistema operacional.

Linux

x86_64 - command line installer

1. Baixe o arquivo AWS SAM CLI .zip para um diretório de sua escolha.

2. (Opcional) Você pode verificar a integridade do instalador antes da instalação. Para obter instruções, consulte Opcional: verificar a integridade do instalador da CLI do AWS SAM.

3. Descompacte os arquivos de instalação em um diretório de sua escolha. Veja a seguir um exemplo, usando o subdiretório sam-installation.

   nota

   Se o sistema operacional não tiver o comando unzip integrado, use um equivalente.

   $ unzip aws-sam-cli-linux-x86_64.zip -d sam-installation

4. Instale o AWS SAM CLI executando o install executável. Esse executável está localizado no diretório usado na etapa anterior. Veja a seguir um exemplo, usando o subdiretório sam-installation:

   $ sudo ./sam-installation/install

5. Verifique a instalação.

   $ sam --version

   Para confirmar uma instalação com êxito, você deve ver uma saída que substitua o seguinte texto entre colchetes pela versão mais recente disponível:

    SAM CLI, <latest version>

arm64 - command line installer

1. Baixe o arquivo AWS SAM CLI .zip para um diretório de sua escolha.

2. (Opcional) Você pode verificar a integridade do instalador antes da instalação. Para obter instruções, consulte Opcional: verificar a integridade do instalador da CLI do AWS SAM.

3. Descompacte os arquivos de instalação em um diretório de sua escolha. Veja a seguir um exemplo, usando o subdiretório sam-installation.

   nota

   Se o sistema operacional não tiver o comando unzip integrado, use um equivalente.

   $ unzip aws-sam-cli-linux-arm64.zip -d sam-installation

4. Instale o AWS SAM CLI executando o install executável. Esse executável está localizado no diretório usado na etapa anterior. Veja a seguir um exemplo, usando o subdiretório sam-installation:

   $ sudo ./sam-installation/install

5. Verifique a instalação.

   $ sam --version

   Para confirmar uma instalação com êxito, você deve ver uma saída semelhante à seguinte, mas que substitua o texto entre colchetes pela versão mais recente da CLI do SAM:

    SAM CLI, <latest version>

macOS

Etapas de instalação

Use o instalador do pacote para instalar a CLI do AWS SAM. Além disso, o instalador do pacote tem dois métodos de instalação que você pode escolher: GUI e Linha de comendo. Você pode instalar para todos os usuários ou apenas para o usuário atual. Para instalar para todos os usuários, é necessária autorização de superusuário.

nota

A CLI do AWS SAM não é compatível com versões do macOS anteriores ao macOS 13.x. Atualize para uma versão compatível do macOS ou instale a CLI do AWS SAM com Homebrew.

GUI - All users

Para baixar o instalador do pacote e instalar a CLI do AWS SAM

nota

Se você instalou anteriormente o AWS SAM CLI por meio do Homebrew ou do pip, você precisa desinstalá-lo primeiro. Para obter instruções, consulte Desinstalando o AWS SAMCLI.

1. Baixe o pkg do macOS para um diretório de sua escolha:

   • Para Macs que executam processadores Intel, escolha x86_64 – aws-sam-cli-macos-x86_64.pkg

   • Para Macs que executam Apple Silicon, escolha arm64 – aws-sam-cli-macos-arm64.pkg

   nota

   Você tem a opção de verificar a integridade do instalador antes da instalação. Para obter instruções, consulte Opcional: verificar a integridade do instalador da CLI do AWS SAM.

2. Execute o arquivo baixado e siga as instruções na tela para continuar com as etapas de Introdução, Leia-me e Licença.

3. Em Seleção de destino, selecione Instalar para todos os usuários deste computador.

4. Em Tipo de instalação, escolha onde AWS SAM CLI será instalado e pressione Instalar. A localização padrão recomendada é /usr/local/aws-sam-cli.

   nota

   Para invocar o AWS SAM CLI com o comando, sam o instalador cria automaticamente um symlink entre /usr/local/bin/sam e /usr/local/aws-sam-cli/sam ou a pasta de instalação que você escolheu.

5. A mensagem AWS SAM CLI será instalada e A instalação foi bem-sucedida será exibida. Pressione Fechar.

Para verificar uma instalação bem-sucedida

• Verifique se o AWS SAM CLI foi instalado corretamente e se seu symlink está configurado executando:

  $ which sam
  /usr/local/bin/sam
  $ sam --version
  SAM CLI, <latest version>

GUI - Current user

Para baixar e instalar a CLI do AWS SAM

nota

Se você instalou anteriormente o AWS SAM CLI por meio do Homebrew ou do pip, você precisa desinstalá-lo primeiro. Para obter instruções, consulte Desinstalando o AWS SAMCLI.

1. Baixe o pkg do macOS para um diretório de sua escolha:

   • Para Macs que executam processadores Intel, escolha x86_64 – aws-sam-cli-macos-x86_64.pkg

   • Para Macs que executam Apple Silicon, escolha arm64 – aws-sam-cli-macos-arm64.pkg

   nota

   Você tem a opção de verificar a integridade do instalador antes da instalação. Para obter instruções, consulte Opcional: verificar a integridade do instalador da CLI do AWS SAM.

2. Execute o arquivo baixado e siga as instruções na tela para continuar com as etapas de Introdução, Leia-me e Licença.

3. Em Seleção de destino, selecione Instalar somente para mim. Caso não visualize essa opção, vá para a próxima etapa.

4. Para Tipo de instalação, faça o seguinte:

   1. Escolha onde o AWS SAM CLI será instalado. O local padrão é /usr/local/aws-sam-cli. Selecione um local para o qual você tenha permissões de escrita. Para alterar o local da instalação, selecione local e escolha seu local. Pressione Continuar quando terminar.

   2. Se você não teve a opção de escolher Instalar somente para mim na etapa anterior, selecione Alterar local de instalação > Instalar somente para mim e pressione Continuar.

   3. Pressione Instalar.

5. A mensagem AWS SAM CLI será instalada e A instalação foi bem-sucedida será exibida. Pressione Fechar.

Como criar um symlink

• Para invocar o AWS SAM CLI com o comando sam, você deve criar manualmente um symlink entre o programa AWS SAM CLI e o seu $PATH. Crie seu symlink modificando e executando o seguinte comando:

  $ sudo ln -s /path-to/aws-sam-cli/sam /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, sudo será obrigatório.

  • path-to — Caminho para onde você instalou o programa AWS SAM CLI. Por exemplo, /Users/myUser/Desktop.

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

Para verificar uma instalação bem-sucedida

• Verifique se o AWS SAM CLI foi instalado corretamente e se seu symlink está configurado executando:

  $ which sam
  /usr/local/bin/sam
  $ sam --version
  SAM CLI, <latest version>

Command line - All users

Para baixar e instalar a CLI do AWS SAM

nota

Se você instalou anteriormente o AWS SAM CLI por meio do Homebrew ou do pip, você precisa desinstalá-lo primeiro. Para obter instruções, consulte Desinstalando o AWS SAMCLI.

1. Baixe o pkg do macOS para um diretório de sua escolha:

   • Para Macs que executam processadores Intel, escolha x86_64 – aws-sam-cli-macos-x86_64.pkg

   • Para Macs que executam Apple Silicon, escolha arm64 – aws-sam-cli-macos-arm64.pkg

   nota

   Você tem a opção de verificar a integridade do instalador antes da instalação. Para obter instruções, consulte Opcional: verificar a integridade do instalador da CLI do AWS SAM.

2. Modifique e execute o script de instalação:

   $ sudo installer -pkg path-to-pkg-installer/name-of-pkg-installer -target /
   installer: Package name is AWS SAM CLI
   installer: Upgrading at base path /
   installer: The upgrade was successful.

   nota

   Para invocar o AWS SAM CLI com o comando sam, o instalador cria automaticamente um symlink entre /usr/local/bin/sam e /usr/local/aws-sam-cli/sam.

Para verificar uma instalação bem-sucedida

• Verifique se o AWS SAM CLI foi instalado corretamente e se seu symlink está configurado executando:

  $ which sam
  /usr/local/bin/sam
  $ sam --version
  SAM CLI, <latest version>

Command line - Current user

Para baixar e instalar a CLI do AWS SAM

nota

Se você instalou anteriormente o AWS SAM CLI por meio do Homebrew ou do pip, você precisa desinstalá-lo primeiro. Para obter instruções, consulte Desinstalando o AWS SAMCLI.

1. Baixe o pkg do macOS para um diretório de sua escolha:

   • Para Macs que executam processadores Intel, escolha x86_64 – aws-sam-cli-macos-x86_64.pkg

   • Para Macs que executam Apple Silicon, escolha arm64 – aws-sam-cli-macos-arm64.pkg

   nota

   Você tem a opção de verificar a integridade do instalador antes da instalação. Para obter instruções, consulte Opcional: verificar a integridade do instalador da CLI do AWS SAM.

2. Determine um diretório de instalação no qual você tenha permissões de escrita. Em seguida, crie um arquivo xml usando o modelo e modifique-o para refletir seu diretório de instalação. O diretório já deve existir.

   Por exemplo, se você substituir path-to-my-directory por /Users/myUser/Desktop, a pasta do programa aws-sam-cli será instalada lá.

   <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
   <plist version="1.0">
     <array>
       <dict>
         <key>choiceAttribute</key>
         <string>customLocation</string>
         <key>attributeSetting</key>
         <string>path-to-my-directory</string>
         <key>choiceIdentifier</key>
         <string>default</string>
       </dict>
     </array>
   </plist>

3. Salve o arquivo xml e verifique se ele é válido executando o seguinte:

   $ installer -pkg path-to-pkg-installer \
   -target CurrentUserHomeDirectory \
   -showChoicesAfterApplyingChangesXML path-to-your-xml-file

   A saída deve exibir as preferências que serão aplicadas ao programa AWS SAM CLI.

4. Execute o comando a seguir para instalar o AWS SAM CLI:

   $ installer -pkg path-to-pkg-installer \
   -target CurrentUserHomeDirectory \
   -applyChoiceChangesXML path-to-your-xml-file
   
   # Example output
   installer: Package name is AWS SAM CLI
   installer: choices changes file 'path-to-your-xml-file' applied
   installer: Upgrading at base path base-path-of-xml-file
   installer: The upgrade was successful.

Como criar um symlink

• Para invocar o AWS SAM CLI com o comando sam, você deve criar manualmente um symlink entre o programa AWS SAM CLI e o seu $PATH. Crie seu symlink modificando e executando o seguinte comando:

  $ sudo ln -s /path-to/aws-sam-cli/sam /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, sudo será obrigatório.

  • path-to — Caminho para onde você instalou o programa AWS SAM CLI. Por exemplo, /Users/myUser/Desktop.

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

Para verificar uma instalação bem-sucedida

• Verifique se o AWS SAM CLI foi instalado corretamente e se seu symlink está configurado executando:

  $ which sam
  /usr/local/bin/sam
  $ sam --version
  SAM CLI, <latest version>

Windows

Os arquivos do Windows Installer (MSI) são os arquivos do instalador de pacotes para o sistema operacional Windows.

Siga estas etapas para instalar o AWS SAM CLI usando o arquivo MSI.

1. Baixe a versão AWS SAM CLI de 64 bits.

2. (Opcional) Você pode verificar a integridade do instalador antes da instalação. Para obter instruções, consulte Opcional: verificar a integridade do instalador da CLI do AWS SAM.

3. Verifique a instalação.

   Depois de concluir a instalação, verifique-a abrindo um novo prompt de comando ou prompt do PowerShell. O usuário deverá ser capaz de invocar a sam partir da linha de comando.

   sam --version

   Após a instalação bem-sucedida do AWS SAM CLI, o resultado deverá ser parecido com o seguinte:

   SAM CLI, <latest version>

4. Ative caminhos longos (somente Windows 10 e versões mais recentes).

   Importante

   A CLI do AWS SAM pode interagir com caminhos de arquivo que excedam a limitação máxima de caminhos do Windows. Isso pode causar erros durante a execução de sam init devido às limitações de MAX_PATH do Windows 10. Para solucionar esse problema, o novo comportamento de caminhos longos deverá ser configurado.

   Para habilitar caminhos longos, consulte Habilitar caminhos longos no Windows 10, versão 1607 e posteriores na documentação de desenvolvimento de aplicativos do Microsoft Windows.

5. Instale o Git.

   Para baixar aplicativos de amostra usando o comando sam init, você também deve instalar o Git. Para obter instruções, consulte Instalando o Git.

Solução de problemas de erros de instalação do

Linux

Erro do Docker: “Não é possível conectar-se ao daemon do Docker. O daemon do docker está sendo executado neste host?”

Em alguns casos, para obter permissões para o ec2-user acessar o daemon do Docker, pode ser necessário reinicializar sua instância. Se você receber esse erro, tente reinicializar sua instância.

Erro de shell: “comando não encontrado”

Se você receber esse erro, seu shell não conseguirá localizar o AWS SAM CLI executável no caminho. Verifique a localização do diretório em que você instalou o AWS SAM CLI executável e, em seguida, verifique se o diretório está no seu caminho.

AWS SAMCLI erro: “/lib64/libc.so.6: versão `GLIBC_2.14' não encontrado (exigido por /usr/local/aws-sam-cli/dist/libz.so.1)”

Se você receber esse erro, você está usando uma versão incompatível do Linux e a versão glibc integrada está desatualizada. Tente um dos seguintes:

• Atualize seu host Linux para a versão de 64 bits de uma distribuição recente do CentOS, Fedora, Ubuntu ou Amazon Linux 2.

• Siga as instruções para Instale o AWS SAM CLI.

macOS

A instalação falhou

Se você estiver instalando o AWS SAM CLI para seu usuário e selecionou um diretório de instalação para o qual não tem permissões de escrita, esse erro pode ocorrer. Tente um dos seguintes:

1. Selecione um diretório de instalação diferente para o qual você tenha permissões de escrita.

2. Exclua o instalador. Em seguida, faça o download e execute-o novamente.

Próximas etapas

Para saber mais sobre o AWS SAM CLI e começar a criar os aplicativos com tecnologia sem servidor, consulte o seguinte:

• Tutorial: como implantar uma aplicação Hello World com o AWS SAM — Instruções passo a passo para baixar, criar e implantar um aplicativo com tecnologia sem servidor básico.

• O Workshop AWS SAM Completo — Um workshop projetado para ensinar a você muitos dos principais recursos que o AWS SAM oferece.

• AWS SAMexemplos de aplicativos e padrões — Exemplos de aplicativos e padrões de autores da comunidade com os quais você pode experimentar ainda mais.