Tutorial: Creación de una aplicación full stack con esquemas PDK modulables

1. Abra la consola de CodeCatalyst en https://codecatalyst.aws/.

2. En la consola de CodeCatalyst, vaya al espacio donde desee crear un proyecto.

3. En el panel de control del espacio, seleccione Crear proyecto.

4. Seleccione Empezar con un esquema.

5. Seleccione el esquema PDK - Monorepo y, luego, Siguiente.

6. En Asignar nombre al proyecto, introduzca el nombre que desea asignar al proyecto y los nombres de los recursos asociados. El nombre debe ser único dentro de su espacio.

7. En Contenido del proyecto, haga lo siguiente:

   1. En Lenguaje de programación principal, elija el lenguaje en el que quiera desarrollar el código del proyecto. Puede elegir TypeScript, Java o Python.

   2. Elija Configuración del código

   3. En el campo de entrada de texto Repositorio de origen, introduzca el nombre de un repositorio de código fuente, que creará un repositorio nuevo, o seleccione uno de los repositorios vinculados existentes. El repositorio existente debe estar vacío. Para obtener más información, consulte Vinculación de un repositorio de código fuente.

   4. (Opcional) En el menú desplegable Administrador de paquetes, seleccione un administrador de paquetes. Esto solo es necesario si ha seleccionado TypeScript como lenguaje de programación principal.

8. (Opcional) Para obtener una vista previa del código que se generará en función de las selecciones de parámetros de proyecto que haya hecho, seleccione Ver código desde Generar vista previa del proyecto.

9. (Opcional) Seleccione Ver detalles en la tarjeta del esquema para ver detalles específicos del esquema, como una descripción general de su arquitectura, las conexiones y los permisos necesarios y el tipo de recursos que crea.

10. Seleccione Crear proyecto para crear el proyecto monorepo. El proyecto de nivel raíz creado administra las interdependencias entre los proyectos de monorepo, además de proporcionar almacenamiento en caché de compilación y administración de dependencias.

    Para obtener más información sobre los esquemas de proyectos, consulte Creación de un proyecto integral con esquemas de CodeCatalyst.

1. En el panel de navegación del proyecto monorepo, elija Esquemas y, a continuación, Añadir esquema.

2. Seleccione el esquema PDK - Type Safe API y, luego, Siguiente.

3. En Configurar esquema, configure los parámetros del esquema:

   • En Lenguaje del modelo, elija el lenguaje en el que está definido el modelo de API.

   • En el campo de entrada de texto Espacio de nombres, introduzca un espacio de nombres para la API.

   • En el campo de entrada de texto Nombre de la API, introduzca un nombre para la API.

   • En Lenguaje de CDK, elija el lenguaje que prefiera para escribir la infraestructura del CDK en la que se implementará la API.

   • Seleccione el menú desplegable Lenguajes de los controladores y elija los lenguajes en los que quiera implementar los controladores para las operaciones de la API.

   • Seleccione el menú desplegable Formatos de documentación y, a continuación, elija los formatos que desee para generar la documentación de la API.

4. En la pestaña Cambios de código, revise los cambios propuestos. La diferencia que aparece en una solicitud de extracción muestra los cambios en su proyecto en el momento en el que se creó la solicitud de extracción.

5. Cuando esté satisfecho con los cambios propuestos que se llevarán a cabo cuando se aplique el esquema, seleccione Añadir esquema.

   Tras crear una solicitud de extracción, podrá añadir comentarios. Los comentarios se pueden añadir a la solicitud de extracción o a líneas individuales de los archivos, así como a la solicitud de extracción en general. Puede añadir enlaces a un recurso, como archivos, utilizando el signo @ seguido del nombre del archivo.

   nota

   El esquema no se aplicará hasta que se apruebe y combine la solicitud de extracción. Para obtener más información, consulte Revisión de una solicitud de extracción y Combinación de una solicitud de extracción.

6. En la columna Estado, seleccione Solicitud de extracción pendiente para la fila del esquema PDK - Type Safe API y, a continuación, seleccione el enlace de la solicitud de extracción abierta.

7. Seleccione Combinar, elija la estrategia de combinación que desee y seleccione Combinar para incorporar los cambios del esquema aplicado.

   Tras combinar la solicitud de extracción, se generará una nueva carpeta packages/apis/mypdkapi en el proyecto monorepo, que contiene todo el código fuente relacionado con la API para el Type Safe API configurado.

8. En el panel de navegación, seleccione Esquemas para confirmar que el Estado de PDK - Type Safe API aparezca como Actualizado.

1. En el panel de navegación del proyecto monorepo, elija Esquemas y, a continuación, Añadir esquema.

2. Elija el esquema PDK - Cloudscape React Website y seleccione Siguiente.

3. En Configurar esquema, configure los parámetros del esquema:

   • En el campo de entrada de texto Nombre del sitio web, introduzca un nombre para el sitio web.

   • Seleccione el menú desplegable API de Type Safe y elija los esquemas de API que desee integrar en el sitio web. Al transferir una API, se configuran los clientes autenticados y se añaden las dependencias necesarias, el explorador de API y otras funciones.

4. En la pestaña Cambios de código, revise los cambios propuestos. La diferencia que aparece en una solicitud de extracción muestra los cambios en su proyecto en el momento en el que se creó la solicitud de extracción.

5. Cuando esté satisfecho con los cambios propuestos que se llevarán a cabo cuando se aplique el esquema, seleccione Añadir esquema.

   Tras crear una solicitud de extracción, podrá añadir comentarios. Los comentarios se pueden añadir a la solicitud de extracción o a líneas individuales de los archivos, así como a la solicitud de extracción en general. Puede añadir enlaces a un recurso, como archivos, utilizando el signo @ seguido del nombre del archivo.

   nota

   El esquema no se aplicará hasta que se apruebe y combine la solicitud de extracción. Para obtener más información, consulte Revisión de una solicitud de extracción y Combinación de una solicitud de extracción.

6. En la columna Estado, seleccione Solicitud de extracción pendiente para la fila del esquema PDK - Cloudscape React Website y, a continuación, seleccione el enlace de la solicitud de extracción abierta.

7. Seleccione Combinar, elija la estrategia de combinación que desee y seleccione Combinar para incorporar los cambios del esquema aplicado.

   Tras combinar la solicitud de extracción, se generará una nueva carpeta packages/websites/my-website-name en el proyecto monorepo, que contiene todo el código fuente del nuevo sitio web.

8. En el panel de navegación, seleccione Esquemas para confirmar que el Estado de PDK - Cloudscape React Website aparezca como Actualizado.

1. En el panel de navegación del proyecto monorepo, elija Esquemas y, a continuación, Añadir esquema.

2. Seleccione el esquema PDK - Infrastructure y, luego, Siguiente.

3. En Configurar esquema, configure los parámetros del esquema:

   • En Lenguaje del CDK, elija el lenguaje con el que desee desarrollar la infraestructura.

   • En el campo de entrada de texto Nombre de pila, introduzca el nombre de la pila de CloudFormation generada para el esquema.

     nota

     Tome nota del nombre de esta pila para el siguiente paso, en el que configurará un flujo de trabajo de DevOps.

   • Seleccione el menú desplegable API de Type Safe y elija los esquemas de API que desee integrar en el sitio web.

   • Seleccione el menú desplegable Cloudscape React TS Websites y, a continuación, seleccione los esquemas de sitios web que quiera implementar en la infraestructura (por ejemplo, PDK - Cloudscape React Website).

4. En la pestaña Cambios de código, revise los cambios propuestos. La diferencia que aparece en una solicitud de extracción muestra los cambios en su proyecto en el momento en el que se creó la solicitud de extracción.

5. Cuando esté satisfecho con los cambios propuestos que se llevarán a cabo cuando se aplique el esquema, seleccione Añadir esquema.

   Tras crear una solicitud de extracción, podrá añadir comentarios. Los comentarios se pueden añadir a la solicitud de extracción o a líneas individuales de los archivos, así como a la solicitud de extracción en general. Puede añadir enlaces a un recurso, como archivos, utilizando el signo @ seguido del nombre del archivo.

   nota

   El esquema no se aplicará hasta que se apruebe y combine la solicitud de extracción. Para obtener más información, consulte Revisión de una solicitud de extracción y Combinación de una solicitud de extracción.

6. En la columna Estado, seleccione Solicitud de extracción pendiente para la fila del esquema PDK - Infrastructure y, a continuación, seleccione el enlace de la solicitud de extracción abierta.

7. Seleccione Combinar, elija la estrategia de combinación que desee y seleccione Combinar para incorporar los cambios del esquema aplicado.

   Tras combinar la solicitud de extracción, se generará una nueva carpeta packages/infra dentro del proyecto monorepo, que contiene la infraestructura que implementará el proyecto en la nube de AWS.

8. En el panel de navegación, seleccione Esquemas para confirmar que el Estado de PDK - Infrastructure aparezca como Actualizado.

1. En el panel de navegación del proyecto monorepo, elija Esquemas y, a continuación, Añadir esquema.

2. Seleccione el esquema PDK - DevOps y, luego, Siguiente.

3. En Configurar esquema, configure los parámetros del esquema:

   • Elija CDK de arranque en el entorno actual.

   • En el campo de entrada de texto Nombre de pila, introduzca el nombre de la pila de CloudFormation que desee implementar. Debe coincidir con el nombre de la pila configurado en Paso 4: generar la infraestructura para implementar la aplicación en la nube de AWS para el esquema PDK - Infrastructure.

   • Elija el menú desplegable Conexión de la cuenta de AWS y, a continuación, elija la cuenta de AWS que desee utilizar para los recursos. Para obtener más información, consulte Adición de una Cuenta de AWS a un espacio.

   • Elija el menú desplegable Rol empleado para implementar la aplicación y seleccione el rol de IAM que desee usar para implementar la aplicación del proyecto.

     nota

     Al crear un rol de IAM, limite el SourceArn al ProjectID actual en la configuración del proyecto. Para obtener más información, consulte El funcionamiento del rol de servicio CodeCatalystWorkflowDevelopmentRole-spaceName.

   • Seleccione el menú desplegable Región y, a continuación, elija la región en la que desee implementar el proyecto monorepo. La implementación solo funciona en las regiones donde están los servicios de AWS necesarios. Para obtener más información, consulte Servicios de AWS por región.

4. En la pestaña Cambios de código, revise los cambios propuestos. La diferencia que aparece en una solicitud de extracción muestra los cambios en su proyecto en el momento en el que se creó la solicitud de extracción.

5. Cuando esté satisfecho con los cambios propuestos que se llevarán a cabo cuando se aplique el esquema, seleccione Añadir esquema.

   Tras crear una solicitud de extracción, podrá añadir comentarios. Los comentarios se pueden añadir a la solicitud de extracción o a líneas individuales de los archivos, así como a la solicitud de extracción en general. Puede añadir enlaces a un recurso, como archivos, utilizando el signo @ seguido del nombre del archivo.

   nota

   El esquema no se aplicará hasta que se apruebe y combine la solicitud de extracción. Para obtener más información, consulte Revisión de una solicitud de extracción y Combinación de una solicitud de extracción.

6. En la columna Estado, seleccione Solicitud de extracción pendiente para la fila del esquema PDK - Infrastructure y, a continuación, seleccione el enlace de la solicitud de extracción abierta.

7. Seleccione Combinar, elija la estrategia de combinación que desee y seleccione Combinar para incorporar los cambios del esquema aplicado.

   Tras combinar la solicitud de extracción, se generará una nueva carpeta .codecatalyst/workflows en el proyecto monorepo.

8. En el panel de navegación, seleccione Esquemas para confirmar que el Estado de PDK - DevOps aparezca como Actualizado.

1. En el panel de navegación del proyecto monorepo, elija CI/CD y, a continuación, Flujos de trabajo.

2. Para el flujo de trabajo de publicación, seleccione la última ejecución del flujo de trabajo para ver sus detalles. Para obtener más información, consulte Visualización del estado y los detalles de una sola ejecución.

3. Cuando la ejecución del flujo de trabajo se haya completado correctamente, elija la última acción del flujo de trabajo (por ejemplo, Deploy-Beta-ap-souteast-2) y seleccione Variables.

   

4. Vea el sitio web implementado copiando y pegando el enlace que se encuentra en la tabla Variables (por ejemplo, MyPDKApiwebsiteDistributionDomainNameXXXXX) en una nueva ventana del navegador.

   

   Necesita una cuenta de Amazon Cognito para iniciar sesión en el sitio web. De forma predeterminada, el grupo de usuarios no está configurado para permitir el registro automático.

   1. Vaya a la consola de AWS Cognito.

   2. En la tabla Grupos de usuarios, elija el Nombre del grupo de usuarios que coincida con el grupo de usuarios creado por el esquema PDK - DevOps, que se encuentra en la tabla Variables (por ejemplo, infracalculatebetaUserIdentityinfracalculatebetaUserIdentityIdentityPoolIdXXXXX). Para obtener más información, consulte Getting started with user pools.

      

   3. Seleccione la opción Crear un usuario.

   4. Configure los parámetros de Información del usuario:

      • En Mensaje de invitación, seleccione Enviar una invitación por correo electrónico.

      • En el campo de entrada de texto Nombre de usuario, introduzca un nombre de usuario.

      • En el campo de entrada de texto Dirección de correo electrónico, introduzca un nombre de usuario.

      • En Contraseña temporal, seleccione Generar una contraseña.

   5. Seleccione la opción Crear un usuario.

   6. Vaya hasta la cuenta de correo electrónico que ha introducido para los parámetros de Información del usuario y abra un correo electrónico con una contraseña temporal. Anote la contraseña.

   7. Vuelva al sitio web implementado, introduzca el nombre de usuario que ha creado y la contraseña temporal que ha recibido y, a continuación, seleccione Iniciar sesión.

5. (Opcional) Cuando la ejecución del flujo de trabajo se haya completado correctamente, también podrá ver el diagrama generado. Seleccione la pestaña Artefactos en CodeCatalyst, elija Descargar para la fila de Diagrama y abra los archivos descargados.

   
   

Invitación a un miembro al proyecto desde la pestaña de configuración del proyecto

1. Vaya a su proyecto.

   sugerencia

   Puede elegir qué proyecto ver en la barra de navegación superior.

2. En el panel de navegación, seleccione Configuración del proyecto.

3. Seleccione la pestaña Miembros.

4. En Miembros del proyecto, seleccione Invitar a un nuevo miembro.

5. Escriba la dirección de correo electrónico del nuevo miembro, seleccione el rol de ese miembro y elija Invitar. Para obtener más información acerca de los roles de , consulte Concesión de acceso en los roles de usuario.

Invitación a un miembro al proyecto desde la página Descripción general del proyecto

1. Vaya a su proyecto.

   sugerencia

   Puede elegir qué proyecto ver en la barra de navegación superior.

2. Seleccione el botón Miembros +.

3. Escriba la dirección de correo electrónico del nuevo miembro, seleccione el rol de ese miembro y elija Invitar. Para obtener más información acerca de los roles de , consulte Concesión de acceso en los roles de usuario.

1. Abra la consola de CodeCatalyst en https://codecatalyst.aws/.

2. Vaya al proyecto monorepo donde desee crear un problema.

3. En la página de inicio del proyecto, seleccione Crear proyecto. Si lo prefiere, en el panel de navegación, seleccione Problemas.

4. Seleccione Crear el problema.

   nota

   También puede añadir problemas en línea al usar una vista de cuadrícula.

5. Introduzca un título para el problema.

6. (Opcional) Introduzca una Descripción. Para este problema, introduzca la siguiente descripción: a change in the src/mysfit_data.json file. Puede usar Markdown para añadir formato.

7. (Opcional) Elija un Estado, una Prioridad o una Estimación para el problema.

8. (Opcional) Añada una etiqueta existente o cree una nueva y añádala seleccionando + Agregar etiqueta.

   1. Para añadir una etiqueta existente, selecciónela de la lista. Puede introducir un término de búsqueda en el campo para buscar en el proyecto todas las etiquetas que contengan ese término.

   2. Para crear una etiqueta nueva y añadirla, introduzca el nombre de la etiqueta que desee crear en el campo de búsqueda y pulse Intro.

9. (Opcional) Añada un cesionario seleccionando + Añadir un cesionario. Puede añadirse rápidamente como cesionario seleccionando + Añadirme.

   sugerencia

   Puede asignarle el problema a Amazon Q para que Amazon Q intente resolverlo. Para obtener más información, consulte Tutorial: Uso de las características de IA generativa de CodeCatalyst para acelerar el trabajo de desarrollo.

   Esta funcionalidad requiere que las características de IA generativa estén habilitadas en el espacio. Para obtener más información, consulte Managing generative AI features.

10. (Opcional) Añada un campo personalizado existente o cree uno nuevo. Los problemas pueden tener varios campos personalizados.

    1. Para añadir un campo personalizado existente, elija el campo personalizado en la lista. Puede introducir un término de búsqueda en el campo para buscar en el proyecto todos los campos personalizados que contengan ese término.

    2. Para crear un nuevo campo personalizado y añadirlo, introduzca el nombre del campo personalizado que desee crear en el campo de búsqueda y pulse Intro. A continuación, elija el tipo de campo personalizado que desee crear y establezca un valor.

11. Seleccione Crear el problema. Aparecerá una notificación en la esquina inferior derecha: si el problema se ha creado correctamente, aparecerá un mensaje de confirmación indicándolo; si el problema no se ha creado correctamente, aparecerá un mensaje de error con el motivo. A continuación, puede seleccionar Reintentar para editar y volver a intentar crear el problema, o bien seleccionar Descartar para descartarlo. Ambas opciones descartarán la notificación.

    nota

    No puede vincular una solicitud de extracción a un problema cuando lo crea. Sin embargo, puede editarlo después de crearlo para añadir enlaces a las solicitudes de extracción.

Navegación a los repositorios de código fuente de un proyecto

1. Vaya al proyecto y lleve a cabo una de las siguientes acciones:

   • En la página de resumen del proyecto, elija el repositorio que desee de la lista y, a continuación, elija Ver repositorio.

   • En el panel de navegación, elija Código y, a continuación, elija Repositorios de origen. En Repositorios de origen, elija el nombre del repositorio en la lista. Puede filtrar la lista de repositorios escribiendo una parte del nombre en la barra de filtros.

2. En la página de inicio del repositorio, consulte el contenido del repositorio y la información sobre los recursos asociados, como el número de solicitudes de extracción y los flujos de trabajo. De forma predeterminada, se muestra el contenido de la ramificación predeterminada. Para cambiar la vista, seleccione otra ramificación en la lista desplegable.

1. En el panel de navegación del proyecto monorepo, lleve a cabo una de las siguientes acciones:

   • Seleccione Descripción general y vaya a la sección Mis entornos de desarrollo.

   • Seleccione Código y Entornos de desarrollo.

   • Seleccione Código y Repositorios de origen y elija el repositorio monorepo para el que quiera crear un entorno de desarrollo.

2. Seleccione un IDE compatible en el menú desplegable. Para obtener más información, consulte Entornos de desarrollo integrados compatibles.

3. Seleccione Clonar un repositorio.

4. Elija el repositorio que desea clonar, elija Trabajar en una nueva ramificación, introduzca el nombre de la ramificación en el campo Nombre de ramificación, y elija una ramificación a partir de la cual crear la ramificación nueva en el menú desplegable Crear ramificación desde.

   nota

   Si crea un entorno de desarrollo desde la página Repositorios de origen o desde un repositorio de código fuente específico, no necesita elegir un repositorio. El entorno de desarrollo se creará a partir del repositorio de código fuente que haya elegido en la página Repositorios de origen.

5. (Opcional) En Alias: opcional, añada un alias para el entorno de desarrollo.

6. (Opcional) Elija el botón de edición Configuración del entorno de desarrollo para editar la configuración de computación, almacenamiento o tiempo de espera del entorno de desarrollo.

7. (Opcional) En Amazon Virtual Private Cloud (Amazon VPC): opcional, seleccione la conexión de VPC que quiera asociar a su entorno de desarrollo en el menú desplegable.

   Si se establece una VPC predeterminada para su espacio, los entornos de desarrollo se ejecutarán conectados a esa VPC. Puede invalidar este comportamiento asociando una conexión de VPC diferente. Además, tenga en cuenta que los entornos de desarrollo conectados a una VPC no admiten el kit de herramientas de AWS.

   nota

   Al crear un entorno de desarrollo con una conexión de VPC, se crea una nueva interfaz de red dentro de la VPC. CodeCatalyst interactúa con esta interfaz mediante el rol de VPC asociado. Además, asegúrese de que el bloque CIDR de IPv4 no esté configurado para el intervalo de direcciones IP 172.16.0.0/12.

8. Seleccione Crear. Mientras se crea el entorno de desarrollo, la columna de estado del entorno de desarrollo mostrará Iniciando y la columna de estado mostrará Ejecutando una vez se haya creado el entorno de desarrollo.

1. En un terminal funcional del entorno de desarrollo, vaya al proyecto monorepo e instale las dependencias del proyecto ejecutando el siguiente comando:

   npx projen install

2. Vaya a packages/apis/mypdkapi/model/src/main/smithy/operations/say-hello.smithy, que define un ejemplo de operación de API. En este tutorial, creará una operación Calculate sencilla para sumar dos números. Haga un cambio en el código para definir esta operación, lo que incluye las entradas y salidas.

   Ejemplo:

   $version: "2"
   namespace com.aws
   
   @http(method: "POST", uri: "/calculate")
   @handler(language: "typescript")
   operation Calculate {
       input := {
           @required
           numberA: Integer
           @required
           numberB: Integer
       }
       output := {
           @required
           result: Integer
       }
   }

   La característica @handler le dice a Type Safe API que implementará esta operación como un controlador de AWS Lambda escrito en TypeScript. Type Safe API generará un stub para esta operación para que lo implemente en TypeScript. Se añade la característica @required, lo que significa que la puerta de enlace de API que se implemente la aplicará en tiempo de ejecución. Para obtener más información, consulte la documentación de Smithy.

3. Cambie el nombre de archivo de /say-hello.smithy por uno que encaje con los cambios de código (por ejemplo, calculate.smithy).

4. Vaya a packages/apis/mypdkapi/model/src/main/smithy/main.smithy y haga un cambio en el código para enlazar la operación. Puede mostrar la operación Calculate definida en /calculate.smithy incluyéndola en el campo operations de este archivo.

   Ejemplo:

   $version: "2"
   namespace com.aws
   
   use aws.protocols#restJson1
   
   /// A sample smithy api
   @restJson1
   service MyPDKApi {
       version: "1.0"
       operations: [Calculate]
       errors: [
         BadRequestError
         NotAuthorizedError
         InternalFailureError
       ]
   }

5. Compile los cambios ejecutando el siguiente comando:

   npx projen build

   nota

   Si lo desea, puede pasar un indicador --parallel X, que distribuirá la compilación entre los núcleos X.

   Como se ha añadido la característica @handler, se generan los siguientes archivos tras completar la compilación:

   • /packages/apis/mypdkapi/handlers/typescript/src/calculate.ts

   • /packages/apis/mypdkapi/handlers/typescript/test/calculate.test.ts

6. Vaya a packages/apis/mypdkapi/handlers/typescript/src/calculate.ts y haga cambios en el código. Este archivo es el controlador del servidor que se invoca para la API.

   import {
     calculateHandler,
     CalculateChainedHandlerFunction,
     INTERCEPTORS,
     Response,
     LoggingInterceptor,
   } from 'mypdkapi-typescript-runtime';
   
   /**
    * Type-safe handler for the Calculate operation
    */
   export const calculate: CalculateChainedHandlerFunction = async (request) => {
     LoggingInterceptor.getLogger(request).info('Start Calculate Operation');
   
     const { input } = request;
   
     return Response.success({
       result: input.body.numberA + input.body.numberB,
     });
   };
   
   /**
    * Entry point for the AWS Lambda handler for the Calculate operation.
    * The calculateHandler method wraps the type-safe handler and manages marshalling inputs and outputs
    */
   export const handler = calculateHandler(...INTERCEPTORS, calculate);

7. Vaya al archivo /packages/apis/mypdkapi/handlers/typescript/test/calculate.test.ts y haga cambios en el código para actualizar las pruebas unitarias.

   Ejemplo:

   import {
     CalculateChainedRequestInput,
     CalculateResponseContent,
   } from 'mypdkapi-typescript-runtime';
   import {
     calculate,
   } from '../src/calculate';
   
   // Common request arguments
   const requestArguments = {
     chain: undefined as never,
     event: {} as any,
     context: {} as any,
     interceptorContext: {
       logger: {
         info: jest.fn(),
       },
     },
   } satisfies Omit<CalculateChainedRequestInput, 'input'>;
   
   describe('Calculate', () => {
   
     it('should return correct sum', async () => {
       const response = await calculate({
         ...requestArguments,
         input: {
           requestParameters: {},
           body: {
             numberA: 1,
             numberB: 2
           }
         },
       });
   
       expect(response.statusCode).toBe(200);
       expect((response.body as CalculateResponseContent).result).toEqual(3);
     });
   
   });

8. Vaya al archivo /packages/infra/main/src/constructs/apis/mypdkapi.ts y haga cambios en el código para añadir una integración a la operación Calculate en su infraestructura de CDK. El constructo de la API tiene una propiedad de integraciones en la que puede transferir la implementación que ha añadido anteriormente. Como está usando la característica @handler en el modelo de Smithy para la operación Calculate, puede usar el constructo de CDK CalculateFunction generado, que está preconfigurado, para apuntar a la implementación del controlador.

   Ejemplo:

   import { UserIdentity } from "@aws/pdk/identity";
   import { Authorizers, Integrations } from "@aws/pdk/type-safe-api";
   import { Stack } from "aws-cdk-lib";
   import { Cors } from "aws-cdk-lib/aws-apigateway";
   import {
     AccountPrincipal,
     AnyPrincipal,
     Effect,
     PolicyDocument,
     PolicyStatement,
   } from "aws-cdk-lib/aws-iam";
   import { Construct } from "constructs";
   import { Api, CalculateFunction } from "calculateapi-typescript-infra";
   
   /**
    * Api construct props.
    */
   export interface CalculateApiProps {
     /**
      * Instance of the UserIdentity.
      */
     readonly userIdentity: UserIdentity;
   }
   
   /**
    * Infrastructure construct to deploy a Type Safe API.
    */
   export class CalculateApi extends Construct {
     /**
      * API instance
      */
     public readonly api: Api;
   
     constructor(scope: Construct, id: string, props?: CalculateApiProps) {
       super(scope, id);
   
       this.api = new Api(this, id, {
         defaultAuthorizer: Authorizers.iam(),
         corsOptions: {
           allowOrigins: Cors.ALL_ORIGINS,
           allowMethods: Cors.ALL_METHODS,
         },
         integrations: {
           calculate: {
             integration: Integrations.lambda(new CalculateFunction(this, "CalculateFunction"))
           }
         },
         policy: new PolicyDocument({
           statements: [
             // Here we grant any AWS credentials from the account that the prototype is deployed in to call the api.
             // Machine to machine fine-grained access can be defined here using more specific principals (eg roles or
             // users) and resources (ie which api paths may be invoked by which principal) if required.
             // If doing so, the cognito identity pool authenticated role must still be granted access for cognito users to
             // still be granted access to the API.
             new PolicyStatement({
               effect: Effect.ALLOW,
               principals: [new AccountPrincipal(Stack.of(this).account)],
               actions: ["execute-api:Invoke"],
               resources: ["execute-api:/*"],
             }),
             // Open up OPTIONS to allow browsers to make unauthenticated preflight requests
             new PolicyStatement({
               effect: Effect.ALLOW,
               principals: [new AnyPrincipal()],
               actions: ["execute-api:Invoke"],
               resources: ["execute-api:/*/OPTIONS/*"],
             }),
           ],
         }),
       });
   
       // Grant authenticated users access to invoke the api
       props?.userIdentity.identityPool.authenticatedRole.addToPrincipalPolicy(
         new PolicyStatement({
           effect: Effect.ALLOW,
           actions: ["execute-api:Invoke"],
           resources: [this.api.api.arnForExecuteApi("*", "/*", "*")],
         }),
       );
     }
   }

9. Compile los cambios ejecutando el siguiente comando:

   npx projen build

• Confirme e inserte los cambios en la ramificación de características ejecutando los siguientes comandos:

  git add .

  git commit -m "my commit message"

  git push

1. En el proyecto monorepo, lleve a cabo una de las siguientes acciones:

   • En el panel de navegación, seleccione Código, seleccione Solicitudes de extracción y seleccione Crear solicitud de extracción.

   • En la página de inicio del repositorio, seleccione Más y, después, seleccione Crear solicitud de extracción.

   • En la página del proyecto, seleccione Crear solicitud de extracción.

2. En Repositorio de origen, asegúrese de que el repositorio de código fuente especificado sea el que contenga el código confirmado. Esta opción solo aparece si no ha creado la solicitud de extracción desde la página principal del repositorio.

3. En Ramificación de destino, elija la ramificación principal en la que quiera combinar el código después de revisarlo.

4. En Ramificación de origen, elija la ramificación de características que contenga el código confirmado.

5. En Título de la solicitud de extracción, introduzca un título que ayude a otros usuarios a entender qué es lo que hay que revisar y por qué.

6. (Opcional) En Descripción de la solicitud de extracción, proporcione información, como un enlace a las incidencias o una descripción de los cambios.

   sugerencia

   Puede elegir Escribir descripción automáticamente para que CodeCatalyst genere automáticamente una descripción de los cambios incluidos en la solicitud de extracción. Puede realizar cambios en la descripción generada automáticamente después de añadirla a la solicitud de extracción.

   Esta funcionalidad requiere que las características de IA generativa estén habilitadas en el espacio. Para obtener más información, consulte Managing generative AI features in Amazon CodeCatalyst.

7. En Problemas, elija Vincular problemas y, a continuación, elija el problema que creó en Paso 2: crear problemas para colaborar y hacer un seguimiento del trabajo. Para desvincular un problema, seleccione el icono de desvinculación.

8. (Opcional) En Revisores obligatorios, seleccione Agregar revisores obligatorios. Elija en la lista miembros del proyecto para añadirlos. Los revisores obligatorios deben aprobar los cambios antes de poder combinar la solicitud de extracción en la ramificación de destino.

   nota

   No es posible añadir un revisor como revisor obligatorio y como revisor opcional. No es posible añadirse a uno mismo como revisor.

9. (Opcional) En Revisores opcionales, seleccione Agregar revisores opcionales. Elija en la lista miembros del proyecto para añadirlos. No es obligatorio que los revisores opcionales aprueben los cambios para poder combinar la solicitud de extracción en la ramificación de destino.

10. Los revisores o usted mismo deberán revisar la solicitud de extracción y combinarla en la ramificación principal. Para obtener más información, consulte Combinación de una solicitud de extracción.

    Cuando los cambios se combinen en la ramificación principal del repositorio de código fuente, se desencadenará automáticamente un nuevo flujo de trabajo.

11. Tras finalizar la combinación, podrá mover el problema a Listo.

    1. En el panel de navegación, elija Problemas.

    2. Seleccione el problema creado en Paso 2: crear problemas para colaborar y hacer un seguimiento del trabajo, seleccione el menú desplegable Estado y, a continuación, elija Listo.

1. En el panel de navegación del proyecto monorepo, elija CI/CD y, a continuación, Flujos de trabajo.

2. Para el flujo de trabajo de publicación, seleccione la última ejecución del flujo de trabajo para ver sus detalles. Para obtener más información, consulte Visualización del estado y los detalles de una sola ejecución.

3. Cuando la ejecución del flujo de trabajo se haya completado correctamente, elija la última acción del flujo de trabajo (por ejemplo, Deploy-Beta-ap-souteast-2) y seleccione Variables.

4. Para ver el sitio web implementado, copie y pegue el enlace de la fila MyPDKApiwebsiteDistributionDomainNameXXXXX en una nueva ventana del navegador.

5. Introduzca el nombre de usuario y la contraseña de Paso 6: confirmar el flujo de trabajo de publicación y visualizar el sitio web y seleccione Iniciar sesión.

6. (Opcional) Pruebe los cambios en la aplicación.

   1. Seleccione el menú desplegable POST.

   2. Introduzca dos valores para numberA y number B; luego, seleccione Ejecutar.

   3. Confirme los resultados en Cuerpo de respuesta.