Registrar recursos en una aplicación

Consola

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

2. Ve a la página Aplicaciones desde el Centro de aplicaciones:

   Ve a Aplicaciones.

3. Haz clic en add Crear aplicación.

4. En la pestaña Detalles de la aplicación, selecciona la mejor ubicación para tu aplicación en función de tus requisitos de distribución geográfica:

   • Selecciona Global para crear una aplicación global.
   • Seleccione Regional para crear una aplicación regional. A continuación, selecciona la región específica de tu aplicación en función de las regiones admitidas por App Hub.

   Para obtener más información sobre la mejor ubicación para tu aplicación, consulta Aplicaciones globales y regionales.

5. Escribe el nombre de la aplicación.

   Este nombre es un identificador único que solo puede contener letras minúsculas, números o guiones. No podrás cambiar este nombre después de crear la aplicación.

6. Si quieres, añade un nombre visible y una descripción de la aplicación.

   No son identificadores únicos y puedes cambiarlos después de crear la aplicación.

7. Haz clic en Continuar.

8. En la pestaña Recursos de la aplicación, busca los recursos de infraestructura y marca las casillas de los recursos que quieras registrar como servicios y cargas de trabajo de la aplicación.

   Puedes seleccionar hasta 10 recursos a la vez.

9. Haz clic en Continuar.

10. En la pestaña Atributos y propietarios, puede añadir atributos a la aplicación, como la importancia, el entorno y los propietarios de la aplicación.

    Puedes usar los mismos atributos y propietarios para los recursos que registres en la aplicación o definirlos más adelante.

11. Haz clic en Crear.

Cuando se crea la aplicación, en la página Aplicaciones se muestran sus detalles, incluidos los recursos que has registrado como servicios y cargas de trabajo. Después de crear la aplicación, puedes registrar más servicios y cargas de trabajo en ella.

gcloud

1. Usa la CLI de Google Cloud para crear una aplicación desde tu terminal o Cloud Shell:

   gcloud apphub applications create APPLICATION_NAME \
     --project=PROJECT_ID \
     --scope-type=LOCATION \
     --location=REGION \
     --display-name=DISPLAY_NAME \
     --criticality-type=CRITICALITY \
     --environment-type=ENVIRONMENT \
     --developer-owners=display-name=DEV_NAME,email=DEV_EMAIL \
     --operator-owners=display-name=OPERATOR_NAME,email=OPERATOR_EMAIL \
     --business-owners=display-name=BUSINESS_NAME,email=BUSINESS_EMAIL
   

   Sustituye APPLICATION_NAME por el nombre de tu aplicación. Este nombre es un identificador único que solo puede contener letras minúsculas, números o guiones.

   Usa marcas opcionales, como --criticality-type, para definir los atributos de nivel superior de la aplicación y facilitar la detección y la gobernanza.

   En el caso de las marcas obligatorias y opcionales, sustituya lo siguiente:

   • Obligatorio: PROJECT_ID, el ID del proyecto de gestión.

   • Obligatorio: LOCATION: la ubicación de tu aplicación en función de tus requisitos de distribución geográfica. Usa uno de los siguientes valores:

     • REGIONAL para aplicaciones regionales.
     • GLOBAL para aplicaciones globales.

     Para obtener más información sobre la mejor ubicación para tu aplicación, consulta Aplicaciones globales y regionales.

   • Obligatorio: REGION, la región específica de tu aplicación. Se debe utilizar uno de los valores indicados a continuación.

     • Si la --scope-typeubicación de tu aplicaciónREGIONAL es REGIONAL, especifica el nombre de una región admitida por App Hub.
     • Si la --scope-type ubicación de tu aplicación está definida como GLOBAL, usa global.

   • Opcional: DISPLAY_NAME: el nombre visible de tu aplicación. El nombre visible no es un identificador único y puedes cambiarlo después de crear la aplicación.

   • Opcional: CRITICALITY: el nivel de importancia de la aplicación para tus operaciones. Usa uno de los siguientes valores:

     • MISSION_CRITICAL
     • HIGH
     • MEDIUM
     • LOW

   • Opcional: ENVIRONMENT, la fase del ciclo de vida del software. Se debe utilizar uno de los valores indicados a continuación.

     • PRODUCTION
     • STAGING
     • DEVELOPMENT
     • TEST

   • Opcional: DEV_NAME y DEV_EMAIL: el nombre visible y la dirección de correo del propietario del desarrollador, respectivamente.

   • Opcional: OPERATOR_NAME y OPERATOR_EMAIL: el nombre visible y la dirección de correo del propietario del operador, respectivamente.

   • Opcional: BUSINESS_NAME y BUSINESS_EMAIL: el nombre visible y la dirección de correo del propietario de la empresa, respectivamente.

2. Lista las aplicaciones de tu proyecto:

   gcloud apphub applications list \
     --project=PROJECT_ID \
     --location=REGION
   

   Debes obtener un resultado similar al siguiente:

   ID                 DISPLAY_NAME   CREATE_TIME
   APPLICATION_NAME   DISPLAY_NAME   2023-10-31T18:33:48
   

Terraform

Para crear una aplicación con Terraform, usa el recurso google_apphub_application. Este recurso te permite definir las propiedades de la aplicación, como su nombre, ubicación y atributos.

En el siguiente ejemplo se crea una aplicación regional en us-central1 con atributos de importancia, entorno y propietario definidos:

resource "google_apphub_application" "example" {
    project        = "my-project-id"
    location       = "us-central1"
    application_id = "my-application"
    display_name   = "My Application"
    description    = "This application represents our platform."
    scope {
        type = "REGIONAL"
    }
    attributes {
        criticality {
            type = "MISSION_CRITICAL"
        }
        environment {
            type = "PRODUCTION"
        }
        business_owners {
            display_name = "Alice"
            email        = "alice@example.com"
        }
        developer_owners {
            display_name = "Bob"
            email        = "bob@example.com"
        }
        operator_owners {
            display_name = "Charlie"
            email        = "charlie@example.com"
        }
    }
}

Consola

Después de crear una aplicación, puedes registrar varios recursos en ella:

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

2. Ve a la página Aplicaciones desde el Centro de aplicaciones:

   Ve a Aplicaciones.

3. Haga clic en el nombre de la aplicación para la que quiera registrar recursos.Google Cloud

4. En la página de la aplicación, seleccione la pestaña Servicios y cargas de trabajo.

5. Haz clic en add Registrar servicios o cargas de trabajo.

6. En la pestaña Servicios y cargas de trabajo, busque los recursos de infraestructura y marque las casillas de los recursos que quiera registrar como servicios o cargas de trabajo de la aplicación.

   Puedes seleccionar hasta 10 recursos a la vez.

7. Haz clic en Continuar.

8. En la pestaña Atributos y propietarios, puedes añadir atributos a estos recursos, como la importancia, el entorno y los propietarios de los recursos.

   Puede usar los mismos atributos y propietarios que en la aplicación o definir otros atributos más adelante.

9. Haz clic en Registrarse.

La pestaña Servicios y cargas de trabajo muestra todos los servicios y cargas de trabajo registrados de la aplicación.

gcloud

App Hub te permite seleccionar recursos admitidos ubicados dentro del límite de gestión de tu aplicación como servicios o cargas de trabajo. Usa la CLI de Google Cloud para enumerar los servicios o las cargas de trabajo que puedes registrar en la aplicación desde tu terminal o Cloud Shell. Los comandos son ligeramente diferentes para los servicios y las cargas de trabajo: