Configura App Design Center

En este documento, se guía a los administradores en la configuración inicial de App Design Center, que te permite diseñar, compartir y administrar la infraestructura de la nube con un modelo centrado en la aplicación. El proceso de configuración establece lo siguiente:

  • Administración de aplicaciones, que te permite definir el límite de tu aplicación y administrar su ciclo de vida
  • Un espacio inicial en el que tu equipo puede colaborar
  • Un catálogo predeterminado para almacenar plantillas
  • Un catálogo administrado por Google con plantillas basadas en prácticas recomendadas
  • Uno de los siguientes buckets de Cloud Storage para el almacenamiento de Terraform:

Antes de comenzar

Elige una opción de bucket de almacenamiento

Cuando creas plantillas y aplicaciones, App Design Center almacena el código de Terraform en un bucket de Cloud Storage. Elige una de las siguientes opciones de bucket de almacenamiento:

  • Crear automáticamente un bucket nuevo: Realiza la configuración en la consola.
  • Usar un bucket de almacenamiento existente: Completa la configuración con la API de App Design Center.

Puedes usar tu propio bucket si tienes políticas de la organización que te impiden crear buckets nuevos o si tienes prácticas comerciales establecidas que dictan la creación de buckets.

Verifica el acceso al bucket de almacenamiento existente

Para completar la configuración y usar tu propio bucket, verifica lo siguiente:

  1. Tienes acceso para usar las APIs. Para obtener más información, consulta Configura el acceso a la API.

  2. Tu bucket está en el mismo proyecto de administración en el que deseas configurar App Design Center.

  3. Tienes los siguientes permisos en el bucket:

    • storage.buckets.get
    • storage.objects.create

Elige el límite de administración de tu aplicación

Un límite de administración de aplicaciones es un lugar centralizado para las tareas de administración de aplicaciones, incluidas la habilitación de la API , el control de acceso, la facturación y las cuotas. Dentro del límite, puedes supervisar, solucionar problemas, optimizar los costos y administrar tus Google Cloud recursos en el contexto de tu aplicación.

Elige el modelo de límite que se adapte a tu organización:

  • Límite de un solo proyecto (versión preliminar): Es mejor para usuarios nuevos o pequeñas organizaciones en las que todos los recursos residen en un solo proyecto.
  • Límite a nivel de carpeta: Es mejor para organizaciones grandes que administran recursos en varios proyectos y subcarpetas.

En la siguiente tabla, se comparan las funciones de cada modelo de límite:

Función Límite de un solo proyecto (versión preliminar) Límite a nivel de carpeta
Flexibilidad Completa la configuración con la configuración predeterminada.
  • Especifica un nombre para tu espacio.
  • Selecciona si deseas inhabilitar las plantillas proporcionadas por Google.
  • Después de la configuración, crea espacios adicionales en proyectos descendientes.
Productos integrados

Habilitar la administración de aplicaciones

Cuando habilitas la administración de aplicaciones, el sistema realiza una de las siguientes acciones para ayudarte a administrar las cuotas y la facturación de tu aplicación:

  • Un solo proyecto (versión preliminar): El sistema configura tu proyecto como un proyecto de administración.
  • A nivel de carpeta: El sistema crea un nuevo proyecto de administración en la carpeta.

Para habilitar la administración de aplicaciones, haz lo siguiente:

Un solo proyecto (versión preliminar)

  1. Asegúrate de que tu proyecto tenga una cuenta de facturación vinculada.

  2. Asegúrate de tener los roles necesarios para habilitar la administración de aplicaciones y completar la configuración, lo que crea tu espacio.

  3. La administración de aplicaciones se habilita automáticamente en tu proyecto cuando completas la configuración con la consola. Como alternativa, para realizar la configuración con la API de App Design Center, habilita la administración de aplicaciones en tu proyecto.

A nivel de carpeta

  1. Asegúrate de tener un recurso de organización.

  2. Asegúrate de tener los roles necesarios para habilitar la administración de aplicaciones.

  3. Configura una carpeta para la administración de aplicaciones.

  4. Vincula una cuenta de facturación al proyecto de administración.

  5. Configura el alcance de observabilidad para el proyecto de administración.

  6. Asegúrate de tener los roles necesarios para completar la configuración y crear tu espacio.

Verifica los roles de IAM obligatorios

Para realizar la configuración, pídele a tu administrador que te otorgue los roles necesarios en tu proyecto o carpeta de límite, como se indica en la siguiente tabla:

Tarea Roles obligatorios
Realizar la configuración inicial de un solo proyecto Propietario del proyecto (roles/owner) o ambos de los siguientes:
Administrador de App Design Center (roles/designcenter.admin) y
Administrador de Service Usage (roles/serviceusage.serviceUsageAdmin)
Realizar la configuración inicial a nivel de carpeta Ambos de los siguientes:
Administrador de App Design Center (roles/designcenter.admin) y
Administrador de aplicaciones (roles/designcenter.applicationAdmin)

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

Configura App Design Center y crea un bucket de almacenamiento nuevo

El proceso de configuración en la consola crea un bucket de Cloud Storage nuevo para almacenar información de la aplicación. Para usar un bucket existente, consulta Configura App Design Center y usa tu propio bucket de almacenamiento.

Un solo proyecto (versión preliminar)

Para habilitar la administración de aplicaciones en un solo proyecto y configurar App Design Center, haz lo siguiente:

  1. Ve a la página Descripción general de App Design Center.

    Ir a Descripción general

  2. En el selector de proyectos, selecciona el proyecto en el que deseas configurar la administración de aplicaciones.

  3. Haz clic en Ir a la configuración.

  4. En el panel Configura tu proyecto para la administración de aplicaciones, revisa la lista de APIs que se habilitarán.

  5. Haz clic en Habilitar. El sistema habilita las APIs y crea el bucket de almacenamiento y el espacio default-space.

  6. Para almacenar los Google Cloud recursos que implementas con App Design Center, crea proyectos estándar en tu organización.

A nivel de carpeta

Para configurar App Design Center en tu carpeta habilitada para aplicaciones, haz lo siguiente:

  1. Ve a la página Descripción general de App Design Center.

    Ir a Descripción general

  2. Haz clic en Seleccionar carpeta y selecciona tu carpeta habilitada para aplicaciones.

  3. Haz clic en Configurar ADC.

  4. En el campo Nombre de mi espacio, ingresa un nombre para tu espacio. No puedes editar este nombre más adelante.

  5. De forma predeterminada, el espacio contiene componentes y plantillas de aplicaciones creados por Google. Para quitar los componentes y las plantillas de aplicaciones de Google del espacio, desmarca la casilla de verificación Habilitar plantillas de Google con opiniones.

    Si quitas las plantillas de Google con opiniones, los usuarios del espacio solo podrán usar los componentes que importes y las plantillas de aplicaciones que crees.

  6. Haz clic en Completar la configuración. El sistema habilita las APIs y crea el bucket de almacenamiento y el espacio.

  7. Para almacenar los Google Cloud recursos que implementas con App Design Center, crea proyectos estándar en tu carpeta habilitada para aplicaciones.

Configura App Design Center y usa tu propio bucket de almacenamiento

Cuando configuras App Design Center, puedes usar tu propio bucket de Cloud Storage para almacenar el código de Terraform. Por ejemplo, puedes usar un bucket existente si las políticas de tu organización te impiden crear buckets nuevos.

Para configurar Application Design Center y usar tu propio bucket de Cloud Storage, debes usar la API de App Design Center. Haz lo siguiente:

  1. Identifica el nombre del bucket.

  2. Crea tu llamada a la API con el projects.locations.spaces recurso. La ruta de acceso de la solicitud de la API tiene el formato projects/<var>PROJECT_ID</var>/locations/<var>LOCATION</var>, donde <var>PROJECT_ID</var> es uno de los siguientes:

    • Para un límite de un solo proyecto, usa el ID de tu proyecto.
    • Para un límite a nivel de carpeta, usa el ID del proyecto de administración que creaste durante la configuración de la administración de aplicaciones.

    Realiza la siguiente configuración en tu llamada a la API:

    1. Especifica el nombre del bucket en el campo gcs_bucket. Por ejemplo, si el URI del bucket es gs://my-bucket, el nombre del bucket es my-bucket.

    2. Usa el projects.locations.spaces.create método para crear el espacio.

    Cuando ejecutas este método, se crea tu espacio, se establece tu bucket como la ubicación de almacenamiento para la información de la aplicación, se habilitan las APIs necesarias y se completa el proceso de configuración.

¿Qué sigue?