Configura un solo proyecto

En este documento, se describe cómo configurar un solo proyecto Google Cloud para administrar aplicaciones. Esta configuración también se conoce como el límite de un solo proyecto.

En esta configuración, el proyecto Google Cloud está configurado para administrar sus propias aplicaciones y componentes, y actúa como un proyecto de administración independiente. Este enfoque es la forma más rápida de comenzar a administrar aplicaciones si todos los componentes de tu aplicación residen en este único proyecto. App Hub descubre automáticamente todos los recursos compatibles dentro del proyecto, lo que los prepara para organizarlos en aplicaciones.

Limitaciones

El límite de un solo proyecto tiene una compatibilidad de funciones diferente en comparación con el límite a nivel de la carpeta. App Hub, Application Design Center y Application Monitoring admiten completamente proyectos únicos, pero otros servicios de Google Cloud centrados en las aplicaciones, como Cloud Hub y Gemini Cloud Assist, requieren un límite a nivel de la carpeta.

Para obtener una comparación de la compatibilidad de funciones entre los modelos a nivel de proyecto único y de carpeta, consulta Compatibilidad de funciones por tipo de límite.

Antes de comenzar

Elige el Google Cloud proyecto que deseas usar para administrar tus aplicaciones. Este proyecto funcionará como el proyecto de administración independiente. Puedes usar un proyecto existente o crear uno nuevo.

Roles obligatorios

Para obtener los permisos que necesitas para configurar un solo proyecto para la administración de aplicaciones, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto que deseas configurar como proyecto de administración independiente:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Habilita la administración de aplicaciones en un proyecto

Esta acción configura el proyecto como un proyecto de administración independiente y habilita las APIs requeridas para la configuración y los metadatos de la aplicación. Luego, el proyecto se denomina proyecto habilitado para apps.

Para habilitar la administración de aplicaciones en un solo proyecto, sigue estos pasos:

Console

  1. En la consola de Google Cloud , usa el selector de proyectos para elegir el tuyo.

  2. Navega a la página Overview desde App Hub:

    Ir a Descripción general

  3. Haz clic en Configurar el Centro de aplicaciones.

    Si tu proyecto ya se encuentra dentro de una carpeta habilitada para la app, la página no mostrará la opción Configurar App Hub. En cambio, se te pedirá que selecciones la carpeta habilitada para apps o que uses el proyecto actual desde un menú. Selecciona el proyecto actual para continuar con la configuración de un solo proyecto. Para obtener más información sobre las consideraciones de la jerarquía de recursos para la administración de aplicaciones, consulta Planifica tu jerarquía de recursos para la administración de aplicaciones.

  4. En la página Habilitar App Hub, elige una de las siguientes opciones:

    • Configuración rápida: Administra una configuración predeterminada para los recursos de este proyecto y define tu primera aplicación para la adopción inicial.
    • Configuración completa: Administra la configuración personalizada de tus aplicaciones, lo que incluye la configuración de controles de acceso por adelantado y, de manera opcional, la adición de más proyectos para límites de varios proyectos.

  5. Toma nota del nombre y el ID del proyecto. Esta información identifica el proyecto de administración y usarás estos valores para otorgar acceso.

  6. Revisa la lista de APIs que se habilitarán. Algunas APIs tienen costos asociados. Obtén más información sobre los costos de las APIs o haz clic en cada una para ver los costos asociados.

  7. Haz clic en Continuar.

  8. Completa la configuración según tu selección:

    • Si seleccionaste Configuración rápida, la pestaña Define application te permite definir una aplicación ahora o completar la configuración sin crear una. Ahora puedes crear aplicaciones y registrar recursos en ellas. También puedes comenzar con una guía de inicio rápido para aplicaciones.

    • Si seleccionaste Configuración completa, otorga acceso personalizado centrado en la aplicación para tus administradores:

      1. En la pestaña Define boundary, verifica la información de tu proyecto. En la tabla Proyectos en tu límite, solo se muestra el proyecto que define tu límite de un solo proyecto. Para la configuración del límite de un solo proyecto, no agregues proyectos adicionales.

      2. Haz clic en Continuar.

      3. En la pestaña Otorgar acceso, elige los roles y permisos de IAM adecuados para los administradores del proyecto. Para obtener una lista de los roles recomendados centrados en la aplicación en los productos deGoogle Cloud , consulta Otorga roles centrados en la aplicación a tus usuarios.

      4. En el cuadro Nuevos principales, ingresa los usuarios, grupos o cuentas de servicio que deben tener acceso de administrador a las tareas centradas en la aplicación en el proyecto.

      5. Haz clic en Otorgar roles y, luego, en Completar.

      Ahora puedes registrar recursos existentes en una aplicación o crear una plantilla de aplicación con el Centro de diseño de aplicaciones.

Más adelante, puedes otorgar roles adicionales de IAM a tus principales desde la página IAM. Para obtener más información, consulta Cómo otorgar un rol de IAM con la consola de Google Cloud .

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. Asegúrate de que esté instalada la versión más reciente de Google Cloud CLI:

    gcloud components update

  3. Busca el ID del proyecto.

  4. Configura el proyecto como el proyecto predeterminado para los comandos:

    gcloud config set project PROJECT_ID

    Reemplaza PROJECT_ID por el ID del proyecto.

  5. Habilita la API de App Hub:

    gcloud services enable apphub.googleapis.com \
    --project PROJECT_ID

  6. Vincula el proyecto a sí mismo para crear un límite de administración de aplicaciones:

    gcloud apphub boundary update \
    --crm-node=projects/PROJECT_ID \
    --project=PROJECT_ID \
    --location=global

    Este comando configura el proyecto como su propio proyecto de administración, lo que permite que App Hub descubra automáticamente todos los recursos compatibles dentro de él.

  7. Confirma el estado del adjunto:

    gcloud apphub boundary describe \
    --project=PROJECT_ID \
    --location=global

    Obtendrás un resultado similar al siguiente ejemplo:

    name: projects/PROJECT_ID/locations/LOCATION/boundary
crmNode: projects/PROJECT_ID
createTime: 2025-08-28T19:04:47Z
updateTime: 2025-08-28T19:04:47Z
type: AUTOMATIC

Cuando termines de configurar el proyecto de administración, se habilitarán las APIs necesarias para la administración de aplicaciones y podrás comenzar a usar App Hub para agrupar servicios y cargas de trabajo en aplicaciones. De manera opcional, revisa las APIs recomendadas para acceder a funciones avanzadas.

Asigna roles y permisos de App Hub

Para permitir que los usuarios descubran, registren y administren componentes de aplicaciones dentro de este proyecto con App Hub, debes otorgarles los roles y permisos de App Hub adecuados.

Lleva a cabo los pasos siguientes:

Console

  1. En la consola de Google Cloud , usa el selector de proyectos para seleccionar el proyecto de administración.

  2. Navega a la página IAM:

    Ir a IAM

  3. Haz clic en Otorgar acceso. Se abrirá el panel Otorgar acceso.

  4. En el campo Principales nuevas, ingresa la dirección de correo electrónico de la principal a la que deseas otorgar acceso a App Hub.

  5. Haz clic en Seleccionar un rol y, luego, ingresa App Hub en el campo Filtro.

  6. Selecciona el rol de IAM de App Hub que deseas asignar a la principal y haz clic en Guardar.

gcloud

  1. Otorga acceso a los principales en el proyecto de administración:

    gcloud projects add-iam-policy-binding PROJECT_ID \
    --member='user:EMAIL_ADDRESS' \
    --role='ROLE_NAME'

    Reemplaza lo siguiente:

    • PROJECT_ID: Es el ID del proyecto de administración.
    • EMAIL_ADDRESS: La dirección de correo electrónico del principal que debe obtener acceso a App Hub. Este valor debe tener el formato username@yourdomain, por ejemplo, my.user@example.com.
    • ROLE_NAME: El rol de IAM de App Hub que deseas asignar a la principal, por ejemplo, roles/apphub.admin.

Cómo cambiar el límite de administración de aplicaciones

Si deseas cambiar el proyecto que define el límite de un solo proyecto, inhabilita la administración de aplicaciones en el proyecto anterior y habilítala en el nuevo. Los datos de tu aplicación no se migran, y debes volver a crear tus aplicaciones en el proyecto nuevo.

Para pasar de un límite de un solo proyecto a un límite a nivel de la carpeta, configura una carpeta habilitada para apps. Esta acción configura un nuevo proyecto de administración en la carpeta. Deberás volver a crear las aplicaciones en este nuevo proyecto de administración.

Inhabilita la administración de aplicaciones en un proyecto

Puedes inhabilitar la administración de aplicaciones en un proyecto si ya no deseas administrar sus recursos en las aplicaciones de App Hub.

Cuando inhabilitas la administración de aplicaciones en el proyecto, este se separa de su límite de administración de aplicaciones. Los servicios y las cargas de trabajo de tus aplicaciones seguirán existiendo, pero su estado de registro cambiará a separado. Si decides volver a habilitar la administración de aplicaciones en el proyecto, App Hub puede volver a detectar tus aplicaciones, servicios y cargas de trabajo, y actualizar el estado de registro si los recursos subyacentes aún existen.

Para inhabilitar la administración de aplicaciones en un solo proyecto, sigue estos pasos:

Console

  1. En la consola de Google Cloud , usa el selector de proyectos para seleccionar el proyecto de administración.

    Ir a Bienvenida

  2. Navega a la página Configuración de límites desde App Hub:

    Ir a Configuración de límite

  3. Selecciona la casilla de verificación del proyecto para separarlo del límite y, luego, inhabilita la administración de aplicaciones.

  4. Haz clic en Desvincular proyectos.

    La tabla Proyectos en tu límite se actualiza y ya no muestra la información de tu proyecto.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. Asegúrate de que esté instalada la versión más reciente de Google Cloud CLI:

    gcloud components update

  3. Busca el ID del proyecto.

  4. Configura el proyecto como el proyecto predeterminado para los comandos:

    gcloud config set project PROJECT_ID

    Reemplaza PROJECT_ID por el ID del proyecto.

  5. Desvincula el proyecto de su límite para inhabilitar la administración de aplicaciones:

    gcloud apphub boundary update \
    --project=PROJECT_ID \
    --location=global \
    --crm-node=""

    Este comando actualiza el recurso de límite y quita la asociación, lo que inhabilita la administración de aplicaciones para el proyecto.

  6. Confirma la separación describiendo el límite:

    gcloud apphub boundary describe \
    --project=PROJECT_ID \
    --location=global

    El resultado no contiene un campo crmNode, lo que confirma que la administración de aplicaciones está inhabilitada en el proyecto.

  7. De manera opcional, borra todas las aplicaciones del proyecto y, luego, inhabilita la API de App Hub si ya no usarás las funciones de la aplicación en este proyecto:

    gcloud services disable apphub.googleapis.com \
    --project=PROJECT_ID

¿Qué sigue?