Desenvolver funções do Lambda localmente com o VS Code
Você pode mover suas funções do Lambda do console Lambda para o Visual Studio Code, que fornece um ambiente de desenvolvimento completo e permite que você use outras opções de desenvolvimento local, como AWS SAM e AWS CDK.
Principais benefícios do desenvolvimento local
Embora o console do Lambda forneça uma maneira rápida de editar e testar funções, o desenvolvimento local oferece recursos mais avançados:
-
Atributos avançados do IDE: ferramentas de depuração, preenchimento de código e refatoração
-
Desenvolvimento off-line: trabalhe e teste as mudanças localmente antes da implantação na nuvem
-
Infraestrutura como integração de código: uso contínuo com AWS SAM, AWS CDK e Infrastructure Composer
-
Gerenciamento de dependências: controle total sobre as dependências de funções
Pré-requisitos
Antes de desenvolver as funções do Lambda localmente no VS Code, você deve ter:
-
VS Code: para obter instruções de instalação, consulte Baixar o VS Code
. -
AWS Toolkit for Visual Studio Code: Para obter as instruções de instalação, consulte Como configurar o AWS Toolkit for Visual Studio Code. Para obter uma visão geral, consulte AWS Toolkit for Visual Studio Code
. -
Credenciais da AWS: para obter informações sobre como configurar as credenciais, consulte Como configurar suas credenciais da AWS.
-
AWS SAM CLI: Para obter instruções de instalação, consulte Como instalar a CLI no AWS SAM.
-
Docker instalado (opcional, mas obrigatório para testes locais): para obter instruções de instalação, consulte Baixar o Docker
.
nota
Se você já tiver uma conta da AWS e um perfil configurados localmente, certifique-se de que a política gerenciada do AdministratorAccess seja adicionada ao seu perfil configurado da AWS.
Autenticação e controle de acesso
Para desenvolver as funções do Lambda localmente, você precisa de credenciais da AWS para acessar e gerenciar os recursos da AWS com segurança em seu nome, assim como fariam na nuvem. O kit de ferramentas da AWS para VS Code é compatível com os seguintes métodos de autenticação:
O kit de ferramentas da AWS para VS Code é compatível com os seguintes métodos de autenticação:
-
Credenciais de longo prazo para usuários do IAM
-
Credenciais temporárias de funções assumidas
-
Federação de identidades
-
Credenciais da AWS de usuário-raiz da conta (não recomendado)
Esta seção orienta você na obtenção e configuração dessas credenciais usando as credenciais de longo prazo do usuário do IAM.
Obter credenciais do IAM
Se você já tiver um usuário do IAM com chaves de acesso, tenha o ID da chave de acesso e a chave de acesso secreta prontos para a próxima seção. Se você não tiver essas chaves, siga estas etapas para criá-las:
nota
Você deve usar o ID da chave de acesso e a chave de acesso secreta em conjunto para autenticar suas solicitações.
Para criar um usuário do IAM e chaves de acesso:
-
Abra o console do IAM em https://console.aws.amazon.com/iam/
-
No painel de navegação, escolha Users.
-
Selecione Criar usuário.
-
Em Nome do usuário, insira um nome e clique em Avançar.
-
Em Definir permissões, selecione Anexar políticas existentes.
-
Selecione AdministratorAccess e clique em Avançar.
-
Selecione Criar usuário.
-
No banner de sucesso, clique em Exibir usuário.
-
Selecione Create access key (Criar chave de acesso).
-
Em Caso de uso, selecione Código local.
-
Marque a caixa de seleção de confirmação e clique em Avançar.
-
(Opcional) Insira um valor para a tag de descrição.
-
Selecione Create access key (Criar chave de acesso).
-
Copie sua chave de acesso e chave de acesso secreta imediatamente. Você não poderá acessar a chave de acesso secreta novamente após sair desta página.
Importante
Nunca compartilhe sua chave secreta nem a comprometa com o controle de versão. Armazene essas chaves com segurança e exclua-as quando não forem mais necessárias.
nota
Para obter mais informações, consulte Criar um usuário do IAM na sua conta da AWS e Gerenciar chaves de acesso de usuários do IAM no Guia do usuário do IAM.
Configurar credenciais da AWS usando o AWS Toolkit
A tabela a seguir resume o processo de configuração de credenciais que você concluirá no procedimento a seguir.
| O que fazer | Por quê? |
|---|---|
| Abra o painel de login | Iniciar a autenticação |
| Use a Paleta de Comandos, pesquise Adicionar uma nova conexão da AWS | Acesse a UI de login |
| Escolha a credencial do IAM | Use suas chaves de acesso para acesso programático |
| Digite o nome do perfil, chave de acesso, chave secreta | Forneça as credenciais para conexão |
| Veja a atualizar o AWS Explorer | Confirme que você está conectado |
Conclua as etapas a seguir para autenticar-se em sua conta da AWS:
-
Abra o painel de login no VS Code:
-
Para iniciar o processo de autenticação, clique no ícone da AWS no painel de navegação esquerdo ou abra a Paleta de Comandos (Cmd+Shift+P no Mac ou Ctrl+Shift+P no Windows/Linux) e pesquise e selecione Adicionar uma nova conexão da AWS.
-
-
No painel de login, escolha Credenciais do IAM e clique em Continuar.
nota
Para continuar, você precisará permitir que as extensões do IDE da AWS para VS Code acessem seus dados.
-
Insira seu nome de perfil, ID da chave de acesso e chave de acesso secreta e clique em Continuar.
-
Verifique a conexão ao marcar o AWS Explorer no VS Code para serviços e recursos da AWS.
Para obter informações sobre como configurar a autenticação com credenciais de longo prazo, consulte Como usar credenciais de longo prazo para autenticar SDKs e ferramentas da AWS.
Para obter informações sobre como configurar a autenticação, consulte credenciais do AWS IAM no Guia do usuário do AWS Toolkit for Visual Studio Code.
Mova do console para o desenvolvimento local
nota
Se você fez alterações no console, verifique se não há nenhuma alteração não implantada antes de fazer a transição para o desenvolvimento local.
Para mover uma função do Lambda do console do Lambda para o VS Code, conclua as etapas a seguir:
-
Abra o console do lambda
. -
Escolha o nome da sua função.
-
Selecione a guia Fonte do código.
-
Escolha Abrir no Visual Studio Code.
nota
O botão Abrir no Visual Studio Code só está disponível no AWSToolkit versão 3.69.0 e posterior. Se você tiver uma versão anterior do AWS Toolkit instalada, poderá ver uma mensagem
Cannot open the handlerno VS Code. Para resolver isso, atualize seu AWS Toolkit para a versão mais recente. -
Quando solicitado, permita que seu navegador abra o VS Code.
Quando você abre sua função no VS Code, o Lambda cria um projeto local com seu código de função em um local temporário projetado para testes e implantação rápidos. Isso inclui o código da função, dependências e uma estrutura básica do projeto que você pode usar para o desenvolvimento local.
Para obter detalhes sobre o uso da AWS no VS Code, consulte o Guia do usuário do AWS Toolkit for Visual Studio Code.
Trabalhe com funções localmente
Depois de abrir sua função no VS Code, siga estas etapas para acessar e gerenciar suas funções:
-
Clique no ícone da AWS na barra lateral para abrir o AWS Explorer:
-
No AWS Explorer, selecione a região com sua função do Lambda:
-
Na região selecionada, expanda a seção Lambda para visualizar e gerenciar suas funções:
Com sua função aberta no VS Code, você pode:
-
Editar o código da função com suporte completo ao idioma e preenchimento de código.
-
Testar sua função localmente usando o AWS Toolkit.
-
Depurar sua função com pontos de interrupção e inspeção de variáveis.
-
Implantar sua função atualizada novamente para a AWS usando o ícone da nuvem.
-
Instalar e gerenciar dependências para sua função.
Para obter mais informações, consulte Como trabalhar com as funções do AWS Lambda no Guia do usuário do AWS Toolkit for Visual Studio Code.
Converta sua função em um modelo de AWS SAM e use as ferramentas de IaC
No VS Code, você pode converter sua função do Lambda em um modelo de AWS SAM escolhendo o ícone Converter em aplicação do AWS SAM ao lado de sua função Lambda. Será solicitado que você selecione um local para o projeto do AWS SAM. Depois de selecionada, sua função do Lambda será convertida em um arquivo template.yaml salvo em seu novo projeto do AWS SAM.
Com sua função convertida em um modelo do AWS SAM, você pode:
Controlar o versionamento de sua infraestrutura
Automatizar implantações
Depurar funções remotamente
Adicionar mais recursos da AWS para sua aplicação
Mantenha ambientes consistentes em todo o seu ciclo de vida de desenvolvimento
Use o Compositor de Infraestrutura para editar visualmente seu modelo do AWS SAM
Para obter mais informações sobre o uso de ferramentas de IaC, consulte os seguintes guias:
Essas ferramentas fornecem recursos adicionais para definir, testar e implantar suas aplicações com tecnologia sem servidor.
Próximas etapas
Para saber mais sobre como trabalhar com funções do Lambda no VS Code, consulte os seguintes recursos:
-
Como trabalhar com funções do AWS Lambda no Guia do usuário do AWS Toolkit para VS Code
-
Como trabalhar com aplicações com tecnologia sem servidor no Guia do usuário do AWS Toolkit para VS Code
-
Infraestrutura como código no Guia do desenvolvedor do Lambda
