Se usó la API de Cloud Translation para traducir esta página.

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

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

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:

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 Google Cloud CLI:
```
gcloud components update
```
Busca el ID del proyecto.
Configura el proyecto como el proyecto predeterminado para los comandos:
```
gcloud config set project PROJECT_ID
```
Reemplaza PROJECT_ID por el ID del proyecto.

Habilita la API de App Hub:

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

Vincula el proyecto a sí mismo para crear un límite de administració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 administración, lo que permite que App Hub descubra automáticamente todos los recursos compatibles dentro de él.

Confirma el estado del adjunto:

gcloud alpha 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_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 del proyecto.

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

En la consola de Google Cloud , usa el selector de proyectos para seleccionar el proyecto de administración.
Navega a la página IAM:

Ir a IAM
Haz clic en Otorgar acceso. Se abrirá el panel Otorgar acceso.
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.
Haz clic en Seleccionar un rol y, luego, ingresa App Hub en el campo Filtro.
Selecciona el rol de IAM de App Hub que deseas asignar a la principal y haz clic en Guardar.

gcloud

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 tu proyecto único, 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:

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 Google Cloud CLI:
```
gcloud components update
```
Busca el ID del proyecto.
Configura el proyecto como el proyecto predeterminado para los comandos:
```
gcloud config set project PROJECT_ID
```
Reemplaza PROJECT_ID por el ID del proyecto.
Desvincula el proyecto de su límite para inhabilitar la administració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 quita la asociación, lo que inhabilita la administración de aplicaciones para el proyecto.
Confirma la separación describiendo el límite:
```
gcloud alpha 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.
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
```

Configura un solo proyecto Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.