Desarrollo local de funciones de Lambda con VS Code
Puede mover las funciones de Lambda de la consola de Lambda a Visual Studio Code, que brinda un entorno de desarrollo completo y le permite utilizar otras opciones de desarrollo local, como AWS SAM y AWS CDK.
Beneficios clave del desarrollo local
Si bien la consola de Lambda brinda una forma rápida de editar y probar funciones, el desarrollo local ofrece capacidades más avanzadas:
-
Características avanzadas del IDE: herramientas de depuración, finalización de código y refactorización
-
Desarrollo sin conexión: trabaje y pruebe los cambios de manera local antes de su implementación en la nube
-
Integración de la infraestructura como código: uso sin problemas con AWS SAM, AWS CDK e Infrastructure Composer
-
Administración de dependencias: control total sobre las dependencias de las funciones
Requisitos previos
Antes de desarrollar funciones de Lambda de manera local en VS Code, debe tener:
-
VS Code: para obtener instrucciones acerca de la instalación, consulte Descargar VS Code
. -
AWS Toolkit for Visual Studio Code: para obtener instrucciones acerca de la instalación, consulte Configuración de AWS Toolkit for Visual Studio Code. Para obtener una descripción general, consulte AWS Toolkit for Visual Studio Code
. -
Credenciales de AWS: para obtener información sobre cómo configurar las credenciales, consulte Configuración de las credenciales de AWS.
-
AWS SAM CLI: para obtener instrucciones acerca de la instalación, consulte Instalación de AWS SAM CLI.
-
Docker instalado (opcional, pero obligatorio para las pruebas locales): para obtener instrucciones acerca de la instalación, consulte Obtener Docker
.
nota
Si ya tiene una cuenta y un perfil de AWS configurados de manera local, asegúrese de agregar la política administrada por AdministratorAccess al perfil de AWS configurado.
Autenticación y control de acceso
Para desarrollar las funciones de Lambda de manera local, necesita credenciales de AWS para acceder y administrar los recursos de AWS de forma segura en su nombre, tal como lo harían en la nube. El Toolkit de AWS para VS Code admite los siguientes métodos de autenticación:
El Toolkit de AWS para VS Code admite los siguientes métodos de autenticación:
-
Credenciales a largo plazo de usuarios de IAM
-
Credenciales temporales de roles asumidos
-
Identidad federada
-
Credenciales de usuario raíz de la cuenta de AWS (no se recomienda)
En esta sección, se explica cómo obtener y configurar estas credenciales con las credenciales a largo plazo de los usuarios de IAM.
Obtención de credenciales de IAM
Si ya dispone de un usuario de IAM con claves de acceso, tenga el ID de clave de acceso y la clave de acceso secreta listos para la siguiente sección. Si no dispone de estas claves, siga estos pasos para crearlas:
nota
Debe utilizar el ID de clave de acceso y la clave de acceso secreta juntos, como un nombre de usuario y contraseña, para autenticar sus solicitudes.
Para crear un usuario de IAM y claves de acceso:
-
Abra la consola de IAM en https://console.aws.amazon.com/iam/
. -
En el panel de navegación, seleccione Usuarios.
-
Seleccione la opción Crear un usuario.
-
En Nombre de usuario, introduzca un nombre y elija Siguiente.
-
En Establecer permisos , elija Asociar directamente las políticas existentes.
-
Seleccione AdministratorAccess y elija Siguiente.
-
Seleccione la opción Crear un usuario.
-
En el panel de éxito, elija Ver usuario.
-
Elija Create access key (Crear clave de acceso).
-
En Caso de uso, seleccione Código local.
-
Seleccione la casilla de verificación de confirmación y elija Siguiente.
-
(Opcional) Introduzca un valor de etiqueta de descripción.
-
Elija Create access key (Crear clave de acceso).
-
Copie su clave de acceso y su clave de acceso secreta inmediatamente. No podrá volver a acceder a la clave de acceso secreta después de salir de esta página.
importante
Nunca comparta su clave secreta ni la envíe al control de código de origen. Guarde estas claves de forma segura y elimínelas cuando ya no las necesite.
nota
Para obtener más información, consulte Crear un usuario de IAM en su cuenta de AWS y Administrar las claves de acceso para los usuarios de IAM en la Guía del usuario de IAM.
Configure las credenciales de AWS mediante el Toolkit de AWS
En la siguiente tabla, se resume el proceso de configuración de credenciales que completará en el siguiente procedimiento.
| Qué hacer | ¿Por qué? |
|---|---|
| Abra el panel de inicio de sesión | Iniciar la autenticación |
| Utilice la paleta de comandos y busque Agregar una nueva conexión de AWS | Acceda a la interfaz de inicio de sesión |
| Elija la credencial de IAM | Utilice sus claves de acceso para el acceso programático |
| Introduzca el nombre del perfil, la clave de acceso y la clave secreta | Brinde las credenciales para la conexión |
| Consulte la actualización de AWS Explorer | Confirme que está conectado |
Complete los siguientes pasos para autenticarse en su cuenta de AWS:
-
Abra el panel de inicio de sesión en VS Code:
-
Para iniciar el proceso de autenticación, seleccione el icono AWS en el panel de navegación izquierdo o abra la paleta de comandos (Cmd+Shift+P en Mac o Ctrl+Shift+P en Windows/Linux) y busque y seleccione Agregar una nueva conexión de AWS.
-
-
En el panel de inicio de sesión, elija Credenciales de IAM y, a continuación, seleccione Continuar.
nota
Para continuar, deberá permitir que las extensiones del IDE de AWS para VS Code puedan acceder a sus datos.
-
Introduzca el nombre de su perfil, el ID de la clave de acceso y la clave de acceso secreta y, a continuación, seleccione Continuar.
-
Verifique la conexión consultando AWS Explorer de VS Code para ver los servicios y recursos de AWS.
Para obtener información sobre cómo configurar la autenticación con credenciales de larga duración, consulte Uso de credenciales de larga duración para autenticar los SDK y las herramientas de AWS.
Para obtener información acerca de cómo configurar la autenticación, consulte Credenciales de IAM de AWS en la Guía del usuario de AWS Toolkit for Visual Studio Code.
Paso de la consola al desarrollo local
nota
Si ha realizado cambios en la consola, asegúrese de no tener ningún cambio sin implementar antes de pasar al desarrollo local.
Para mover una función de Lambda de la consola de Lambda a VS Code, complete los siguientes pasos:
-
Abra la consola de Lambda
. -
Elija el nombre de su función.
-
Seleccione la pestaña Código fuente.
-
Elija Abrir en Visual Studio Code.
nota
El botón Abrir en Visual Studio Code solo está disponible en la versión 3.69.0 y posteriores del Toolkit de AWS. Si tiene una versión anterior del Toolkit de AWS instalada, es posible que vea un mensaje de
Cannot open the handleren VS Code. Para resolver esto, actualice su Toolkit de AWS a la última versión. -
Cuando se le solicite, permita que su navegador abra VS Code.
Al abrir la función en VS Code, Lambda crea un proyecto local con el código de la función en una ubicación temporal diseñada para realizar pruebas e implementaciones rápidas. Esto incluye el código de la función, las dependencias y una estructura de proyecto básica que puede utilizar para el desarrollo local.
Para obtener más información sobre el uso de AWS en VS Code, consulte la Guía del usuario de AWS Toolkit for Visual Studio Code.
Trabajo con funciones de forma local
Después de abrir su función en VS Code, siga estos pasos para acceder y administrar sus funciones:
-
Seleccione el icono de AWS en la barra lateral para abrir AWS Explorer:
-
En AWS Explorer, seleccione la región con la función de Lambda:
-
En la región seleccionada, expanda la sección Lambda para ver y administrar sus funciones:
Con la función abierta en VS Code, puede:
-
Editar el código de la función con soporte lingüístico completo y compleción de código.
-
Probar la función de forma local mediante el Toolkit de AWS.
-
Depurar su función con puntos de interrupción e inspección de variables.
-
Volver a implementar la función actualizada en AWS utilizando el icono de la nube.
-
Instalar y administrar las dependencias para su función.
Para obtener más información, consulte Trabajar con funciones de Lambda de AWS en la Guía del usuario de AWS Toolkit for Visual Studio Code.
Convierta su función en una plantilla de AWS SAM y utilice las herramientas de IaC
En VS Code, puede convertir la función de Lambda en una plantilla de AWS SAM al elegir el icono Convertir en aplicación de AWS SAM situado junto a la función de Lambda. Se le pedirá que seleccione una ubicación para el proyecto de AWS SAM. Una vez seleccionada, la función de Lambda se convertirá en un archivo template.yaml que se guardará en el nuevo proyecto de AWS SAM.
Con la función convertida en una plantilla de AWS SAM, puede:
Controlar el control de versiones de su infraestructura
Automatizar las implementaciones
Depurar de forma remota las funciones
Agregar recursos adicionales de AWS a la aplicación
Mantener entornos coherentes durante todo su ciclo de vida de desarrollo
Utilizar Infrastructure Composer para editar visualmente la plantilla de AWS SAM
Para obtener más información sobre el uso de herramientas de IaC, consulte las siguientes guías:
Estas herramientas brindan capacidades adicionales para definir, probar e implementar sus aplicaciones sin servidor.
Pasos a seguir a continuación
Para obtener más información acerca del trabajo con funciones de Lambda en VS Code, consulte los siguientes recursos:
-
Trabajar con funciones de Lambda de AWS en la Guía del usuario de Toolkit de AWS para VS Code
-
Trabajar con aplicaciones sin servidor en la Guía del usuario de Toolkit de AWS para VS Code
-
La infraestructura como código en la Guía para desarrolladores de Lambda
