Uso de AWS SAM con AWS Toolkit

1. En el Explorador de AWS, haga clic con el botón derecho en el nodo Lambda y, a continuación, elija Create Lambda SAM Application (Crear aplicación de SAM de Lambda).

   nota

   También puede seleccionar el icono de menú situado en el encabezado del Explorador de AWS y elegir Create Lambda SAM Application (Crear aplicación de SAM de Lambda).

2. Elija el tiempo de ejecución para su aplicación de SAM. Para este ejemplo, elija nodejs12.x.

   nota

   Si selecciona uno de los tiempos de ejecución con "(Imagen)", su aplicación es el tipo de paquete Image. Si selecciona uno de los tiempos de ejecución sin "(Imagen)", su aplicación es el tipo Zip. Para obtener más información acerca de la diferencia entre los tipos de paquetes Image y Zip, consulte Paquetes de implementación de Lambda en la Guía para desarrolladores de AWS Lambda.

3. Elija una de las siguientes plantillas para la aplicación sin servidor:

   • AWS SAM Hello World: plantilla básica con una función de Lambda que devuelve el clásico mensaje “Hola, mundo”.

   • Aplicación de muestra AWS Step Functions: aplicación de muestra que ejecuta un flujo de trabajo bursátil. Step Functions orquesta las interacciones de las funciones de Lambda que están involucradas.

4. Elija una ubicación para el nuevo proyecto. Si hay una disponible, puede seleccionar una carpeta de espacio de trabajo existente. De lo contrario, busque otra carpeta. Si elige Select a different folder (Seleccionar una carpeta diferente), aparece un cuadro de diálogo donde puede seleccionar una ubicación de carpeta.

5. Ingrese un nombre para su nueva aplicación. Para este ejemplo, use my-sam-app-nodejs. Después de pulsar Intro, AWS Toolkit tarda unos momentos en crear el proyecto.

Para utilizar una plantilla de SAM para ejecutar y depurar una aplicación sin servidor

1. Para ver los archivos de aplicación que componen la aplicación sin servidor, vaya a la ventana Environment (Entorno).

2. En la carpeta de la aplicación (por ejemplo, my-sample-app), abra el archivo template.yaml.

3. Para template.yaml, seleccione Edit Launch Configuration (Editar configuración de lanzamiento).

   Un nuevo editor muestra el archivo launch.json que proporciona una configuración de depuración con atributos predeterminados.

4. Edite o confirme los valores de las siguientes propiedades de configuración:

   • "name": ingrese un nombre fácil de leer para que aparezca en el campo desplegable Configuration (Configuración) de la vista Run (Ejecución).

   • "target": asegúrese de que el valor es "template". De ese modo, la plantilla de SAM es el punto de entrada para la sesión de depuración.

   • "templatePath": ingrese una ruta relativa o absoluta para el archivo template.yaml.

   • "logicalId": asegúrese de que el nombre coincida con el especificado en la sección Resources (Recursos) de la plantilla de SAM. En este caso, es HelloWorldFunction de tipoAWS::Serverless::Function.

   Para obtener más información sobre estas y otras entradas del archivo launch.json, consulte Opciones de configuración para depurar aplicaciones sin servidor.

5. Si está satisfecho con la configuración de depuración, guarde el archivo launch.json. A continuación, elija el botón de "reproducción" verde junto a RUN (Ejecutar) para iniciar la depuración.

   nota

   Si la aplicación de SAM no se ejecuta, consulte la ventana Output (Salida) para ver si el error se debe a una imagen de Docker que no se compila. Es posible que tenga que liberar espacio del disco en el entorno.

   Para obtener más información, consulte Error al ejecutar aplicaciones SAM localmente en AWS Toolkit porque el entorno de AWS Cloud9 no tiene suficiente espacio en disco.

   Cuando se inician las sesiones de depuración, el panel DEBUG CONSOLE (CONSOLA DE DEPURACIÓN) muestra la salida de la depuración y los valores que devuelve la función de Lambda. Al depurar aplicaciones de SAM, AWS Toolkit (Kit de herramientas de AWS) se selecciona como canal de Output (Salida) en el panel Output (Salida).

   nota

   Para los usuarios de Windows, si encuentra un error de montaje de Docker durante este proceso, es posible que deba actualizar las credenciales de las unidades compartidas en Docker Settings (Configuración de Docker). Un error de montaje de Docker tiene un aspecto similar al siguiente.

   Fetching lambci/lambda:nodejs10.x Docker container image......
   2019-07-12 13:36:58 Mounting C:\Users\<username>\AppData\Local\Temp\ ... as /var/task:ro,delegated inside runtime container
   Traceback (most recent call last):
   ...requests.exceptions.HTTPError: 500 Server Error: Internal Server Error ...

Para ejecutar y depurar una aplicación sin servidor directamente desde el código de la aplicación

1. Para ver los archivos de la aplicación sin servidor, vaya a la carpeta de la aplicación mediante la elección del icono de carpeta situado junto al editor.

2. Desde la carpeta de la aplicación (por ejemplo, my-sample-app), expanda la carpeta de la función (en este ejemplo, hello-world) y abra el archivo app.js.

3. En la acción en línea que identifica una función de controlador de Lambda válida, elija Add Debug Configuration. Si no aparece la opción de agregar configuración de depuración, debe habilitar lentes de código. Para activar lentes de código, consulte Habilitación de lentes de código de AWS Toolkit .

   

4. Seleccione el tiempo de ejecución donde se ejecuta la aplicación de SAM.

5. En el editor del archivo launch.json, edite o confirme los valores de las siguientes propiedades de configuración:

   • "name": ingrese un nombre fácil de leer.

   • "target": asegúrese de que el valor es "code" para que un controlador de funciones de Lambda se invoque directamente.

   • "lambdaHandler": ingrese el nombre del método en el código al que Lambda llama para ejecutar su función. Por ejemplo, para aplicaciones en JavaScript, el valor predeterminado es app.lambdaHandler.

   • "projectRoot": ingrese la ruta al archivo de aplicación que contiene la función de Lambda.

   • "runtime": ingrese o confirme un tiempo de ejecución válido para el entorno de ejecución de Lambda (por ejemplo, "nodejs.12x").

   • "payload". Elija una de las siguientes opciones para definir la carga del evento que desea proporcionar a la función de Lambda como entrada:

     • "json": pares clave-valor con formato JSON que definen la carga del evento.

     • "path": ruta al archivo que se utiliza como carga del evento.

6. Si está satisfecho con la configuración de depuración, elija la flecha de reproducción verde junto a RUN para iniciar la depuración.

   Cuando se inician las sesiones de depuración, el panel DEBUG CONSOLE (CONSOLA DE DEPURACIÓN) muestra la salida de la depuración y los valores que devuelve la función de Lambda. Al depurar aplicaciones de SAM, AWS Toolkit (Kit de herramientas de AWS) se selecciona como el canal de Output (Salida) en el panel Output (Salida).

   nota

   Si Docker se menciona en los mensajes de error, consulte esta nota.

Para ejecutar y depurar recursos de API Gateway locales

1. Elija uno de los siguientes enfoques para crear una configuración de lanzamiento para un recurso de AWS SAM API Gateway:

   • Opción 1: visite el código fuente del controlador (en concreto, archivo .js, .cs o .py) en su proyecto de AWS SAM, pase el cursor sobre el controlador de Lambda y elija Add Debug Configuration (Agregar configuración de depuración). Si no aparece la opción de agregar configuración de depuración, habilite lentes de código. Para activar lentes de código, consulte Habilitación de lentes de código de AWS Toolkit . A continuación, en el menú, elija el elemento marcado como Evento de API.

   • Opción 2: edite launch.json y cree una nueva configuración de lanzamiento mediante la sintaxis siguiente.

     {
         "type": "aws-sam",
         "request": "direct-invoke",
         "name": "myConfig",
         "invokeTarget": {
             "target": "api",
             "templatePath": "n12/template.yaml",
             "logicalId": "HelloWorldFunction"
         },
         "api": {
             "path": "/hello",
             "httpMethod": "post",
             "payload": {
                 "json": {}
             }
         }, 
         "sam": {},
         "aws": {}
     }
                             

2. En el menú desplegable junto al botón Run (Ejecutar), elija la configuración de lanzamiento (denominada myConfig en el ejemplo anterior).

3. (Opcional) Agregue puntos de interrupción al código del proyecto de Lambda.

4. Elija el botón Run (Ejecutar) junto al botón “reproducir” verde.

5. En el panel de resultados, vea los resultados.

1. En la ventana del Explorador de AWS, abra el menú contextual (haciendo clic con el botón derecho) del nodo Lambda y seleccione Sincronizar una aplicación SAM.

2. Elija la Región de AWS en la que desea realizar la implementación.

3. Elija el archivo template.yaml que desea utilizar para la implementación.

4. Ingrese el nombre de un bucket de Amazon S3 que se pueda utilizar en esta implementación. El bucket debe estar en la región en la que está realizando la implementación.

   aviso

   El nombre del bucket de Amazon S3 debe ser único globalmente para todos los nombres de buckets existentes en Amazon S3. Agregue un identificador único al nombre indicado en el siguiente ejemplo o elija otro nombre.

5. Si su aplicación sin servidor incluye una función con el tipo de paquete Image, ingrese el nombre de un repositorio de Amazon ECR que se pueda utilizar en esta implementación. El repositorio debe estar en la región en la que está realizando la implementación.

6. Introduzca el nombre para la pila implementada, que puede ser nuevo o existente.

7. Verifique el éxito de la implementación en la pestaña AWS Toolkit de la consola.

   Si se produce un error, aparece un mensaje en la parte inferior derecha.

   Si esto sucede, verifique el texto de la pestaña AWS Toolkit para obtener más información. A continuación se muestra un ejemplo de información sobre un error.

   Error with child process: Unable to upload artifact HelloWorldFunction referenced by CodeUri parameter of HelloWorldFunction resource.
   S3 Bucket does not exist. Execute the command to create a new bucket
   aws s3 mb s3://pbart-my-sam-app-bucket
   An error occurred while deploying a SAM Application. Check the logs for more information by running the "View AWS Toolkit Logs" command from the Command Palette.

   En este ejemplo, el error se ha producido porque el bucket de Amazon S3 no existía.