Diseña plantillas compuestas

Vista previa

Este producto o función está sujeto a las "Condiciones de la oferta previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Los productos y las funciones de la fase previa a la DG están disponibles “tal como están” y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Las plantillas compuestas en Application Design Center te permiten compilar aplicaciones complejas conectando plantillas de aplicaciones estándar reutilizables y componentes individuales. Un diseño modular permite que los equipos desarrollen componentes básicos en paralelo y actualicen bloques individuales sin volver a implementar toda la aplicación. También puedes asignar cuentas de servicio distintas para restringir los permisos de implementación de cada componente. Además, las plantillas compuestas te permiten modelar y empaquetar unidades de implementación para una oferta de SaaS en App Lifecycle Manager.

Antes de comenzar

Para realizar las tareas de este documento, pídele a tu administrador que te otorgue los roles necesarios en la carpeta habilitada para apps o el proyecto de administración, como se indica en la siguiente tabla:

Tarea	Roles obligatorios
Crear, diseñar y editar plantillas compuestas	Administrador de Application Design Center (roles/designcenter.admin) o Usuario de Application Design Center (roles/designcenter.user)
Publica o comparte plantillas compuestas en un catálogo	Administrador de Application Design Center (roles/designcenter.admin)

Para obtener más información sobre los roles, consulta Control de acceso con IAM.

Para usar tus propias plantillas de aplicación estándar como componentes básicos, establece variables de entrada y salida para establecer variables configurables y crea conexiones entre tus plantillas de aplicación. Si deseas obtener más información, consulta los siguientes recursos:

• Diseña plantillas de aplicaciones estándar
• Comparte una plantilla en un catálogo

Crea una plantilla de aplicación compuesta

Crea plantillas compuestas cuando quieras diseñar y compartir aplicaciones complejas. Puedes agregar y conectar los siguientes elementos en el diseño de tu plantilla:

• Plantillas de aplicación estándar: Selecciona una de las siguientes plantillas existentes:

  • Plantillas diseñadas por Google, que incorporan las prácticas recomendadas de Google Cloud y los parámetros de configuración de seguridad predeterminados.
  • Plantillas que creaste anteriormente y agregaste al catálogo de tu espacio

• Componentes: Selecciona entre los siguientes recursos de Google Cloud :

  • Componentes diseñados por Google, que incorporan las prácticas recomendadas de Google Cloud y las configuraciones de seguridad predeterminadas.
  • Tus propios componentes que importas, según tus propios módulos de Terraform.

Especifica los detalles de la plantilla

Los detalles de la plantilla te ayudan a categorizarla y ayudan a los desarrolladores a decidir si deben usarla.

Para ingresar los detalles de tu plantilla, haz lo siguiente:

Lienzo de diseño

1. En el menú de navegación, haz clic en Plantillas.

   Ir a Plantillas

2. En la lista Región, selecciona la ubicación de la plantilla. Si planeas crear una implementación escalada en App Lifecycle Manager, selecciona global.

3. En la lista Crear plantilla, selecciona Plantilla compuesta.

4. El campo ID de plantilla se completa automáticamente. Como alternativa, ingresa un identificador único para la plantilla. Este campo es obligatorio.

5. En el campo Nombre de la plantilla, ingresa un identificador legible por humanos para mostrarlo en la consola de Google Cloud .

   Si no proporcionas un nombre, el ID de la plantilla se copiará en este campo.

6. En el campo Descripción, ingresa una explicación breve del propósito de la aplicación.

7. Haz clic en Crear Plantilla. Se muestra el lienzo de diseño.

gcloud CLI

Crea una nueva plantilla de aplicación compuesta.

gcloud design-center spaces application-templates create APPLICATION_TEMPLATE \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--display-name=DISPLAY_NAME \
--description=DESCRIPTION \
--composition-type=COMPOSITE

Reemplaza lo siguiente:

• APPLICATION_TEMPLATE: Es el ID de la plantilla de aplicación que deseas crear.
• PROJECT: Es el ID de tu proyecto de administración.
• LOCATION: Es la región de la plantilla de aplicación. Si planeas crear una implementación escalada en App Lifecycle Manager, usa global.
• SPACE: Es el ID de tu espacio.
• DISPLAY_NAME: Es un nombre que se mostrará en la consola de Google Cloud .
• DESCRIPTION: Es una descripción breve.

Para obtener más información, consulta gcloud design-center spaces application-templates create.

Diseña tu plantilla

Diseña tu plantilla compuesta agregando y conectando plantillas y componentes de aplicaciones estándar a los siguientes puntos de partida:

• Un lienzo en blanco.
• Una plantilla proporcionada por Google
• Una plantilla que generas con la asistencia de Gemini

A medida que diseñas tu plantilla, App Design Center genera código de Terraform para reflejar los detalles de diseño y configuración.

Para diseñar tu plantilla, haz lo siguiente:

Lienzo de diseño

1. En el lienzo de diseño, selecciona Design para ver el lienzo.

2. Para comenzar, realiza una de las siguientes acciones:

   • Para comenzar con una plantilla proporcionada por Google, en el área Comenzar del lienzo, haz clic en el nombre de la plantilla.

   • Para comenzar desde un lienzo en blanco, continúa con el siguiente paso.

3. Para agregar una plantilla de aplicación estándar al lienzo, haz lo siguiente:

   1. En el área Componentes, haz clic en Incorporar plantillas.

   2. Para agregar una plantilla existente, haz clic en una de las siguientes listas:

      • Plantillas: Son plantillas de aplicaciones estándar que se encuentran en el catálogo de tu espacio o que se compartieron con él.
      • Plantillas de Google: Son plantillas de aplicación estándar creadas por Google y agregadas al catálogo de Google.

   3. Para agregar la plantilla seleccionada al lienzo, haz clic en Seleccionar.

4. Para crear una plantilla de aplicación estándar nueva, haz clic en Crear una plantilla nueva. Se abrirá la página Crear plantilla nueva.

   Para obtener más información, consulta Diseña plantillas de aplicación estándar.

5. Para agregar un componente al lienzo, haz clic en un componente en el área Componentes.

6. Para crear un canal de comunicación entre las plantillas y los componentes, realiza una de las siguientes acciones:

   • Arrastra desde un punto azul de un componente básico hasta un punto azul de otro componente básico.

   • Para agregar un componente conectado a un componente existente, haz clic en Agregar y selecciona el componente que deseas agregar.

   Para obtener detalles de la conexión, consulta la documentación de configuración de cada recurso compatible.

7. Para quitar un componente o una conexión, haz lo siguiente:

   1. En el lienzo, haz clic en el componente básico o la conexión.

   2. En el área Configuración, haz clic en Borrar.

   3. En el campo, ingresa delete.

   4. Haz clic en Borrar.

gcloud CLI

1. Identifica los URI de revisión de plantilla para los componentes básicos en el catálogo de tu espacio.

   gcloud design-center spaces shared-templates list \
   --project=PROJECT \
   --location=LOCATION \
   --space=SPACE
   

   Reemplaza lo siguiente:

   • PROJECT: Es el ID de tu proyecto de administración.
   • LOCATION: Es la región de la plantilla de aplicación.
   • SPACE: Es el ID de tu espacio.

   Para obtener más información, consulta gcloud design-center spaces shared-templates list.

2. Identifica los URI de revisión de plantillas para los componentes básicos del catálogo de Google que deseas agregar a la plantilla.

   gcloud design-center spaces shared-templates list \
   --google-catalog \
   --location=us-central1
   

   Para obtener más información, consulta gcloud design-center spaces shared-templates list.

3. Agrega una plantilla o un componente de aplicación estándar a tu plantilla compuesta.

   gcloud design-center spaces application-templates components create COMPONENT \
   --project=PROJECT \
   --location=LOCATION \
   --space=SPACE \
   --application-template=APPLICATION_TEMPLATE \
   --shared-template-revision-uri=SHARED_TEMPLATE_URI
   

   Reemplaza lo siguiente:

   • COMPONENT: Es el ID de la plantilla o el componente de la aplicación estándar que deseas agregar a la plantilla.
   • PROJECT: Es el ID de tu proyecto de administración.
   • LOCATION: Es la región de la plantilla de aplicación.
   • SPACE: Es el ID de tu espacio.
   • APPLICATION_TEMPLATE: Es el ID de la plantilla de aplicación compuesta a la que agregarás la plantilla o el componente de aplicación estándar.
   • SHARED_TEMPLATE_URI: Es el URI de la plantilla de aplicación estándar o de la plantilla compartida de componentes. Por ejemplo, projects/my-project/locations/us-central1/spaces/my-space/sharedTemplates/my-shared-template/revisions/rev1

   Para obtener más información, consulta gcloud design-center spaces application-templates components create.

4. Agrega una segunda plantilla o componente de aplicación estándar a tu plantilla.

   gcloud design-center spaces application-templates components create COMPONENT_2 \
   --project=PROJECT \
   --location=LOCATION \
   --space=SPACE \
   --application-template=APPLICATION_TEMPLATE \
   --shared-template-revision-uri=SHARED_TEMPLATE_URI_2
   

   Reemplaza lo siguiente:

   • COMPONENT_2: Es el ID de la segunda plantilla o componente de aplicación estándar que deseas agregar a la plantilla.
   • PROJECT: Es el ID de tu proyecto de administración.
   • LOCATION: Es la región de la plantilla de aplicación.
   • SPACE: Es el ID de tu espacio.
   • APPLICATION_TEMPLATE: Es el ID de la plantilla compuesta a la que agregarás la plantilla o el componente de aplicación estándar.
   • SHARED_TEMPLATE_URI_2: Es el URI de la segunda plantilla de aplicación estándar o plantilla compartida de componente. Por ejemplo, projects/my-project/locations/us-central1/spaces/my-space/sharedTemplates/my-shared-template/revisions/rev1

   Para obtener más información, consulta gcloud design-center spaces application-templates components create.

5. Crea una conexión entre las plantillas o los componentes de la aplicación estándar.

   gcloud design-center spaces application-templates components connections create CONNECTION \
   --project=PROJECT \
   --location=LOCATION \
   --space=SPACE \
   --application-template=APPLICATION_TEMPLATE \
   --component=COMPONENT \
   --destination-component-uri=COMPONENT_2
   

   Reemplaza lo siguiente:

   • CONNECTION: Es el ID de la conexión que deseas agregar a la plantilla.
   • PROJECT: Es el ID de tu proyecto de administración.
   • LOCATION: Es la región de la plantilla de aplicación.
   • SPACE: Es el ID de tu espacio.
   • APPLICATION_TEMPLATE: Es el ID de la plantilla de aplicación en la que agregarás la conexión.
   • COMPONENT: Es el ID del componente o de la plantilla de aplicación estándar de origen.
   • COMPONENT_2: Es el ID del componente o de la plantilla de aplicación estándar de destino.

   Para obtener más información, consulta gcloud design-center spaces application-templates components connections create.

Configura valores predeterminados para los componentes

Para cada componente que agregues a una plantilla, puedes especificar detalles de configuración predeterminados, como el proyecto del recurso y la ubicación de la implementación. Application Design Center aplica estos valores predeterminados cuando se crea una aplicación a partir de esta plantilla.

Los desarrolladores de aplicaciones también pueden modificar los detalles de la conexión si la configuración predeterminada no cumple con sus requisitos. Por ejemplo, puedes modificar los nombres de las claves de variable de entorno, cambiar los puertos de conexión o agregar roles adicionales a las cuentas de servicio cuando creas una aplicación.

Antes de que los desarrolladores implementen una aplicación, pueden ver y modificar los valores predeterminados que configuraste en la plantilla. Los desarrolladores deben configurar los detalles necesarios para cada recurso compatible.

Para configurar componentes y conexiones, haz lo siguiente:

Lienzo de diseño

1. En el lienzo de diseño, haz clic en un componente.

2. En el área Configuración, en la lista ID del proyecto, selecciona el proyecto en el que deseas implementar el recurso. Selecciona un proyecto con las siguientes características:

   • El proyecto debe estar dentro de la carpeta habilitada para apps seleccionada.

   • El proyecto no debe ser un proyecto de administración.

3. Establece parámetros de configuración adicionales para el recurso. Por ejemplo, para Cloud SQL, puedes configurar lo siguiente:

   • Región
   • Configuración de las copias de seguridad
   • Marcas de bases de datos
   • Configuración de IP

   Para obtener vínculos a la documentación de configuración de cada componente, consulta Recursos compatibles.

4. Cuando conectas componentes en el lienzo de diseño, se usan los valores de configuración predeterminados para crear la conexión. Para agregar o modificar los detalles de la conexión, haz lo siguiente.

   1. En el lienzo de diseño, haz clic en la conexión entre dos componentes. Se abrirá el panel Conexión y se mostrarán los parámetros de conexión.

   2. Realiza una de las siguientes acciones:

      • Para modificar un parámetro de conexión existente, haz clic en Editar.

      • Para agregar un parámetro de conexión nuevo, haz clic en Agregar parámetro.

   3. Actualiza los campos Clave y Valor. Por ejemplo, es posible que quieras modificar los siguientes detalles:

      • Los nombres de las claves de variable de entorno para que se alineen con los requisitos de tu aplicación.
      • Es el valor del puerto de conexión.
      • Los roles que se agregan a una cuenta de servicio.

5. Haz clic en Guardar.

gcloud CLI

1. Describe cada componente de la plantilla de aplicación para ver sus parámetros.

   gcloud design-center spaces application-templates components describe COMPONENT \
   --project=PROJECT \
   --location=LOCATION \
   --space=SPACE \
   --application-template=APPLICATION_TEMPLATE
   

   Reemplaza lo siguiente:

   • COMPONENT: Es el ID del componente que deseas describir.
   • PROJECT: Es el ID de tu proyecto de administración.
   • LOCATION: Es la región de la plantilla de aplicación.
   • SPACE: Es el ID de tu espacio.
   • APPLICATION_TEMPLATE: Es el ID de la plantilla de la aplicación.

   Para obtener más información, consulta gcloud design-center spaces application-templates components describe.

2. Para cada componente que desees modificar, crea un archivo JSON en tu directorio principal que contenga los valores de los parámetros.

   Por ejemplo, puedes crear el siguiente archivo para un componente de Cloud Run:

     [
         {
           "key": "service_name",
           "value": "frontend-service"
         },
         {
           "key": "project_id",
           "value": "DEPLOYMENT_PROJECT"
         }
     ]
   

3. Actualiza cada componente de la plantilla de la aplicación para configurar los parámetros obligatorios.

   gcloud design-center spaces application-templates components update COMPONENT \
   --project=PROJECT \
   --location=LOCATION \
   --space=SPACE \
   --parameters=PARAMETERS_FILE_PATH \
   --application-template=APPLICATION_TEMPLATE
   

   Reemplaza lo siguiente:

   • COMPONENT: Es el ID del componente que deseas actualizar.
   • PROJECT: Es el ID de tu proyecto de administración.
   • LOCATION: Es la región de la plantilla de aplicación.
   • SPACE: Es el ID de tu espacio.
   • PARAMETERS_FILE_PATH: Es un archivo JSON que incluye parámetros de componentes.
   • APPLICATION_TEMPLATE: Es el ID de la plantilla de la aplicación.

   Para obtener más información, consulta gcloud design-center spaces application-templates components update.

4. Describen las conexiones de los componentes.

   gcloud design-center spaces application-templates components connections describe CONNECTION \
   --component=COMPONENT \
   --application-template=APPLICATION_TEMPLATE \
   --project=PROJECT \
   --location=LOCATION \
   --space=SPACE
   

   Reemplaza lo siguiente:

   • CONNECTION: El ID de la conexión.
   • COMPONENT: Es el ID del componente.
   • APPLICATION_TEMPLATE: Es el ID de la plantilla.
   • PROJECT: Es el ID de tu proyecto de administración.
   • LOCATION: Es la región de la plantilla de aplicación.
   • SPACE: Es el ID de tu espacio.

   Para obtener más información, consulta gcloud design-center spaces application-templates components connections describe.

5. Editar los parámetros de conexión del componente

   gcloud design-center spaces application-templates components connections update CONNECTION \
   --component=COMPONENT \
   --application-template=APPLICATION_TEMPLATE \
   --project=PROJECT \
   --location=LOCATION \
   --space=SPACE \
   --source-component-parameters='[{"key": SOURCE_KEY, "value": SOURCE_VALUE}]'
   

   Reemplaza lo siguiente:

   • CONNECTION: El ID de la conexión.
   • COMPONENT: Es el ID del componente.
   • APPLICATION_TEMPLATE: Es el ID de la plantilla.
   • PROJECT: Es el ID de tu proyecto de administración.
   • LOCATION: Es la región de la plantilla de aplicación.
   • SPACE: Es el ID de tu espacio.
   • SOURCE_KEY: Es la clave del parámetro nuevo.
   • SOURCE_VALUE: Es el valor nuevo del parámetro.

   Para obtener más información, consulta gcloud design-center spaces application-templates components connections update.

Configura plantillas de aplicación estándar

Cuando los desarrolladores implementan tu plantilla compuesta como una aplicación, se crea una aplicación para cada uno de los siguientes elementos:

• Cada grupo de plantillas de aplicación estándar.
• Cada grupo de componentes.

Puedes proporcionar valores predeterminados para cada grupo. Por ejemplo, puedes incluir el proyecto de implementación, la región y los propietarios. Cuando los desarrolladores implementan la aplicación en App Design Center, pueden usar los valores predeterminados o especificar sus propios detalles para cada aplicación.

Para proporcionar detalles predeterminados de la aplicación para cada grupo, haz lo siguiente:

Lienzo de diseño

1. En el lienzo de diseño, haz clic en una plantilla de aplicación estándar.

   Se abrirá el panel Plantilla incorporada.

2. En el área Configuración, ingresa los detalles de la aplicación.

   Para obtener más información, consulta Cómo crear un borrador de aplicación.

gcloud CLI

Para obtener más información, consulta Diseña tu plantilla.

Verifica tu plantilla

Antes de compartir tu plantilla compuesta con los desarrolladores, impleméntala y verifícala en App Design Center. Este paso te ayuda a verificar la funcionalidad antes de una implementación escalada en varias máquinas.

Para verificar tu plantilla, haz lo siguiente:

1. En el lienzo de diseño, haz clic en Continuar y selecciona Crear aplicación para implementar.

   Se abrirá el panel Crea una aplicación.

2. En el área Detalles de la aplicación compuesta, ingresa los detalles de la aplicación.

   Para obtener más información, consulta Cómo crear un borrador de aplicación.

3. Haz clic en Siguiente.

4. Para cada componente básico que agregaste a la plantilla compuesta, se creará una aplicación cuando realices la implementación. Configura cada aplicación y haz clic en Siguiente.

   Para obtener más información, consulta Cómo crear un borrador de aplicación.

5. Prueba la aplicación implementada para asegurarte de que cumpla con tus requisitos.

6. Para evitar costos recurrentes, borra la implementación de prueba.

Crea un Deployment escalado

Para implementar y administrar varias instancias de tu plantilla compuesta, usa App Lifecycle Manager.

1. Verifica tu plantilla en App Design Center.

2. En el lienzo de diseño, haz clic en Continuar y selecciona Realizar implementaciones a gran escala con App Lifecycle Manager.

   Se abrirá la página Unidades de App Lifecycle Manager.

3. Para conocer los pasos de implementación, consulta Implementa una oferta de SaaS.

Cómo compartir tu plantilla

Para que tu plantilla esté disponible para los desarrolladores, puedes agregarla a un catálogo y compartirla. Cuando agregas una plantilla a un catálogo, esta se encuentra disponible como una fuente de aplicación en los espacios en los que se comparte el catálogo.

Para compartir la plantilla, haz lo siguiente:

1. En el lienzo de diseño, haz clic en Agregar al catálogo.

2. Para administrar los espacios en los que se comparte el catálogo, consulta Administra catálogos.

Revisa y vuelve a compartir tu plantilla

A medida que adquieras experiencia con tu aplicación y evolucionen tus necesidades empresariales, es posible que quieras actualizar tu plantilla. Por ejemplo, puedes decidir mejorar el rendimiento de un servicio de backend agregando un servicio de Memorystore para el almacenamiento en caché.

Cuando modificas una plantilla, creas una revisión de plantilla. Para aplicar los cambios a las aplicaciones existentes, los desarrolladores deben implementar aplicaciones con la revisión.

App Design Center no publica automáticamente las revisiones de plantillas en los catálogos. Para compartir la revisión más reciente, vuelve a publicar la plantilla en el catálogo.

Para crear una revisión nueva, haz lo siguiente:

1. En el menú de navegación, haz clic en Plantillas.

   Ir a Plantillas

2. Selecciona la plantilla de aplicación que quieras revisar. Se abrirá el lienzo.

3. Modifica la plantilla para que se ajuste a tus nuevos requisitos. Por ejemplo, agrega y configura un componente nuevo.

4. Para compartir la revisión más reciente con otros espacios, vuelve a agregar la plantilla a tu catálogo.

Borra una plantilla

Si ya no necesitas una plantilla, puedes borrarla.

Lienzo de diseño

1. En el lienzo de diseño, haz clic en Acciones.
2. Haz clic en Borrar.

gcloud CLI

Borra una plantilla de aplicación.

```sh
gcloud design-center spaces application-templates delete APPLICATION_TEMPLATE \
--project=PROJECT \
--location=LOCATION \
--space=SPACE
```

Reemplaza lo siguiente:

• APPLICATION_TEMPLATE: Es el ID de la plantilla de aplicación que deseas borrar.
• PROJECT: Es el ID de tu proyecto de administración.
• LOCATION: Es la región de la plantilla de aplicación.
• SPACE: Es el ID de tu espacio.

Para obtener más información, consulta gcloud design-center spaces application-templates delete.

¿Qué sigue?

• Implementa tu plantilla compuesta con App Lifecycle Manager implementando una oferta de SaaS.
• Comparte tus plantillas con otros espacios administrando los catálogos de plantillas.
• Usa tus propios módulos de Terraform en tus diseños de plantillas importando componentes.