Modificar recursos de App Hub

Puedes enumerar, ver, actualizar y eliminar recursos de App Hub en una carpeta habilitada para aplicaciones mediante la consola o la CLI de Google Cloud en tu terminal o en Cloud Shell. Google Cloud

Usa la información de esta página para actualizar las aplicaciones que hayas creado en App Hub. Si has desplegado tus aplicaciones en Application Design Center, debes actualizarlas actualizando la plantilla. Para obtener más información, consulta Modificar aplicaciones implementadas.

Requisitos previos

Antes de modificar los recursos de App Hub, completa las siguientes tareas:

  1. Sigue los requisitos para configurar el centro de aplicaciones.
  2. En función del tipo de recurso que quieras modificar, asegúrate de haber seguido los pasos para configurar el Centro de aplicaciones. Para obtener más información, consulta Configurar el centro de aplicaciones.

Roles obligatorios

Para obtener los permisos que necesitas para modificar recursos de App Hub, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos en la carpeta habilitada para aplicaciones:

  • Para crear y actualizar aplicaciones, registrar y anular el registro de servicios y cargas de trabajo, y actualizar los atributos asociados, sigue estos pasos:
  • Para ver las aplicaciones, los servicios y las cargas de trabajo, así como sus atributos, haz lo siguiente: Visor de App Hub (roles/apphub.viewer)
  • Para ver los datos a nivel de aplicación y de proyecto en Cloud Hub, sigue estos pasos: Operador de Cloud Hub (roles/cloudhub.operator)

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

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

Mostrar aplicaciones

Puedes enumerar y filtrar aplicaciones en una carpeta habilitada para aplicaciones.

Consola

  1. Para ver las aplicaciones de una carpeta habilitada para aplicaciones, en la consolaGoogle Cloud , ve a la página Aplicaciones del centro de aplicaciones.

    Ve a Aplicaciones.

    Verás una lista de aplicaciones.

  2. Para filtrar aplicaciones, sigue estos pasos:

    1. En el campo Filtro, selecciona un filtro, como Criticidad.
    2. Especifica un valor para el filtro. Por ejemplo, para mostrar las aplicaciones con una criticidad alta, selecciona Alta como valor.
      Se mostrará una lista de aplicaciones que coincidan con el filtro especificado.

gcloud

  1. Para ver las aplicaciones de una carpeta habilitada para aplicaciones, sigue estos pasos:

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

    Haz los cambios siguientes:

    • MANAGEMENT_PROJECT_ID: el ID de tu proyecto de gestión. Puedes encontrar el ID de tu proyecto de gestión en la página Gestión de Identidades y Accesos (IAM) y administración Configuración de la consola de Google Cloud . Si no encuentras el ID del proyecto de gestión, es posible que no estés en una carpeta habilitada para aplicaciones. En el selector de vistas (o de proyectos), selecciona la carpeta habilitada para la aplicación. Para obtener más información sobre cómo habilitar una carpeta para la gestión de aplicaciones, consulta Habilitar la gestión de aplicaciones.
    • REGION: la región de la aplicación. En función de la --scope-type de la aplicación, asigna el valor global o la región de la aplicación, por ejemplo, us-east1. Para obtener más información sobre cómo definir el --scope-type de la aplicación, consulta Crear una aplicación.
  2. Para filtrar las aplicaciones en función de los atributos de las variables, use la marca --filter. Por ejemplo, para enumerar todas las aplicaciones en las que el atributo environment-type tiene el valor PRODUCTION, haz lo siguiente:

    gcloud apphub applications list \
        --filter='attributes.environment.type=PRODUCTION' \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

Ver una aplicación

Puedes describir una aplicación en una carpeta habilitada para aplicaciones.

Consola

  1. En la Google Cloud consola, ve a la página Centro de aplicaciones Aplicaciones.

    Ve a Aplicaciones.

  2. En la lista de aplicaciones, haz clic en la aplicación de la que quieras obtener información.

  3. Haga clic en la pestaña Detalles para ver los detalles de la aplicación.

gcloud

gcloud apphub applications describe APPLICATION_NAME \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

Sustituye APPLICATION_NAME por el nombre de tu aplicación. El nombre solo puede incluir caracteres alfanuméricos en minúscula y no puede contener espacios.

Actualizar una aplicación de App Hub

Puedes actualizar los atributos de tu aplicación después de crearla.

Consola

  1. En la Google Cloud consola, ve a la página Centro de aplicaciones Aplicaciones.

    Ve a Aplicaciones.

  2. En la lista de aplicaciones, haz clic en Editar en la aplicación que quieras actualizar.

  3. Edita los campos según sea necesario.

  4. Haz clic en Guardar.

gcloud

  1. Actualiza tu aplicación con los atributos criticality-type, environment-type y owner type:

    gcloud apphub applications update APPLICATION_NAME \
        --display-name='APPLICATION_DISPLAY_NAME' \
        --criticality-type='CRITICALITY_LEVEL' \
        --environment-type='ENVIRONMENT' \
        --developer-owners=display-name=DISPLAY-NAME-DEVELOPER,email=EMAIL-DEVELOPER \
        --operator-owners=display-name=DISPLAY-NAME-OPERATOR,email=EMAIL-OPERATOR \
        --business-owners=display-name=DISPLAY-NAME-BUSINESS,email=EMAIL-BUSINESS \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

    Haz los cambios siguientes:

    • APPLICATION_NAME: el nombre de tu aplicación. El nombre solo puede incluir caracteres alfanuméricos en minúscula y no puede contener espacios.
    • REGION: la región de la aplicación.

    Puede actualizar cualquiera de los siguientes elementos:

    • APPLICATION_DISPLAY_NAME: indica el nombre visible de la aplicación.
    • CRITICALITY_LEVEL: indica la importancia de una aplicación, un servicio o una carga de trabajo para las operaciones de tu empresa. Proporciona uno de los siguientes valores:
      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • ENVIRONMENT: indica las fases del ciclo de vida del software. Proporciona uno de los siguientes valores:
      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • DISPLAY-NAME-DEVELOPER, DISPLAY-NAME-OPERATOR y DISPLAY-NAME-BUSINESS: nombres visibles del desarrollador, el operador y los propietarios de la empresa, respectivamente.
    • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR y EMAIL-NAME-BUSINESS: direcciones de correo del desarrollador, el operador y los propietarios de la empresa, respectivamente. Estos valores deben tener el formato username@yourdomain, por ejemplo, 222larabrown@gmail.com.

    Por ejemplo:

    gcloud apphub applications update my-application \
        --criticality-type='MEDIUM' \
        --environment-type='STAGING' \
        --developer-owners=display-name=developer-name,email=username@yourdomain \
        --project=google-mpf-FOLDER-ID \
        --location=us-east1
    

Ver servicios y cargas de trabajo

Puedes ver, enumerar y filtrar servicios y cargas de trabajo en una aplicación.

Consola

  1. Para enumerar los servicios y las cargas de trabajo, sigue estos pasos:

    1. En la Google Cloud consola, ve a la página App Hub Servicios y cargas de trabajo.

      Ir a Servicios y cargas de trabajo

    2. En la lista Región, selecciona las regiones desde las que quieras ver los servicios y las cargas de trabajo. Por ejemplo, selecciona us-east1.
      En la página Servicios y cargas de trabajo se muestran todos los servicios y las cargas de trabajo de los proyectos de servicio asociados a us-east1.

  2. Para filtrar los servicios o las cargas de trabajo, sigue estos pasos:

    1. En el campo Filtro, selecciona un filtro, como Entorno.
    2. Especifica un valor para el filtro. Por ejemplo, para ver los servicios y las cargas de trabajo en producción, seleccione Producción como valor.
      Aparecerá una lista de servicios y cargas de trabajo que coincidan con el filtro especificado.

gcloud

Mostrar servicios detectados

Los servicios detectados se pueden registrar en una aplicación.

  1. Para mostrar los servicios detectados, sigue estos pasos:

    gcloud apphub discovered-services list \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION

    Verá un resultado similar al siguiente:

    ID                      SERVICE_REFERENCE                                                                                                                   SERVICE_PROPERTIES
    [DISCOVERED_SERVICE_ID] {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-1'}    {'gcpProject': 'projects/PROJECT_ID', 'location': 'REGION'}
    
  2. Opcional: Filtra la lista de servicios detectados. Por ejemplo, para filtrar los servicios detectados con reglas de reenvío en la carpeta habilitada para la aplicación, haz lo siguiente:

    gcloud apphub discovered-services list \
        --filter='service_reference.uri~"forwardingRules"' \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION

Mostrar servicios registrados

Lista y filtra los servicios registrados de App Hub desde una aplicación.

  1. Para enumerar los servicios registrados en una aplicación, sigue estos pasos:

    gcloud apphub applications services list \
        --application=APPLICATION_NAME \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

    Verá un resultado similar al siguiente:

    ID             DISPLAY_NAME            SERVICE_REFERENCE                                                                                                                CREATE_TIME
    SERVICE_NAME   mywebserver-service1    {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule'}   2023-11-01T21:38:08
    

    Se ha registrado, pero los servicios independientes se indican con un valor vacío en el campo SERVICE_REFERENCE.

  2. Opcional: Filtra la lista de servicios registrados. Por ejemplo, para filtrar los servicios registrados en una aplicación en la que el atributo environment-type se ha definido como PRODUCTION, haz lo siguiente:

    gcloud apphub applications services list \
        --filter='attributes.environment.type=PRODUCTION' \
        --application=APPLICATION_NAME \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

Mostrar cargas de trabajo descubiertas

Las cargas de trabajo detectadas se pueden registrar en una aplicación.

  1. Para mostrar las cargas de trabajo detectadas, sigue estos pasos:

    gcloud apphub discovered-workloads list \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

    Verá un resultado similar al siguiente, que incluye MIGs no registrados:

    ID                        WORKLOAD_REFERENCE                                                                                                   WORKLOAD_PROPERTIES
    [DISCOVERED_WORKLOAD_ID]  {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/instanceGroups/testing-mig'}    {'gcpProject': 'projects/PROJECT_ID', 'location': 'REGION'}
    
  2. Opcional: Filtra la lista de cargas de trabajo detectadas. Por ejemplo, para filtrar la lista de cargas de trabajo detectadas con recursos informáticos en una carpeta habilitada para aplicaciones, sigue estos pasos:

    gcloud apphub discovered-workloads list \
        --filter='workload_reference.uri~"compute"'
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

Mostrar cargas de trabajo registradas

Lista y filtra las cargas de trabajo registradas de App Hub desde una aplicación.

  1. Para mostrar las cargas de trabajo registradas en una aplicación, sigue estos pasos:

    gcloud apphub applications workloads list \
        --application=APPLICATION_NAME \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

    Verá un resultado similar al siguiente:

    ID               DISPLAY_NAME               WORKLOAD_REFERENCE                                                                                                     CREATE_TIME
    WORKLOAD_NAME    mywebserver-deployment1    {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/instanceGroups/testing-mig'}    2023-10-31T18:34:23
    

    Las cargas de trabajo registradas, pero independientes, se indican con un valor vacío en el campo WORKLOAD_REFERENCE. Para obtener más información sobre los estados de registro, consulta las propiedades y los atributos de App Hub.

  2. Opcional: Filtra la lista de cargas de trabajo registradas. Por ejemplo, para filtrar las cargas de trabajo de una aplicación en la que el atributo environment-type tiene el valor PRODUCTION, haz lo siguiente:

    gcloud apphub applications workloads list \
        --filter='attributes.environment.type=PRODUCTION' \
        --application=APPLICATION_NAME \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

Actualizar servicios y cargas de trabajo

Puedes actualizar los servicios y las cargas de trabajo registrados en una aplicación.

Consola

  1. En la Google Cloud consola, ve a la página Aplicaciones del centro de aplicaciones.

    Ve a Aplicaciones.

  2. Haz clic en el nombre de tu aplicación.
    Se muestra la pestaña Servicios y cargas de trabajo con una lista de servicios y cargas de trabajo registrados que se encuentran en tus proyectos de servicio.

  3. Para cada servicio o carga de trabajo que quieras actualizar, haz lo siguiente:

    1. En la pestaña Servicios y cargas de trabajo, haga clic en more_vert del servicio o la carga de trabajo que quiera actualizar y, a continuación, en Editar servicio o Editar carga de trabajo.
    2. En el panel Editar servicio o Editar carga de trabajo, edita los campos que quieras y haz clic en Guardar.

gcloud

  1. Actualice su servicio con los atributos criticality-type, environment-type y owner_type:

    gcloud apphub applications services update SERVICE_NAME \
        --application=APPLICATION_NAME \
        --display-name='SERVICE_DISPLAY_NAME' \
        --criticality-type='CRITICALITY_LEVEL' \
        --environment-type='ENVIRONMENT' \
        --developer-owners=display-name=DISPLAY-NAME-DEVELOPER,email=EMAIL-DEVELOPER \
        --operator-owners=display-name=DISPLAY-NAME-OPERATOR,email=EMAIL-OPERATOR \
        --business-owners=display-name=DISPLAY-NAME-BUSINESS,email=EMAIL-BUSINESS \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

    Sustituye SERVICE_NAME por el nombre del servicio App Hub.

    Puede actualizar cualquiera de los siguientes elementos:

    • SERVICE_DISPLAY_NAME: indica el nombre visible del servicio.
    • CRITICALITY_LEVEL: indica la importancia de una aplicación, un servicio o una carga de trabajo para las operaciones de tu empresa. Proporciona uno de los siguientes valores:
      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • ENVIRONMENT: indica las fases del ciclo de vida del software. Proporciona uno de los siguientes valores:
      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • DISPLAY-NAME-DEVELOPER, DISPLAY-NAME-OPERATOR y DISPLAY-NAME-BUSINESS: nombres visibles del desarrollador, el operador y los propietarios de la empresa, respectivamente.
    • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR y EMAIL-NAME-BUSINESS: direcciones de correo del desarrollador, el operador y los propietarios de la empresa, respectivamente. Estos valores deben tener el formato username@yourdomain, por ejemplo, 222larabrown@gmail.com.

    Por ejemplo:

    gcloud apphub applications workloads update my-application \
        --criticality-type='MEDIUM' \
        --environment-type='STAGING' \
        --developer-owners=display-name=developer-name,email=username@yourdomain \
        --project=google-mpf-FOLDER-ID \
        --location=us-east1
    
  2. Actualiza tu carga de trabajo con los atributos criticality-type, environment-type y owner type:

    gcloud apphub applications workloads update WORKLOAD_NAME \
        --application=APPLICATION_NAME \
        --display-name='WORKLOAD_DISPLAY_NAME' \
        --criticality-type='CRITICALITY_LEVEL' \
        --environment-type='ENVIRONMENT' \
        --developer-owners=display-name=DISPLAY-NAME-DEVELOPER,email=EMAIL-DEVELOPER \
        --operator-owners=display-name=DISPLAY-NAME-OPERATOR,email=EMAIL-OPERATOR \
        --business-owners=display-name=DISPLAY-NAME-BUSINESS,email=EMAIL-BUSINESS \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

    Sustituye WORKLOAD_NAME por el nombre de la carga de trabajo de App Hub.

    Puede actualizar cualquiera de los siguientes elementos:

    • WORKLOAD_DISPLAY_NAME: indica el nombre visible del servicio.
    • CRITICALITY_LEVEL: indica la importancia de una aplicación, un servicio o una carga de trabajo para las operaciones de tu empresa. Proporciona uno de los siguientes valores:
      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • ENVIRONMENT: indica las fases del ciclo de vida del software. Proporciona uno de los siguientes valores:
      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • DISPLAY-NAME-DEVELOPER, DISPLAY-NAME-OPERATOR y DISPLAY-NAME-BUSINESS: nombres visibles del desarrollador, el operador y los propietarios de la empresa, respectivamente.
    • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR y EMAIL-NAME-BUSINESS: direcciones de correo del desarrollador, el operador y los propietarios de la empresa, respectivamente. Estos valores deben tener el formato username@yourdomain, por ejemplo, 222larabrown@gmail.com.

    Por ejemplo:

    gcloud apphub applications workloads update my-application \
        --criticality-type='MEDIUM' \
        --environment-type='STAGING' \
        --developer-owners=display-name=developer-name,email=username@yourdomain \
        --project=google-mpf-FOLDER-ID \
        --location=us-east1
    

Eliminar aplicaciones, servicios y cargas de trabajo

Elimina una aplicación para quitar los recursos registrados asociados a la carpeta habilitada para aplicaciones. Para ello, primero debe anular el registro de las cargas de trabajo y los servicios registrados en la aplicación.

Consola

  1. En la Google Cloud consola, ve a la página Centro de aplicaciones Aplicaciones.

    Ve a Aplicaciones.

  2. Haz clic en el nombre de una aplicación. Aparecerá una lista de los servicios y las cargas de trabajo registrados en la aplicación.

  3. Anula el registro de un servicio o una carga de trabajo.

    1. En la pestaña Servicios y cargas de trabajo, vaya a la sección Servicios y cargas de trabajo registrados y haga clic en el nombre del servicio o la carga de trabajo que quiera anular.
    2. En la página del servicio o la carga de trabajo registrados que se abre, haga clic en Anular registro para actualizar el servicio o la carga de trabajo como recurso Detectado. En la pestaña Servicios y cargas de trabajo, una alerta indica que la carga de trabajo no está registrada.
    3. Repite estos pasos con cada servicio y carga de trabajo.
  4. Ve a la página Aplicaciones del centro de aplicaciones.

    Ve a Aplicaciones.

  5. Haz clic en el nombre de una aplicación.

  6. En la página con los detalles de la aplicación, haz clic en Eliminar.

gcloud

  1. Muestra los servicios registrados en la aplicación:

    gcloud apphub applications services list \
        --application=APPLICATION_NAME \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    
  2. Da de baja el servicio de la aplicación:

    gcloud apphub applications services delete SERVICE_NAME \
        --application=APPLICATION_NAME \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

    El servicio ahora es un servicio detectado que se puede registrar en la aplicación.

  3. Repite el comando anterior para anular el registro de los servicios registrados que queden en la aplicación.

  4. Lista las cargas de trabajo registradas en la aplicación:

    gcloud apphub applications workloads list \
        --application=APPLICATION_NAME \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    
  5. Da de baja la carga de trabajo de la aplicación:

    gcloud apphub applications workloads delete WORKLOAD_NAME \
        --application=APPLICATION_NAME \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

    La carga de trabajo ahora es una carga de trabajo descubierta que se puede registrar en la aplicación.

  6. Repite el comando anterior para eliminar las cargas de trabajo registradas que queden de la aplicación.

  7. Elimina la aplicación:

    gcloud apphub applications delete APPLICATION_NAME \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

Siguientes pasos