

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.

# Implemente una función Lambda con AWS SAM CodeBuild Lambda Java
<a name="sample-lambda-sam-gradle"></a>

The AWS Serverless Application Model (AWS SAM) es un marco de código abierto para crear aplicaciones sin servidor. Para obtener más información, consulte el [AWS Serverless Application Model repositorio](https://github.com/aws/serverless-application-model) en. GitHub En el siguiente ejemplo de Java, se usa Gradle para crear y probar una AWS Lambda función. Después de lo cual, la AWS SAM CLI se usa para implementar la CloudFormation plantilla y el paquete de implementación. Al usar CodeBuild Lambda, los pasos de compilación, prueba e implementación se gestionan automáticamente, lo que permite que la infraestructura se actualice rápidamente sin intervención manual en una sola compilación.

## Configure su repositorio AWS SAM
<a name="sample-lambda-sam-gradle.set-up-repo"></a>

Cree un AWS SAM `Hello World` proyecto mediante la AWS SAM CLI.

**Para crear su AWS SAM proyecto**

1. Siga las instrucciones de la *Guía del AWS Serverless Application Model desarrollador* para [instalar la AWS SAM CLI](https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/install-sam-cli.html) en su máquina local.

1. Ejecute `sam init` y seleccione la siguiente configuración del proyecto.

   ```
   Which template source would you like to use?: 1 - AWS Quick Start Templates
   Choose an AWS Quick Start application template: 1 - Hello World Example
   Use the most popular runtime and package type? (Python and zip) [y/N]: N
   Which runtime would you like to use?: 8 - java21
   What package type would you like to use?: 1 - Zip
   Which dependency manager would you like to use?: 1 - gradle
   Would you like to enable X-Ray tracing on the function(s) in your application? [y/N]: N
   Would you like to enable monitoring using CloudWatch Application Insights? [y/N]: N
   Would you like to set Structured Logging in JSON format on your Lambda functions? [y/N]:  N
   Project name [sam-app]: <insert project name>
   ```

1. Cargue la carpeta AWS SAM del proyecto en un repositorio de código fuente compatible. Para obtener una lista de los tipos de fuentes compatibles, consulte [ProjectSource](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_ProjectSource.html).

## Creación de un CodeBuild proyecto Java Lambda
<a name="sample-lambda-sam-gradle.create-project"></a>

Cree un proyecto Java AWS CodeBuild Lambda y configure los permisos de IAM necesarios para la compilación.

**Para crear su proyecto CodeBuild Lambda Java**

1. Abra la AWS CodeBuild consola en [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home).

1.  Si aparece una página de CodeBuild información, elija **Crear** proyecto de compilación. De lo contrario, en el panel de navegación, expanda **Compilar**, elija **Proyectos de compilación** y, a continuación, elija **Crear proyecto de compilación**. 

1. En **Project name (Nombre de proyecto)**, escriba un nombre para este proyecto de compilación. Los nombres de los proyectos de compilación deben ser únicos en cada AWS cuenta. También puede introducir una descripción opcional del proyecto de compilación para ayudar a otros usuarios a entender para qué se utiliza el proyecto.

1. En **Fuente**, selecciona el repositorio de origen en el que se encuentra tu AWS SAM proyecto.

1. En **Environment (Entorno)**:
   + En **Computación**, seleccione **Lambda**.
   + En **Tiempo(s) de ejecución**, seleccione **Java**.
   + En **Imagen**, seleccione **aws/codebuild/amazonlinux-x86\$164-lambda-standard:corretto21**.
   + En **Rol de servicio**, seleccione **Nuevo rol de servicio**. Anote el **Nombre del rol**. Esto será necesario cuando actualice los permisos de IAM del proyecto más adelante en este ejemplo.

1. Elija **Crear el proyecto de compilación**.

1. Abra la consola de IAM en [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 

1. En el panel de navegación, elija **Roles** y seleccione el rol de servicio asociado a su proyecto. ******Para encontrar su función en el proyecto, seleccione el proyecto de construcción, elija Edición, Entorno y, a continuación, la función CodeBuild de servicio.******

1. Elija la pestaña **Relaciones de confianza** y, a continuación, **Editar política de confianza**.

1. Agregue la siguiente política insertada al rol de IAM. Esto se utilizará para implementar su AWS SAM infraestructura más adelante. Para obtener más información, consulta [Adición y eliminación de permisos de identidad de IAM](https://docs.aws.amazon.com//IAM/latest/UserGuide/access_policies_manage-attach-detach.html) en la *Guía del usuario de IAM*.

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Sid": "",
               "Effect": "Allow",
               "Action": [
                   "cloudformation:*",
                   "lambda:*",
                   "iam:*",
                   "apigateway:*",
                   "s3:*"
               ],
               "Resource": "arn:aws:iam::*:role/Service*"
           }
       ]
   }
   ```

------

## Configuración de la especificación de compilación del proyecto
<a name="sample-lambda-sam-gradle.set-up-buildspec"></a>

Para crear, probar e implementar la función Lambda, CodeBuild lee y ejecuta los comandos de compilación desde una especificación de compilación.

**Para configurar la especificación de compilación del proyecto**

1. ****En la CodeBuild consola, selecciona tu proyecto de compilación y, a continuación, selecciona Editar y Buildspec.****

1. En **Especificación de compilación**, elija **Insertar comandos de compilación** y, a continuación, **Cambiar al editor**.

1. Elimine los comandos de compilación rellenados previamente y pegue la siguiente especificación de compilación.

   ```
   version: 0.2
   env:
     variables:
       GRADLE_DIR: "HelloWorldFunction"
   phases:
     build:
       commands:
         - echo "Running unit tests..."
         - cd $GRADLE_DIR; gradle test; cd ..
         - echo "Running build..."
         - sam build --template-file template.yaml
         - echo "Running deploy..."
         - sam package --output-template-file packaged.yaml --resolve-s3 --template-file template.yaml
         - yes | sam deploy
   ```

1. Seleccione **Update buildspec (Actualizar buildspec)**.

## Implemente su AWS SAM infraestructura Lambda
<a name="sample-lambda-sam-gradle.deploy"></a>

Utilice CodeBuild Lambda para implementar automáticamente su infraestructura Lambda

**Para implementar su infraestructura de Lambda**

1. Seleccione **Iniciar la compilación**. Esto creará, probará e implementará automáticamente la AWS SAM aplicación para AWS Lambda utilizarla. CloudFormation

1. Una vez finalizada la compilación, diríjase a la AWS Lambda consola y busque la nueva función Lambda en el nombre del AWS SAM proyecto.

1. Pruebe la función de Lambda; para ello, seleccione **API Gateway** en la información general de **Función** y, a continuación, haga clic en la URL de **Punto de conexión de API**. Debería aparecer una página abierta con el mensaje `"message": "hello world"`.

## Limpieza de la infraestructura
<a name="sample-lambda-sam-gradle.clean-up"></a>

Para evitar que se le cobre más por los recursos que utilizó durante este tutorial, elimine los recursos creados por la AWS SAM plantilla y CodeBuild.

**Para limpiar la infraestructura**

1. Navegue hasta la CloudFormation consola y seleccione`aws-sam-cli-managed-default`.

1. En **Recursos**, vacíe el bucket de implementación `SamCliSourceBucket`.

1. Elimine la pila de `aws-sam-cli-managed-default`.

1. Elimine la CloudFormation pila asociada a su AWS SAM proyecto. Esta pila debe tener el mismo nombre que tu AWS SAM proyecto.

1. Ve a la CloudWatch consola y elimina los grupos de CloudWatch registros asociados a tu CodeBuild proyecto.

1. Ve a la CodeBuild consola y elimina tu CodeBuild proyecto seleccionando **Eliminar proyecto de compilación**.