Modificare le risorse App Hub

Anteprima — App-enabled folders and Management projects

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Puoi elencare, visualizzare, aggiornare ed eliminare le risorse App Hub in una cartella abilitata per le app utilizzando la console Google Cloud o Google Cloud CLI nel terminale o in 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 maggiori informazioni, vedi 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 applicazioni, registrare e annullare la registrazione di servizi e carichi di lavoro e aggiornare gli attributi associati:
  • Amministratore di App Hub (roles/apphub.admin)
  • Editor di App Hub (roles/apphub.editor)
• Per visualizzare applicazioni, servizi e carichi di lavoro e i relativi attributi: Visualizzatore App Hub (roles/apphub.viewer)
• Per visualizzare i dati a livello di applicazione e di progetto in Cloud Hub: Cloud Hub Operator (roles/cloudhub.operator)

Per ulteriori informazioni sulla concessione dei ruoli, consulta Gestisci 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 alle app.

Console

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

   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 criticità elevata, seleziona Alto come valore.
      Viene visualizzato un elenco di applicazioni che corrispondono al filtro specificato.

gcloud

1. Per visualizzare le applicazioni in una cartella app:

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

   Sostituisci quanto segue:

   • MANAGEMENT_PROJECT_ID: l'ID del tuo progetto di gestione. Puoi trovare l'ID progetto di gestione nella pagina Impostazioni di Identity and Access Management (IAM) e amministrazione della console Google Cloud . Se non riesci a trovare l'ID progetto di gestione, potresti non trovarti in una cartella abilitata per le app. Nel selettore di ambito (o selettore di progetti), seleziona la cartella abilitata per le app. Per saperne di più sull'abilitazione di una cartella per la gestione delle applicazioni, vedi Abilitare la gestione delle applicazioni.
   • REGION: la regione dell'applicazione. A seconda del --scope-type dell'applicazione, assegna a questo campo il valore global o la regione dell'applicazione, ad esempio us-east1. Per ulteriori informazioni sull'impostazione di --scope-type per l'applicazione, vedi Creare un'applicazione.

2. Per filtrare le applicazioni in base agli attributi delle 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 una richiesta

Puoi descrivere un'applicazione in una cartella app.

Console

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

   Vai a Applicazioni

2. Nell'elenco delle applicazioni, fai clic su quella 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.

Aggiorna un'applicazione App Hub

Puoi aggiornare gli attributi della tua applicazione dopo la sua creazione.

Console

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

   Vai a Applicazioni

2. Nell'elenco delle applicazioni, fai clic su Modifica per l'applicazione che vuoi aggiornare.

3. Modifica i campi in base alle necessità.

4. Fai clic su Salva.

gcloud

1. Aggiorna la tua 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 della tua 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 è critica un'applicazione, un servizio o un workload per le tue 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 di sviluppatore, operatore e proprietari dell'attività, rispettivamente.
   • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR e EMAIL-NAME-BUSINESS: indirizzi email rispettivamente dello sviluppatore, dell'operatore e dei proprietari dell'attività. Questi valori devono avere il formato username@yourdomain, ad esempio, [e-mail].

   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 servizi e workload:

   1. Nella console Google Cloud , vai alla pagina Servizi e workload 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 che corrispondono al filtro specificato.

gcloud

Elenco dei servizi rilevati

I servizi rilevati sono disponibili per la registrazione a un'applicazione.

1. Per elencare i servizi rilevati:

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

   Vedi 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 forwarding nella cartella abilitata per le app:

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

Elenca i 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
   

   Vedi 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 separati, sono indicati da un valore vuoto nel campo SERVICE_REFERENCE.

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 rilevati

I carichi di lavoro rilevati sono disponibili per essere registrati in un'applicazione.

1. Per elencare i workload rilevati:

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

   Vedi 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, per filtrare l'elenco dei workload 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 di 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
   

   Vedi 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 separati, sono indicati da un valore vuoto nel campo WORKLOAD_REFERENCE. Per ulteriori informazioni sugli stati di registrazione, consulta le proprietà e gli attributi di App Hub.

2. (Facoltativo) Filtra l'elenco dei workload 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
   

Aggiorna servizi e workload

Puoi aggiornare i servizi e i workload registrati in un'applicazione.

Nota :i valori che fornisci per i campi Criticità e Ambiente possono essere diversi da quelli impostati durante la creazione dell'applicazione.

Console

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

   Vai a Applicazioni

2. Fai clic sul nome dell'applicazione.
   Viene visualizzata la scheda Servizi e workload con un elenco di servizi e workload registrati che si trovano nei tuoi progetti di servizio.

3. Per ogni servizio o carico di lavoro che vuoi aggiornare, procedi nel seguente modo:

   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 tuo servizio con gli attributi criticality-type, environment-type e tipo di 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 un 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 è critica un'applicazione, un servizio o un workload per le tue 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 di sviluppatore, operatore e proprietari dell'attività, rispettivamente.
   • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR e EMAIL-NAME-BUSINESS: indirizzi email rispettivamente dello sviluppatore, dell'operatore e dei proprietari dell'attività. Questi valori devono avere il formato username@yourdomain, ad esempio, [e-mail].

   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 tuo workload 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 è critica un'applicazione, un servizio o un workload per le tue 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 di sviluppatore, operatore e proprietari dell'attività, rispettivamente.
   • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR e EMAIL-NAME-BUSINESS: indirizzi email rispettivamente dello sviluppatore, dell'operatore e dei proprietari dell'attività. Questi valori devono avere il formato username@yourdomain, ad esempio, [e-mail].

   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
   

Elimina 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 all'applicazione.

Console

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

   Vai a Applicazioni

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

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

   1. Nella scheda Servizi e carichi di lavoro, nella sezione Servizi e carichi di lavoro registrati, fai clic sul nome del servizio o del carico di lavoro di cui vuoi annullare la registrazione.
   2. Nella pagina del servizio o del carico di lavoro registrato che si apre, fai clic su Annulla registrazione 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. Annulla 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 tutti i 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. Annulla la registrazione del workload dall'applicazione:

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

   Il workload è ora un workload 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

• Configurare il monitoraggio delle applicazioni
• Ruoli e autorizzazioni IAM di App Hub
• Panoramica di App Hub
• Risolvere i problemi