Modificare le risorse di App Hub nelle cartelle abilitate per le app

Puoi elencare, visualizzare, aggiornare ed eliminare le risorse di App Hub in una cartella abilitata per le app utilizzando la console Google Cloud o Google Cloud CLI nel terminale o Cloud Shell.

Prerequisiti

Prima di modificare le risorse di App Hub, completa le seguenti attività:

  1. Segui i prerequisiti per configurare App Hub.
  2. A seconda del tipo di risorsa che vuoi modificare, assicurati di aver eseguito i passaggi per configurare App Hub. Per ulteriori informazioni, consulta la sezione Configurare App Hub.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per modificare le risorse di App Hub, chiedi all'amministratore di concederti i seguenti ruoli IAM nella cartella abilitata per le app:

  • Per creare e aggiornare le applicazioni, registrare e annullare la registrazione di servizi e carichi di lavoro e aggiornare gli attributi associati:
  • Per visualizzare applicazioni, servizi e workload e i relativi attributi: App Hub Viewer (roles/apphub.viewer)
  • Per visualizzare applicazioni, servizi e workload e i relativi attributi nei Google Cloud servizi che supportano la gestione delle applicazioni: App Hub Management Viewer (roles/apphub.appManagementViewer)

Per ulteriori informazioni sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Elenco applicazioni

Puoi elencare e filtrare le applicazioni in una cartella abilitata per le app.

Console

  1. Per visualizzare le applicazioni in una cartella abilitata per le app, vai alla pagina App di App Hub nella console Google Cloud.

    Vai a Applicazioni

    Viene visualizzato un elenco di applicazioni.

  2. Per filtrare le applicazioni:

    1. Nel campo Filtro, seleziona un filtro come Criticità.
    2. Specifica un valore per il filtro. Ad esempio, per visualizzare le applicazioni con elevata criticità, seleziona Alta come valore.
      Viene visualizzato un elenco di applicazioni corrispondenti al filtro specificato.

gcloud

  1. Per visualizzare le applicazioni in una cartella abilitata per le app:

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

    Sostituisci quanto segue:

    • MANAGEMENT_PROJECT_ID: l'ID del progetto di gestione. Puoi trovare l'ID progetto di gestione nella pagina Impostazioni di IAM (Identity and Access Management) e amministrazione della console Google Cloud. Se non riesci a trovare l'ID progetto di gestione, è possibile che non ti trovi in una cartella con l'app abilitata. Dal selettore di ambito (o selettore di progetti), seleziona la cartella abilitata per l'app. Per ulteriori informazioni sull'abilitazione di una cartella per la gestione delle app, vedi Abilitare la gestione delle app.
    • REGION: la regione dell'applicazione. A seconda del --scope-type dell'applicazione, specifica il valore global o la regione dell'applicazione, ad esempio us-east1. Per ulteriori informazioni sull'impostazione del valore --scope-type per l'applicazione, consulta Creare un'applicazione.

  2. Per filtrare le applicazioni in base agli attributi variabili, utilizza il flag --filter. Ad esempio, per elencare tutte le applicazioni in cui l'attributo environment-type è impostato su PRODUCTION:

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

Visualizzare un'applicazione

Puoi descrivere un'applicazione in una cartella abilitata per le app.

Console

  1. Nella console Google Cloud, vai alla pagina App di App Hub.

    Vai a Applicazioni

  2. Nell'elenco delle applicazioni, fai clic sull'applicazione di cui vuoi conoscere i dettagli.

  3. Fai clic sulla scheda Dettagli per visualizzare i dettagli dell'applicazione.

gcloud

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

Sostituisci APPLICATION_NAME con il nome della tua applicazione. Il nome deve includere solo caratteri alfanumerici minuscoli senza spazi.

Aggiornare un'applicazione App Hub

Puoi aggiornare gli attributi della tua applicazione dopo che è stata creata.

Console

  1. Nella console Google Cloud, vai alla pagina App di App Hub.

    Vai a Applicazioni

  2. Nell'elenco delle applicazioni, fai clic su Modifica in corrispondenza dell'applicazione che vuoi aggiornare.

  3. Modifica i campi in base alle esigenze.

  4. Fai clic su Salva.

gcloud

  1. Aggiorna l'applicazione con gli attributi criticality-type, environment-type e tipo di proprietario:

    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

    Sostituisci quanto segue:

    • APPLICATION_NAME: il nome dell'applicazione. Il nome deve includere solo caratteri alfanumerici minuscoli senza spazi.
    • REGION: la regione dell'applicazione.

    Puoi aggiornare uno dei seguenti elementi:

    • APPLICATION_DISPLAY_NAME: indica il nome visualizzato dell'applicazione.
    • CRITICALITY_LEVEL: indica quanto sia critica un'applicazione, un servizio o un carico di lavoro per le operazioni aziendali. Fornisci uno dei seguenti valori:
      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • ENVIRONMENT: indica le fasi del ciclo di vita del software. Fornisci uno dei seguenti valori:
      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • DISPLAY-NAME-DEVELOPER, DISPLAY-NAME-OPERATOR e DISPLAY-NAME-BUSINESS: nomi visualizzati rispettivamente dello sviluppatore, dell'operatore e dei proprietari dell'attività.
    • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR e EMAIL-NAME-BUSINESS: indirizzi email dello sviluppatore, dell'operatore e dei proprietari dell'attività, rispettivamente. Questi valori devono avere il formato username@yourdomain, ad esempio 222larabrown@gmail.com.

    Ad esempio:

    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

Visualizzare servizi e workload

Puoi visualizzare, elencare e filtrare servizi e workload in un'applicazione.

Console

  1. Per elencare i servizi e i workload:

    1. Nella console Google Cloud, vai alla pagina Servizi e carichi di lavoro di App Hub.

      Vai a Servizi e carichi di lavoro

    2. Nell'elenco Regione, seleziona le regioni da cui vuoi visualizzare i servizi e i carichi di lavoro. Ad esempio, seleziona us-east1.
      La pagina Servizi e carichi di lavoro mostra tutti i servizi e i carichi di lavoro dei progetti di servizio collegati associati a us-east1.

  2. Per filtrare i servizi o i workload:

    1. Nel campo Filtro, seleziona un filtro come Ambiente.
    2. Specifica un valore per il filtro. Ad esempio, per visualizzare i servizi e i carichi di lavoro in produzione, seleziona Produzione come valore.
      Viene visualizzato un elenco di servizi e carichi di lavoro corrispondenti al filtro specificato.

gcloud

Elenco dei servizi rilevati

I servizi rilevati possono essere registrati in un'applicazione.

  1. Per elencare i servizi rilevati:

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

    Viene visualizzato un output simile al seguente:

    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. (Facoltativo) Filtra l'elenco dei servizi rilevati. Ad esempio, per filtrare i servizi rilevati con regole di inoltro nella cartella abilitata per le app:

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

Elenco dei servizi registrati

Elenca e filtra i servizi App Hub registrati da un'applicazione.

  1. Per elencare i servizi registrati in un'applicazione:

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

    Viene visualizzato un output simile al seguente:

    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

    I servizi registrati, ma scollegati, sono indicati da un valore vuoto nel SERVICE_REFERENCE campo.

  2. (Facoltativo) Filtra l'elenco dei servizi registrati. Ad esempio, per filtrare i servizi registrati in un'applicazione in cui l'attributo environment-type è impostato su PRODUCTION:

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

Elenca i workload scoperti

I carichi di lavoro scoperti possono essere registrati in un'applicazione.

  1. Per elencare i workload scoperti:

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

    Viene visualizzato un output simile al seguente, che include i MIG non registrati:

    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. (Facoltativo) Filtra l'elenco dei workload rilevati. Ad esempio, perfiltrare l'elenco dei carichi di lavoro rilevati con risorse di calcolo in una cartella abilitata per le app:

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

Elenca i workload registrati

Elenca e filtra i workload App Hub registrati da un'applicazione.

  1. Per elencare i carichi di lavoro registrati in un'applicazione:

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

    Viene visualizzato un output simile al seguente:

    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

    I workload registrati, ma scollegati, sono indicati da un valore vuoto nel WORKLOAD_REFERENCE campo. Per ulteriori informazioni sugli stati di registrazione, consulta le proprietà e gli attributi di App Hub.

  2. (Facoltativo) Filtra l'elenco dei carichi di lavoro registrati. Ad esempio, per filtrare i carichi di lavoro in un'applicazione in cui l'attributo environment-type è impostato su PRODUCTION:

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

Aggiornare servizi e workload

Puoi aggiornare i servizi e i carichi di lavoro registrati in un'applicazione.

Console

  1. Nella console Google Cloud, vai alla pagina App di App Hub.

    Vai a Applicazioni

  2. Fai clic sul nome della tua applicazione.
    Nella scheda Servizi e carichi di lavoro viene visualizzato un elenco di servizi e carichi di lavoro registrati nei tuoi progetti di servizi.

  3. Per ogni servizio o carico di lavoro che vuoi aggiornare:

    1. Nella scheda Servizi e carichi di lavoro, fai clic su more_vert per il servizio o il carico di lavoro che vuoi aggiornare, quindi fai clic su Modifica servizio o Modifica carico di lavoro.
    2. Nel riquadro Modifica servizio o Modifica carico di lavoro, modifica i campi come richiesto e fai clic su Salva.

gcloud

  1. Aggiorna il servizio con gli attributi criticality-type, environment-type e tipo proprietario:

    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

    Sostituisci SERVICE_NAME con il nome del servizio App Hub.

    Puoi aggiornare uno dei seguenti elementi:

    • SERVICE_DISPLAY_NAME: indica un nome visualizzato per il servizio.
    • CRITICALITY_LEVEL: indica quanto sia critica un'applicazione, un servizio o un carico di lavoro per le operazioni aziendali. Fornisci uno dei seguenti valori:
      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • ENVIRONMENT: indica le fasi del ciclo di vita del software. Fornisci uno dei seguenti valori:
      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • DISPLAY-NAME-DEVELOPER, DISPLAY-NAME-OPERATOR e DISPLAY-NAME-BUSINESS: nomi visualizzati rispettivamente dello sviluppatore, dell'operatore e dei proprietari dell'attività.
    • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR e EMAIL-NAME-BUSINESS: indirizzi email dello sviluppatore, dell'operatore e dei proprietari dell'attività, rispettivamente. Questi valori devono avere il formato username@yourdomain, ad esempio 222larabrown@gmail.com.

    Ad esempio:

    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. Aggiorna il carico di lavoro con gli attributi criticality-type, environment-type e tipo di proprietario:

    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

    Sostituisci WORKLOAD_NAME con il nome del carico di lavoro App Hub.

    Puoi aggiornare uno dei seguenti elementi:

    • WORKLOAD_DISPLAY_NAME: indica un nome visualizzato per il servizio.
    • CRITICALITY_LEVEL: indica quanto sia critica un'applicazione, un servizio o un carico di lavoro per le operazioni aziendali. Fornisci uno dei seguenti valori:
      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • ENVIRONMENT: indica le fasi del ciclo di vita del software. Fornisci uno dei seguenti valori:
      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • DISPLAY-NAME-DEVELOPER, DISPLAY-NAME-OPERATOR e DISPLAY-NAME-BUSINESS: nomi visualizzati rispettivamente dello sviluppatore, dell'operatore e dei proprietari dell'attività.
    • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR e EMAIL-NAME-BUSINESS: indirizzi email dello sviluppatore, dell'operatore e dei proprietari dell'attività, rispettivamente. Questi valori devono avere il formato username@yourdomain, ad esempio 222larabrown@gmail.com.

    Ad esempio:

    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

Eliminare applicazioni, servizi e carichi di lavoro

Elimina un'applicazione esistente per rimuovere le risorse registrate associate alla cartella abilitata per le app. Per farlo, devi prima annullare la registrazione dei carichi di lavoro e dei servizi registrati nell'applicazione.

Console

  1. Nella console Google Cloud, vai alla pagina App di App Hub.

    Vai a Applicazioni

  2. Fai clic sul nome di un'applicazione. Viene visualizzato un elenco di servizi e carichi di lavoro registrati nell'applicazione.

  3. Annullare la registrazione di un servizio o di un workload.

    1. Nella scheda Servizi e carichi di lavoro, fai clic sul nome del servizio o del carico di lavoro di cui vuoi annullare la registrazione nella sezione Servizi e carichi di lavoro registrati.
    2. Nella pagina del servizio o del carico di lavoro registrato che si apre, fai clic su Disregistra per aggiornare il servizio o il carico di lavoro come risorsa Rilevata. Nella scheda Servizi e workload, un avviso indica che il workload non è registrato.
    3. Ripeti queste istruzioni per ogni servizio e carico di lavoro.

  4. Vai alla pagina Applicazioni di App Hub.

    Vai a Applicazioni

  5. Fai clic sul nome di un'applicazione.

  6. Nella pagina con i dettagli dell'applicazione, fai clic su Elimina.

gcloud

  1. Elenca i servizi registrati nell'applicazione:

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

  2. Annullare la registrazione del servizio dall'applicazione:

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

    Il servizio è ora un servizio rilevato che può essere registrato nell'applicazione.

  3. Ripeti il comando precedente per annullare la registrazione di eventuali servizi registrati rimanenti dall'applicazione.

  4. Elenca i workload registrati nell'applicazione:

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

  5. Annullare la registrazione del carico di lavoro dall'applicazione:

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

    Il carico di lavoro ora è un carico di lavoro rilevato che può essere registrato nell'applicazione.

  6. Ripeti il comando precedente per eliminare eventuali carichi di lavoro registrati rimanenti dall'applicazione.

  7. Elimina l'applicazione:

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

Passaggi successivi