Los administradores crean plantillas de aplicaciones para garantizar que cada equipo de desarrollo use la arquitectura que prefieren. Esto te ayuda a controlar los recursos y la configuración que los desarrolladores usan en las implementaciones de sus aplicaciones.
Una vez que crees una plantilla de aplicación, otras personas de tu espacio podrán acceder a ella. También puedes agregar una plantilla a un catálogo para compartirla con otros espacios.
Los desarrolladores pueden usar tu plantilla para crear e implementar una aplicación. Cuando los desarrolladores crean una aplicación, pueden configurar cada componente de la plantilla, pero no pueden agregar ni quitar componentes. La plantilla genera código de Terraform, que los desarrolladores pueden descargar o implementar desde el Centro de diseño de aplicaciones.
En este documento, se explica cómo diseñar, configurar y compartir una plantilla de aplicación con App Design Center.
Antes de comenzar
Debes tener uno de los siguientes roles en la carpeta habilitada para la app o en el proyecto de administración:
- Administrador del Centro de diseño de aplicaciones (
roles/designcenter.admin) - Usuario del Centro de diseño de aplicaciones (
roles/designcenter.user)
Crea una plantilla de aplicación
Crea plantillas de aplicaciones para compartir el diseño de tu arquitectura con los equipos de desarrollo. Puedes agregar los siguientes componentes al diseño de tu plantilla:
Recursos: Son recursos de alto nivel que te ayudan a controlar otros recursos. Por ejemplo, las cuentas de servicio.
Servicios: Son interfaces de red o de API que se consumen a través de la red. Algunos ejemplos son Cloud Storage y Vertex AI.
Cargas de trabajo: Son implementaciones binarias que realizan funciones comerciales. Entre los ejemplos, se incluyen Cloud Run y Compute Engine.
Puedes seleccionar entre los siguientes componentes:
- Componentes diseñados por Google que incorporan Google Cloud prácticas recomendadas y configuraciones de seguridad predeterminadas.
- Tus propios componentes que importas, basados en tus propios módulos de Terraform
A medida que diseñes tu plantilla, el Centro de diseño de apps generará código de Terraform para reflejar los detalles de diseño y configuración.
Especifica los detalles de la plantilla
Los detalles de la plantilla te ayudan a categorizarla y a que los desarrolladores decidan si usarla.
Para ingresar los detalles de tu plantilla, haz lo siguiente:
En el menú de navegación, haz clic en Plantillas.
Haz clic en Crear Plantilla.
En el campo ID de plantilla, ingresa un identificador único para la plantilla. Este campo es obligatorio.
En el campo Nombre de la plantilla, ingresa un identificador legible para mostrar en la consola de Google Cloud .
Si no proporcionas un nombre, se copiará el ID de la plantilla en este campo.
En el campo Descripción, ingresa una breve explicación del propósito de la aplicación.
Haz clic en Crear Plantilla. Se muestra el lienzo de diseño.
Diseña tu plantilla
Diseña tu plantilla agregando y conectando componentes en el lienzo de diseño. En el siguiente ejemplo, se incluyen tres componentes conectados.
Puedes diseñar tu plantilla agregando componentes a los siguientes puntos de partida:
- Un lienzo en blanco.
- Una plantilla proporcionada por Google
- Una plantilla que generas con la asistencia de Gemini
Para diseñar tu plantilla, haz lo siguiente:
En el lienzo de diseño, asegúrate de que esté seleccionada la opción Diseño.
Para comenzar, realiza una de las siguientes acciones:
Para comenzar desde cero, en el área Componentes, haz clic en un componente para agregarlo al área del lienzo.
Para comenzar con una plantilla proporcionada por Google, haz clic en el nombre de la plantilla.
Para usar el chat en lenguaje natural y generar una plantilla, haz clic en Custom Application with Gemini.
Para crear un canal de comunicación entre componentes, haz una de las siguientes acciones:
Para conectar dos componentes en el lienzo, arrastra desde un punto azul de un componente hasta un punto azul de otro componente.
Para agregar 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.
Para quitar un componente o una conexión, haz lo siguiente:
En el lienzo, haz clic en el componente o la conexión.
En el área Configuración, haz clic en Borrar.
En el campo, ingresa delete.
Haz clic en Borrar.
Configura valores predeterminados para los componentes
Para cada componente que agregues al lienzo, puedes especificar detalles de configuración, como el proyecto en el que se crea el recurso y la ubicación en la que se implementa. Si especificas detalles de configuración, el Centro de diseño de aplicaciones los usará como valores predeterminados para las aplicaciones.
También puedes modificar los detalles de la conexión si la configuración predeterminada no cumple con tus requisitos. Por ejemplo, puedes modificar los nombres de las claves de las variable de entorno, cambiar los puertos de conexión o agregar roles adicionales a las cuentas de servicio.
Antes de implementar una aplicación, los desarrolladores 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:
En el lienzo de diseño, haz clic en un componente.
En el área Configuración, en la lista ID del proyecto, selecciona el proyecto en el que deseas implementar el recurso. Selecciona un proyecto que cumpla con los siguientes requisitos:
El proyecto debe ser un elemento secundario de la carpeta habilitada para apps seleccionada.
El proyecto no debe ser un proyecto de administración.
Configura parámetros adicionales para el recurso. Por ejemplo, para Cloud SQL, puedes configurar lo siguiente:
- Región
- Configuración de las copias de seguridad
- Marcas de la base de datos
- Configuración de IP
Para obtener vínculos a la documentación de configuración de cada componente, consulta Recursos compatibles.
Cuando conectas componentes en el lienzo de diseño, se usan valores de configuración predeterminados para crear la conexión. Para agregar o modificar los detalles de conexión, haz lo siguiente.
En el lienzo de diseño, haz clic en la conexión entre dos componentes. Se abrirá el panel Connection y se mostrarán los parámetros de conexión.
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.
Actualiza los campos Clave y Valor. Por ejemplo, es posible que desees modificar los siguientes detalles:
- Nombres de claves de variables de entorno para alinearse con los requisitos de tu aplicación
- Es el valor del puerto de conexión.
- Son los roles que se agregaron a una cuenta de servicio.
Haz clic en Guardar.
Edita el código de Terraform
A medida que diseñas tu plantilla de aplicación, Application Design Center genera código de Terraform para reflejar los detalles de diseño y configuración. Puedes editar Terraform para especificar los detalles de configuración de los componentes.
El sistema genera los siguientes archivos de Terraform:
main.tf: Es el código de infraestructura que incluye un módulo para cada componente de la plantilla.outputs.tf: Expone información sobre los componentes de infraestructura que se implementan.variables.tf: Declara el nombre, el tipo y la descripción de las variables que se usan en el archivomain.tf.input.tfvars: Define valores para las variables que se usan en el archivomain.tf.providers.tf: Define etiquetas que ayudan a Terraform a interactuar con las APIs y los recursos de Google Cloud .
Para obtener información general, consulta Descripción general de Terraform enGoogle Cloud.
Para editar el código de Terraform, haz lo siguiente:
En el lienzo de diseño, haz clic en Código. El sistema muestra los archivos de Terraform generados.
Haz clic en main.tf. El sistema muestra el módulo de Terraform para cada componente.
Edita los detalles de la configuración. Para obtener más información, consulta la documentación de configuración de cada recurso compatible.
El sistema valida automáticamente tus ediciones y muestra errores si no son válidas.
Para destacar y comparar tus ediciones, haz lo siguiente:
Haz clic en Ver diferencia.
Para revertir un cambio, haz clic en Click to revert change en el margen.
Haz clic en Ver diferencias para cerrar la vista de comparación.
Para guardar los cambios, haz clic en Save code changes.
Para verificar tus cambios, haz lo siguiente.
- Haz clic en Diseño.
- Haz clic en un componente y revisa los detalles de su configuración.
Cómo borrar una plantilla
Si ya no necesitas una plantilla, puedes borrarla.
- En el lienzo de diseño, haz clic en Acciones.
- Haz clic en Borrar.
Verifica tu plantilla
Antes de compartir tu plantilla con los desarrolladores, asegúrate de que funcione como esperabas. Para verificar tu plantilla, haz lo siguiente:
- Crea una aplicación con la siguiente configuración:
- En la lista Entorno, selecciona TEST.
- En la lista Criticality, selecciona LOW.
- Implemente la aplicación. Para conocer los pasos de implementación, consulta Implementa una aplicación desde la consola.
- Prueba tu infraestructura para asegurarte de que cumpla con tus requisitos.
- Para evitar costos recurrentes, borra la implementación de prueba.
Cómo compartir una plantilla en un catálogo
Una vez que hayas verificado tu plantilla, podrás publicarla en un catálogo. Los desarrolladores de aplicaciones que tengan acceso a un espacio en el que se comparta el catálogo pueden usar la plantilla.
- En el lienzo de diseño, haz clic en Agregar al catálogo.
- 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 las necesidades de tu empresa, es posible que desees actualizar la plantilla de la aplicación. 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 la plantilla. Para aplicar los cambios a las aplicaciones existentes, los desarrolladores deben implementar las aplicaciones con la revisión.
El Centro de diseño de aplicaciones 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:
En el menú de navegación, haz clic en Plantillas.
Selecciona la plantilla de la aplicación que deseas revisar. Se abrirá el lienzo.
Modifica la plantilla para que se ajuste a tus nuevos requisitos. Por ejemplo, agregar y configurar un componente nuevo
Para compartir la revisión más reciente con otros espacios, vuelve a agregar la plantilla a los catálogos pertinentes.
¿Qué sigue?
Para compartir plantillas con otros espacios, crea y comparte un catálogo.
Para usar tus propios módulos de Terraform en el diseño de la plantilla de la aplicación, importa componentes.
Antes de implementar, crea una aplicación.