Configurar un solo proyecto

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

En esta configuración, el proyecto Google Cloud se configura para gestionar sus propias aplicaciones y componentes, y actúa como un proyecto de gestión independiente. Este método es la forma más rápida de empezar a gestionar aplicaciones si todos los componentes de la aplicación se encuentran en este proyecto. App Hub descubre automáticamente todos los recursos admitidos del proyecto, lo que permite organizarlos en aplicaciones.

Limitaciones

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

Para ver una comparación de la compatibilidad de las funciones entre los modelos de un solo proyecto y de nivel de carpeta, consulta Compatibilidad de las funciones por tipo de límite.

Antes de empezar

Elige el Google Cloud proyecto que quieras usar para gestionar tus aplicaciones. Este proyecto funcionará como un proyecto de gestión independiente. Puede usar un proyecto que ya tenga o crear uno.

Roles obligatorios

Para obtener los permisos que necesitas para configurar un solo proyecto para la gestión de aplicaciones, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos en el proyecto que quieras configurar como proyecto de gestión independiente:

Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Habilitar la gestión de aplicaciones en un proyecto

Esta acción configura el proyecto como un proyecto de gestión independiente y habilita las APIs necesarias para los metadatos y las configuraciones de la aplicación. El proyecto se denomina proyecto habilitado para aplicaciones.

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

Consola

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

  2. Para ir a la página Descripción general desde App Hub, sigue estos pasos:

    Ir a Vista general

  3. Haz clic en Configurar App Hub.

    Si tu proyecto ya está en una carpeta habilitada para aplicaciones, la página no mostrará la opción Configurar App Hub. En su lugar, se te pedirá que selecciones la carpeta habilitada para la aplicación o que uses el proyecto actual en 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 relativas a la jerarquía de recursos para la gestión de aplicaciones, consulta el artículo Planificar la jerarquía de recursos para la gestión de aplicaciones.

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

    • Configuración rápida: gestiona una configuración predeterminada para los recursos de este proyecto y define tu primera aplicación para la adopción inicial.
    • Configuración completa: gestiona las configuraciones personalizadas de tus aplicaciones, como la configuración de controles de acceso iniciales y, opcionalmente, la adición de más proyectos para límites multiproyecto.

  5. Anota el nombre y el ID del proyecto. Esta información identifica el proyecto de gestión y usarás estos valores para conceder acceso.

  6. Revisa la lista de APIs que se están habilitando. Algunas APIs tienen costes asociados. Consulte más información sobre los costes de las APIs o haga clic en cada API para ver los costes asociados.

  7. Haz clic en Continuar.

  8. Completa la configuración según lo que hayas seleccionado:

    • Si ha seleccionado Configuración rápida, en la pestaña Definir aplicación puede definir una aplicación ahora o completar la configuración sin crearla. Ahora puedes crear aplicaciones y registrar recursos en ellas. También puedes empezar con una guía de inicio rápido para aplicaciones.

    • Si has seleccionado Configuración completa, concede acceso personalizado centrado en la aplicación a tus administradores:

      1. En la pestaña Definir límite, compruebe la información del proyecto. La tabla Proyectos de tu límite solo muestra el proyecto que define tu límite de un solo proyecto. En la configuración de un solo proyecto, no añada ningún proyecto adicional.

      2. Haz clic en Continuar.

      3. En la pestaña Conceder acceso, elige los roles y permisos de gestión de identidades y accesos adecuados para los administradores del proyecto. Para ver una lista de los roles recomendados centrados en aplicaciones en los productos deGoogle Cloud , consulta Asignar roles centrados en aplicaciones a los usuarios.

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

      5. Haz clic en Asignar roles y, a continuación, en Completar.

      Ahora puede registrar recursos en una aplicación o crear una plantilla de aplicación con el centro de diseño de aplicaciones.

Más adelante, puedes conceder roles de gestión de identidades y accesos adicionales a tus principales desde la página Gestión de identidades y accesos. Para obtener más información, consulta Conceder un rol de gestión de identidades y accesos mediante la consola 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 la CLI de Google Cloud:

    gcloud components update

  3. Busca el ID del proyecto.

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

    gcloud config set project PROJECT_ID

    Sustituye PROJECT_ID con el ID del proyecto.

  5. Habilita la API App Hub:

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

  6. Adjunta el proyecto a sí mismo para crear un límite de gestió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 gestión, lo que permite que App Hub descubra automáticamente todos los recursos admitidos que contiene.

  7. Confirma el estado del archivo 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 gestión, se habilitarán las APIs necesarias para la gestión de aplicaciones y podrás empezar a usar App Hub para agrupar servicios y cargas de trabajo en aplicaciones. También puedes consultar las APIs recomendadas para acceder a funciones avanzadas.

Asignar roles y permisos de App Hub

Para permitir que los usuarios descubran, registren y gestionen componentes de aplicaciones en este proyecto mediante App Hub, debe asignarles los roles y permisos de App Hub adecuados.

Sigue estos pasos:

Consola

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

  2. Ve a la página Gestión de identidades y accesos:

    Ir a IAM

  3. Haz clic en Conceder acceso. Se abrirá el panel Dar acceso.

  4. En el campo Principales nuevos, introduce la dirección de correo del principal al que quieras conceder acceso a App Hub.

  5. Haz clic en Seleccionar un rol e introduce Centro de aplicaciones en el campo Filtrar.

  6. Selecciona el rol de gestión de identidades y accesos de App Hub que quieras asignar a la entidad y haz clic en Guardar.

gcloud

  1. Da acceso a los principales del proyecto de gestión:

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

    Haz los cambios siguientes:

    • PROJECT_ID: ID del proyecto de gestión.
    • EMAIL_ADDRESS: la dirección de correo del director 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 gestión de identidades y accesos de App Hub que quieras asignar al principal. Por ejemplo, roles/apphub.admin.

Cambiar el límite de gestión de aplicaciones

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

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

Inhabilitar la gestión de aplicaciones en un proyecto

Puedes inhabilitar la gestión de aplicaciones en un proyecto si ya no quieres gestionar sus recursos en las aplicaciones de App Hub.

Cuando inhabilitas la gestión de aplicaciones en el proyecto, este se separa de su límite de gestión de aplicaciones. Los servicios y las cargas de trabajo de tus aplicaciones seguirán existiendo, pero su estado de registro cambiará a "desasociado". Si decides volver a habilitar la gestió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 siguen existiendo.

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

Consola

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

    Ir a Bienvenida

  2. Para ir a la página Configuración de límites desde el centro de aplicaciones, sigue estos pasos:

    Ir a Ajustes de límite

  3. Seleccione la casilla del proyecto para separarlo del límite y deshabilitar la gestión de aplicaciones.

  4. Haz clic en Desasociar proyectos.

    La tabla Proyectos de 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 la CLI de Google Cloud:

    gcloud components update

  3. Busca el ID del proyecto.

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

    gcloud config set project PROJECT_ID

    Sustituye PROJECT_ID con el ID del proyecto.

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

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

    Este comando actualiza el recurso de límite y elimina el archivo adjunto, lo que inhabilita la gestión de aplicaciones del proyecto.

  6. Para confirmar la separación, describe el límite:

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

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

  7. Opcionalmente, puedes eliminar todas las aplicaciones del proyecto y, a continuación, inhabilitar la API App Hub si no vas a usar las funciones de la aplicación en este proyecto:

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

Siguientes pasos