AWS SAM pré-requisitos

Preencha os pré-requisitos a seguir antes de instalar e usar a interface de linha de AWS Serverless Application Model comando ().AWS SAMCLI

Para usar o AWS SAMCLI, você precisa do seguinte:

• Uma AWS conta, credenciais AWS Identity and Access Management (IAM) e um par de chaves de acesso do IAM.

• O AWS Command Line Interface (AWS CLI) para configurar as AWS credenciais.

Etapa 1: inscrever-se em uma AWS conta

Se você não tiver um Conta da AWS, conclua as etapas a seguir para criar um.

Para se inscrever em um Conta da AWS

1. Abra a https://portal.aws.amazon.com/billing/inscrição.

2. Siga as instruções online.

   Parte do procedimento de inscrição envolve receber uma chamada telefônica ou uma mensagem de texto e inserir um código de verificação pelo teclado do telefone.

   Quando você se inscreve em um Conta da AWS, um Usuário raiz da conta da AWSé criado. O usuário-raiz tem acesso a todos os Serviços da AWS e recursos na conta. Como prática recomendada de segurança, atribua o acesso administrativo a um usuário e use somente o usuário-raiz para executar tarefas que exigem acesso de usuário-raiz.

Etapa 2: criar uma conta de usuário do IAM

Para criar um usuário administrador, selecione uma das opções a seguir.

Selecionar uma forma de gerenciar o administrador	Para	Por	Você também pode
Centro de Identidade do IAM (Recomendado)	Usar credenciais de curto prazo para acessar a AWS. Isso está de acordo com as práticas recomendadas de segurança. Para obter informações sobre as práticas recomendadas, consulte Práticas recomendadas de segurança no IAM no Guia do usuário do IAM.	Seguindo as instruções em Conceitos básicos no Guia do usuário do AWS IAM Identity Center .	Configure o acesso programático configurando o AWS CLI para uso AWS IAM Identity Center no Guia do AWS Command Line Interface usuário.
No IAM (Não recomendado)	Usar credenciais de longo prazo para acessar a AWS.	Seguindo as instruções em Criar um acesso de emergência para um usuário do IAM no Guia do usuário do IAM.	Configurar o acesso programático, com base em Gerenciar chaves de acesso para usuários do IAM no Guia do usuário do IAM.

Etapa 3: criar um ID de chave de acesso e a chave de acesso secreta

Para acesso à CLI, é necessário ter um ID de chave de acesso e de uma chave de acesso secreta. Use credenciais temporárias em vez de chaves de acesso de longo prazo quando possível. As credenciais temporárias incluem um ID de acesso, uma chave de acesso secreta e um token de segurança que indica quando as credenciais expiram. Para obter mais informações, consulte Uso de credenciais temporárias com AWS recursos no Guia do usuário do IAM.

Os usuários precisam de acesso programático se quiserem interagir com pessoas AWS fora do AWS Management Console. A forma de conceder acesso programático depende do tipo de usuário que está acessando AWS.

Para conceder acesso programático aos usuários, selecione uma das seguintes opções:

Qual usuário precisa de acesso programático?	Para	Por
Identidade da força de trabalho (Usuários gerenciados no Centro de Identidade do IAM)	Use credenciais temporárias para assinar solicitações programáticas para o AWS CLI AWS SDKs, ou. AWS APIs	Siga as instruções da interface que deseja utilizar. Para o AWS CLI, consulte Configurando o AWS CLI para uso AWS IAM Identity Center no Guia do AWS Command Line Interface usuário. Para AWS SDKs, ferramentas e AWS APIs, consulte a autenticação do IAM Identity Center no Guia de referência de ferramentas AWS SDKs e ferramentas.
IAM	Use credenciais temporárias para assinar solicitações programáticas para o AWS CLI AWS SDKs, ou. AWS APIs	Siga as instruções em Como usar credenciais temporárias com AWS recursos no Guia do usuário do IAM.
IAM	(Não recomendado) Use credenciais de longo prazo para assinar solicitações programáticas para o AWS CLI, AWS SDKs, ou. AWS APIs	Siga as instruções da interface que deseja utilizar. Para isso AWS CLI, consulte Autenticação usando credenciais de usuário do IAM no Guia do AWS Command Line Interface usuário. Para ferramentas AWS SDKs e ferramentas, consulte Autenticar usando credenciais de longo prazo no Guia de referência de ferramentas AWS SDKs e ferramentas. Para isso AWS APIs, consulte Gerenciamento de chaves de acesso para usuários do IAM no Guia do usuário do IAM.

Etapa 4: instalar o AWS CLI

AWS CLI É uma ferramenta de código aberto que permite que você interaja com o Serviços da AWS uso de comandos em seu shell de linha de comando. AWS SAMCLIIsso requer o AWS CLI para atividades como a configuração de credenciais. Para saber mais sobre o AWS CLI, consulte O que é o AWS Command Line Interface? no Guia do AWS Command Line Interface usuário.

Para instalar o AWS CLI, consulte Instalando ou atualizando a versão mais recente do AWS CLI no Guia AWS Command Line Interface do Usuário.

Etapa 5: use o AWS CLI para configurar as AWS credenciais

Para configurar credenciais com o IAM Identity Center

• Para configurar credenciais com o IAM Identity Center, consulte Configurar seu perfil com o assistente de AWS configuração de sso.

Para configurar credenciais com o AWS CLI

1. Execute o comando aws configure da linha de comando.

2. Configure as definições a seguir. Selecione cada um dos links para saber mais:

   1. ID da chave de acesso

   2. Chave de acesso secreta

   3. Região da AWS

   4. Formato da saída

   O exemplo a seguir mostra valores de exemplo.

   $ aws configure
   AWS Access Key ID [None]: AKIAIOSFODNN7EXAMPLE
   AWS Secret Access Key [None]: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
   Default region name [None]: us-west-2
   Default output format [None]: json

O AWS CLI armazena essas informações em um perfil (uma coleção de configurações) nomeado default nos config arquivos credentials e. Esses arquivos estão localizados no arquivo .aws em seu diretório inicial. Por padrão, as informações desse perfil são usadas quando você executa um AWS CLI comando que não especifica explicitamente um perfil a ser usado. Para obter mais informações sobre o arquivo credentials, consulte Configurações de arquivos de configuração e credenciais no Guia do usuário do AWS Command Line Interface .

Para obter mais informações sobre como configurar credenciais, como usar uma configuração existente e um arquivo de credenciais, consulte Configuração rápida no Guia do usuário do AWS Command Line Interface .

Etapa 6: (opcional) instalar o AWS kit de ferramentas para VS Code

Para desenvolvedores que preferem um ambiente de desenvolvimento integrado, o AWS Toolkit for VS Code fornece recursos poderosos para o desenvolvimento sem servidor, incluindo depuração visualCodeLens , integração e fluxos de trabalho de implantação simplificados.

Pré-requisitos para o desenvolvimento do VS Code

• Visual Studio Code (versão 1.73.0 ou posterior) instalado em seu sistema

• Extensão de suporte à linguagem YAML para VS Code

Para instalar o AWS Toolkit for VS Code

1. Abra o Visual Studio Code

2. Abra a visualização de extensões (Ctrl+Shift+X ou Cmd+Shift+X)

3. Pesquise por "AWS Toolkit”

4. Instale a extensão “AWS Toolkit” da Amazon Web Services

5. Instale a extensão “YAML” da Red Hat (necessária para os CodeLens recursos do modelo SAM)

Benefícios de usar o VS Code com AWS SAM

• Depuração visual: defina pontos de interrupção e execute suas funções do Lambda localmente

• CodeLens integração: crie, implante e invoque funções diretamente do seu modelo SAM

• Terminal integrado: acesse AWS CLI os comandos do AWS SAM sem sair do editor

• Validação de modelo: validação em tempo real e IntelliSense para modelos de SAM

Para obter informações sobre como configurar suas AWS credenciais no VS Code, consulte Configuração de credenciais no Guia do usuário do AWS Toolkit for VS Code.

Próximas etapas

• Agora você está pronto para instalar o AWS SAMCLI e começar a usar AWS SAM. Para instalar o AWS SAMCLI, consulteInstale o AWS SAM CLI.

• Para configurar o Visual Studio Code para desenvolvimento sem servidor, consulte Configurando o AWS Toolkit for VS Code.