Cómo trabajar AWS SAM con el AWS kit de herramientas

1. En el AWS explorador, abra el menú contextual (haga clic con el botón derecho) del nodo Lambda y, a continuación, seleccione Crear aplicación Lambda. SAM

   nota

   Como alternativa, puede seleccionar el icono de menú situado frente al encabezado AWS: Explorer y elegir Crear aplicación Lambda SAM.

2. Elija el tiempo de ejecución de la SAM aplicación. 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 Lambda que devuelve el clásico mensaje «Hello World».

   • AWS Aplicación de muestra Step Functions: una aplicación de muestra que ejecuta un flujo de trabajo de negociación de acciones. 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 presionar Entrar, el AWS kit de herramientas tarda unos minutos en crear el proyecto.

Para usar una SAM plantilla 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. Desde la carpeta de la aplicación (por ejemplo, my-sample-app), abra el template.yaml archivo.

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 esta forma, la SAM plantilla es el punto de entrada a 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 que se especifica en la sección Recursos de la SAM plantilla. 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, selecciona el botón verde de «reproducir» situado junto a él RUNpara iniciar la depuración.

   nota

   Si SAM la aplicación no se ejecuta, compruebe la ventana de resultados para ver si el error se debe a una imagen de Docker que no se está creando. Es posible que tenga que liberar espacio del disco en el entorno.

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

   Cuando se inician las sesiones de depuración, el DEBUGCONSOLEpanel muestra el resultado de la depuración y muestra los valores devueltos por la función Lambda. Al depurar SAM aplicaciones, el AWS kit de herramientas se selecciona como canal de salida en el panel de 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 funciones (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 Habilitar las lentes de código del AWS Toolkit .

   

4. Seleccione el entorno de ejecución en el que se ejecuta SAM la aplicación.

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 las aplicaciones en JavaScript, el valor predeterminado esapp.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 JSON clave-valor con formato: que definen la carga útil del evento.

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

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

   Cuando se inician las sesiones de depuración, el DEBUGCONSOLEpanel muestra el resultado de la depuración y muestra los valores devueltos por la función Lambda. Al depurar SAM aplicaciones, se selecciona AWS Toolkit como canal de salida en el panel de salida.

   nota

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

Para ejecutar y depurar los recursos locales de API Gateway

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 Habilitar las lentes de código del AWS Toolkit . Luego, en el menú, selecciona el elemento marcado como API Evento.

   • 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 AWS explorador, abra el menú contextual (haga clic con el botón derecho) del nodo Lambda y seleccione Sync SAM Application.

2. Elija el lugar en el Región de AWS que desee 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 un tipo de paqueteImage, introduzca el nombre de un ECR repositorio de Amazon que pueda usar 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.