View a markdown version of this page

Trabajando con AWS Lambda Funciones - AWS Kit de herramientas para VS Code

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Trabajando con AWS Lambda Funciones

AWS Toolkit for Visual Studio Code Le permite trabajar con sus AWS Lambda funciones en su entorno local de VS Code. Con el AWS kit de herramientas, puede crear, editar, probar, depurar e implementar sus funciones de Lambda sin tener que salir del IDE. Para obtener información detallada sobre el AWS Lambda servicio, consulte la AWS Lambda Guía para desarrolladores.

En las secciones siguientes se describe cómo empezar a trabajar con funciones de Lambda en el AWS Toolkit for Visual Studio Code.

nota

Si ya ha creado funciones de Lambda mediante el Consola de administración de AWS, puede invocarlas desde el kit de herramientas. Además, puede abrir sus funciones de Lambda en VS Code desde AWS Lambda console, para obtener información adicional, consulte el AWS Lambda console a IDE tema de esta guía del usuario. Para crear una nueva función de Lambda en VS Code, siga los pasos que se describen en el tema Creación de una nueva aplicación sin servidor (local) de esta Guía del usuario.

Requisitos previos

Se deben cumplir las siguientes condiciones para trabajar con el AWS Lambda servicio del AWS kit de herramientas.

  • La versión más reciente del AWS Toolkit for Visual Studio Code está instalada y configurada con sus AWS credenciales.

  • Sus políticas y permisos gestionados AWS Identity and Access Management (IAM) están configurados para funcionar con el AWS Lambda servicio. Para obtener información detallada sobre cómo configurar tus permisos y crear una política AWS gestionada compatible, consulta el AWS Lambda tema AWS Identity and Access Management correspondiente en la Guía para AWS Lambda desarrolladores.

  • Ya tiene AWS Lambda funciones o está familiarizado con la creación de una. Para obtener instrucciones sobre cómo crear una función de Lambda, consulte el tema Creación de su primera función de Lambda de la Guía para desarrolladores de AWS Lambda .

Invocación de una función de Lambda

Para invocar una función de Lambda desde su AWS cuenta a VS Code, complete los siguientes pasos.

  1. Desde AWS Toolkit for Visual Studio Code, expanda el AWS explorador.

  2. Desde el AWS explorador, expanda Lambda para ver sus recursos de Lambda.

  3. Abra el menú contextual (clic con el botón derecho) de la función de Lambda que desee invocar y, a continuación, elija Invocar en la nube o el icono Invocar en la nube para abrir el menú Remote invoke configuration en VS Code.

  4. En el menú Remote invoke configuration, especifique la configuración de Payload y agregue la información adicional que sea necesaria para el evento.

    nota

    El primer proceso de invocación puede empezar a ejecutarse tan pronto como elija Invocar en la nube en el explorador. AWS El resultado se muestra en la pestaña OUTPUT del terminal de VS Code.

  5. Elija el botón Remote Invoke para invocar la función. El resultado se muestra en la pestaña OUTPUT del terminal de VS Code.

Eliminación de una función de Lambda

Para eliminar una función de Lambda, realice el procedimiento siguiente.

aviso

No utilice este procedimiento para eliminar las funciones de Lambda asociadas a CloudFormation. Estas funciones deben eliminarse a través de la pila de CloudFormation .

  1. Desde el AWS Toolkit for Visual Studio Code, expanda el AWS explorador.

  2. Desde el AWS explorador, expanda Lambda para ver sus recursos de Lambda.

  3. Right-click la función de Lambda que desea eliminar y, a continuación, seleccione Eliminar.

  4. Cuando se le solicite, confirme que desea eliminar la función.

Una vez eliminada la función, ya no aparece en el AWS explorador.

Descarga de una función de Lambda

Puede descargar código de una función de Lambda remota en su espacio de trabajo de VS Code para editarlo y depurarlo.

nota

Para descargar la función de Lambda, debe trabajar en un espacio de trabajo de VS Code con una carpeta accesible y el AWS kit de herramientas solo admite esta función con funciones de Lambda que utilicen funciones de Lambda Node.js y en tiempos de ejecución de Python.

  1. Desde, expanda el AWS Toolkit for Visual Studio Code explorador. AWS

  2. Desde el AWS explorador, expanda Lambda para ver sus recursos de Lambda.

  3. Right-click la función de Lambda que desea descargar y, a continuación, seleccione Descargar.

  4. La función Lambda se abre en el editor de VS Code y se muestra en el AWS explorador cuando se completa la descarga. El AWS kit de herramientas también crea una configuración de lanzamiento en el panel de ejecución de VS Code que le permite ejecutar y depurar la función Lambda localmente con ella. AWS Serverless Application Model Para obtener más información sobre su uso AWS SAM, consulte. Ejecutar y depurar una aplicación sin servidor desde una plantilla (local)

Implementación de actualizaciones para nuevas funciones de Lambda

Puede implementar actualizaciones en las nuevas funciones de Lambda desde una ubicación temporal no especificada de su máquina local.

nota

Cuando haya cambios sin implementar en sus archivos de Lambda, recibirá una notificación mediante el icono M ubicado junto a los archivos modificados en el editor de VS Code y en el Explorador de AWS .

Implementación desde el editor de VS Code
  1. Abra uno de los archivos de su función de Lambda en el editor de VS Code y, a continuación, realice un cambio en el archivo.

  2. Guárdelo de forma manual desde el menú principal de VS Code, o bien pulse option+s (Mac) o ctrl+s (Windows).

  3. VS Code le pregunta de forma automática si desea implementar los cambios en la nube. Elija el botón Implementar para confirmar la implementación.

  4. VS Code le informa sobre el estado de la implementación y le envía una notificación una vez completado el proceso.

Desplegando desde el AWS Explorer
  1. Abra uno de los archivos de su función de Lambda en el editor de VS Code y, a continuación, realice un cambio en el archivo.

  2. Desde el AWS kit de herramientas, expanda el AWS explorador.

  3. Desde el AWS explorador, expanda la AWS región con la función Lambda para la que desea implementar los cambios.

  4. Desde la AWS región, expanda Lambda y navegue por la función para la que quiere implementar los cambios.

  5. En el menú rápido situado junto a la función, elija el icono Guardar e implementar el código.

  6. VS Code le informa sobre el estado de la implementación y le envía una notificación una vez completado el proceso.

Carga de actualizaciones para las funciones de Lambda existentes

En los procedimientos siguientes se describe cómo cargar los cambios locales realizados en las funciones de Lambda existentes. Esta característica admite cargas con cualquier tiempo de ejecución compatible con Lambda.

aviso

Antes de cargar la función de Lambda, tenga en cuenta lo siguiente:

  • Al actualizar el código de esta manera, no se usa la AWS SAM CLI para la implementación ni se crea una pila CloudFormation

  • El AWS kit de herramientas no valida el código. Valide el código y pruebe las funciones antes de cargar los cambios en la nube.

Carga de un archivo Zip
  1. Desde AWS Toolkit for Visual Studio Code, expanda el AWS explorador.

  2. Desde el AWS explorador, expanda Lambda para ver sus recursos de Lambda.

  3. Right-click la función Lambda a la que desea cargar los cambios y, a continuación, seleccione Cargar Lambda... para abrir el menú Seleccionar tipo de carga.

  4. Elija Archivo ZIP para localizar el ZIP Archive en el directorio local.

  5. Cuando se le solicite, confirme la carga para iniciar la carga del ZIP Archive seleccionado.

  6. El estado de la carga se muestra en VS Code y recibirá una notificación una vez completado el proceso de carga.

Carga de un directorio sin compilación
  1. Desde AWS Toolkit for Visual Studio Code, expande el AWS explorador.

  2. Desde el AWS explorador, expanda Lambda para ver sus recursos de Lambda.

  3. Right-click la función Lambda a la que desea cargar los cambios y, a continuación, seleccione Cargar Lambda... para abrir el menú Seleccionar tipo de carga.

  4. Elija Directorio para ir a la pantalla Directorio de compilación.

  5. En la pantalla Directorio de compilación, seleccione No con el fin de elegir un directorio local para la carga.

  6. Cuando se le solicite, confirme la carga para cargar el directorio seleccionado.

  7. El estado de la carga se muestra en VS Code y recibirá una notificación una vez completado el proceso de carga.

Carga de un directorio con una compilación
nota

Tenga en cuenta lo siguiente:

  • Este procedimiento requiere la AWS Serverless Application Model CLI.

  • El AWS kit de herramientas le notifica que no se puede detectar ningún controlador coincidente antes de cargarlo.

  • Para cambiar el controlador adjunto a la función de Lambda, utilice el o el. AWS Lambda console AWS Command Line Interface

  1. Desde AWS Toolkit for Visual Studio Code, expanda el AWS explorador.

  2. Desde el AWS explorador, expanda Lambda para ver sus recursos de Lambda.

  3. Right-click la función Lambda a la que desea cargar los cambios y, a continuación, seleccione Cargar Lambda... para abrir el menú Seleccionar tipo de carga.

  4. Elija Directorio para ir a la pantalla Directorio de compilación.

  5. En la pantalla Directorio de compilación, elija Sí y, a continuación, seleccione un directorio local para la carga.

  6. Cuando se le solicite, confirme la carga para empezar a compilar y cargar el directorio seleccionado.

  7. El estado de la carga se muestra en VS Code y recibirá una notificación una vez completado el proceso de carga.

Convertir la función de Lambda en una AWS SAM proyecto

Para convertir la función de Lambda en una AWS SAM pila, complete los pasos siguientes.

aviso

Actualmente, solo se admite un subconjunto de recursos al convertir una función de Lambda en un proyecto de AWS SAM . Para localizar los recursos que faltan después de una conversión, consulta la consola de Lambda y agrégalos manualmente a la plantilla AWS SAM . Para obtener más detalles sobre los recursos compatibles y no compatibles, consulte el tema Tipo de recurso compatible de la Guía para desarrolladores de AWS CloudFormation .

  1. Desde el AWS kit de herramientas, expanda el AWS explorador.

  2. Desde el AWS explorador, expanda la AWS región con la función Lambda que desea convertir en un AWS SAM proyecto.

  3. Desde la AWS región, expanda Lambda y navegue por la función que desea convertir en una AWS SAM pila.

  4. En el menú rápido situado junto a la función de Lambda, elija el icono Convertir a aplicación de SAM a fin de navegar por el sistema de archivos local y especificar una ubicación para el nuevo proyecto de AWS SAM .

  5. Después de especificar la ubicación en la que el AWS kit de herramientas comienza a convertir la función de Lambda en un AWS SAM proyecto, VS Code proporciona actualizaciones sobre el estado del proceso.

    nota

    Este proceso puede demorar unos minutos.

  6. Cuando se lo solicite VS Code, ingrese un nombre de pila y, a continuación, presione la tecla Enter para continuar.

  7. VS Code continúa actualizándolo con el estado de su proyecto, luego le notifica cuando el proceso se ha completado y abre su nuevo AWS SAM proyecto como un espacio de trabajo de VS Code.