Instalando o AWS SAM CLI - AWS Serverless Application Model
Instalando o AWS SAM CLISolução de problemasPróximas etapas

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

Instalando o AWS SAM CLI

Instale a versão mais recente da interface de linha de AWS Serverless Application Model comando (AWS SAMCLI) nos sistemas operacionais compatíveis.

Para obter informações sobre como gerenciar uma versão atualmente instalada do AWS SAMCLI, 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. Inscrevendo-se em uma AWS conta.

  2. Como criar um usuário do IAM administrativo.

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

  4. Instalando AWS CLIo.

  5. Configurando AWS credenciais.

Instalando o AWS SAM CLI

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). Se você usa 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 instalar o AWS SAMCLI, siga as instruções do seu sistema operacional.

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 Verifique a integridade do instalador do AWS SAM CLI.

  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 SAMCLI 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 bem-sucedida, você deve ver uma saída como a seguinte, mas que substitui o texto entre colchetes pela versão mais recente do SAM CLI:

     SAM CLI, <latest version>
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 Verifique a integridade do instalador do AWS SAM CLI.

  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 SAMCLI 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 bem-sucedida, você deve ver uma saída que substitui o seguinte texto entre colchetes pela versão mais recente disponível:

     SAM CLI, <latest version>

Instale o AWS SAM CLI usando o instalador de pacotes.

nota

O instalador de pacotes está disponível nas opções x86_64 e arm64. Escolha o pacote que corresponde ao seu hardware Mac:

  • x86_64 — Use para executar Macs processadores Intel.

  • arm64 — Use para executar Macs chip Apple.

Para obter mais informações, consulte Computadores Mac com chip Apple.

Como usar o instalador de pacotes

O instalador do pacote tem dois métodos de instalação que você pode escolher:

  1. GUI

  2. Linha de comando

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.

Etapas de instalação

Instale o AWS SAM CLI usando qualquer uma das opções a seguir.

GUI - All users
Para fazer download do instalador do pacote
nota

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

Para verificar o instalador do pacote (opcional)
Para instalar o AWS SAM CLI

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

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

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

    nota

    Para invocar o AWS SAMCLI 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.

  4. A mensagem AWS SAMCLI 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 fazer download do instalador do pacote
nota

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

Para verificar o instalador do pacote (opcional)
Para instalar o AWS SAM CLI

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

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

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

    1. Escolha onde o AWS SAMCLI 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.

  4. A mensagem AWS SAMCLI será instalada e A instalação foi bem-sucedida será exibida. Pressione Fechar.

Como criar um symlink

  • Para invocar o AWS SAMCLI com o comando sam, você deve criar manualmente um symlink entre o programa AWS SAMCLI 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 SAMCLI. Por exemplo, /Users/myUser/Desktop.

    • path-to-symlink-directory— Sua variável de $PATH ambiente. 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 fazer download do instalador do pacote
nota

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

Para verificar o instalador do pacote (opcional)
Para instalar o AWS SAM CLI

  • 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 SAMCLI 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 fazer download do instalador do pacote
nota

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

Para verificar o instalador do pacote (opcional)
Para instalar o AWS SAM CLI

  1. 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ê path-to-my-directorysubstituir por/Users/myUser/Desktop, a pasta do aws-sam-cli programa 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>

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

  3. Execute o seguinte para instalar o AWS SAMCLI: 

    $ 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 SAMCLI com o comando sam, você deve criar manualmente um symlink entre o programa AWS SAMCLI 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 SAMCLI. Por exemplo, /Users/myUser/Desktop.

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

Para verificar uma instalação bem-sucedida

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

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

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 SAMCLI usando o arquivo MSI.

  1. Baixe a versão AWS SAMCLI de 64 bits.

    nota

    Se você usa uma versão de 32 bits do Windows, consulte Instalando o AWS SAMCLI de 32 bits Windows.

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

  3. Verifique a instalação.

    Depois de concluir a instalação, verifique-a abrindo um novo prompt de comando ou PowerShell prompt. 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 SAMCLI, você deverá ver uma saída como a seguinte:

    SAM CLI, <latest version>

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

    Importante

    Eles AWS SAMCLI podem interagir com caminhos de arquivo que excedam a limitação máxima de caminhos do Windows. Isso pode causar erros durante a execução sam init devido às MAX_PATH limitações 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

Se você encontrar problemas ao instalar o AWS SAMCLI, consulteErros de instalação.

Próximas etapas

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