Esta página se ha traducido con Cloud Translation API.

Configurar un solo proyecto

En este documento se describe cómo configurar un solo proyecto Google Cloud para gestionar aplicaciones. 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, actuando 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 tu 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:

Gestionar recursos, permisos y facturación del proyecto: Propietario del proyecto (roles/owner)
Gestionar todos los componentes de la aplicación del proyecto: Administrador de App Hub (roles/apphub.admin)

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:

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.
Asegúrate de que esté instalada la versión más reciente de la CLI de Google Cloud:
```
gcloud components update
```
Busca el ID del proyecto.
Define el proyecto como proyecto predeterminado para los comandos:
```
gcloud config set project PROJECT_ID
```
Sustituye PROJECT_ID con el ID del proyecto.

Habilita la API App Hub:

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

Adjunta el proyecto a sí mismo para crear un límite de gestión de aplicaciones:
```
gcloud alpha apphub boundary update \
    --crm-node="projects/$(gcloud projects describe PROJECT_ID --format='value(projectNumber)')" \
    --project=PROJECT_ID \
    --location=global
```
Este comando configura el proyecto como su propio proyecto de gestión, lo que permite a App Hub descubrir automáticamente todos los recursos admitidos que contiene.

Confirma el estado del archivo adjunto:

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

Obtendrá un resultado similar al siguiente ejemplo:

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

PROJECT_NUMBER es el número de proyecto correspondiente a tu ID de proyecto.

Cuando termines de configurar el proyecto de gestión, las APIs necesarias para la gestión de aplicaciones estarán habilitadas 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

En la Google Cloud consola, usa el selector de proyectos para seleccionar el proyecto de gestión.
Ve a la página Gestión de identidades y accesos:

Ir a IAM
Haz clic en Conceder acceso. Se abrirá el panel Dar acceso.
En el campo Principales nuevos, introduce la dirección de correo del principal al que quieras conceder acceso a App Hub.
Haz clic en Seleccionar un rol e introduce Centro de aplicaciones en el campo Filtrar.
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

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 un 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:

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.
Asegúrate de que esté instalada la versión más reciente de la CLI de Google Cloud:
```
gcloud components update
```
Busca el ID del proyecto.
Define el proyecto como proyecto predeterminado para los comandos:
```
gcloud config set project PROJECT_ID
```
Sustituye PROJECT_ID con el ID del proyecto.
Desvincula el proyecto de su límite para inhabilitar la gestión de aplicaciones:
```
gcloud alpha apphub boundary update \
    --project=PROJECT_ID \
    --location=global \
    --clear-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.
Para confirmar la separación, describe el límite:
```
gcloud alpha 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.
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
```

Configurar un solo proyecto Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.