Gestire servizi e workload

App Hub ti consente di gestire i servizi e i workload registrati e rilevati direttamente, in modo da mantenere accurati i metadati delle applicazioni. Man mano che la tua infrastruttura cambia, puoi visualizzare i dettagli dei componenti, aggiornare gli attributi o annullare la registrazione dei componenti di un'applicazione.

Per le applicazioni di cui è stato eseguito il deployment da un modello, aggiorna i componenti in Application Design Center.

Panoramica

Quando scegli il modello di configurazione dell'applicazione, definisci un confine di gestione delle applicazioni per le tue applicazioni App Hub in un progetto di gestione. Puoi quindi registrare servizi e workload nelle applicazioni all'interno di questo confine. Per i casi d'uso consigliati per introdurre pratiche di gestione delle applicazioni, consulta Preparati alla gestione del ciclo di vita delle applicazioni.

Per evitare la deviazione della configurazione e mantenere una fonte di attendibilità chiara, ti consigliamo di gestire i componenti dell'applicazione nell'ambiente in cui sono stati definiti originariamente:

• Per le applicazioni di cui è stato eseguito il deployment da un template di Application Design Center: utilizza Application Design Center per gestire e aggiornare l'applicazione. Puoi rivedere il modello per apportare modifiche al design dell'applicazione o creare una revisione dell'applicazione per aggiornare impostazioni come i dettagli dell'applicazione e dei componenti.

  Vai ad Application Design Center

• Per le applicazioni create registrando le risorse esistenti in App Hub: gestisci applicazioni, servizi e workload direttamente in App Hub.

  Vai ad App Hub

Prima di iniziare

Questo documento presuppone che tu abbia un'applicazione con risorse supportate registrate.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per gestire servizi e workload in App Hub, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto di gestione che definisce il confine di gestione delle applicazioni:

• Aggiornare e annullare la registrazione di servizi e workload: App Hub Editor (roles/apphub.editor)
• Visualizza servizi, workload e i relativi dettagli: App Hub Viewer (roles/apphub.viewer)

Per saperne di più 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.

Per saperne di più sui ruoli di App Hub, consulta Ruoli e autorizzazioni IAM di App Hub.

Visualizza i dettagli di servizi e workload

Segui questi passaggi per visualizzare i dettagli di servizi e workload all'interno del confine di gestione delle applicazioni, tra cui:

• Località
• Stato della registrazione a un'applicazione
• Proprietà e attributi

Per saperne di più su questi dettagli, consulta Concetti e modello di dati di App Hub.

Console

Visualizza i dettagli dei servizi e dei workload di un'applicazione con un valore dello stato di registrazione registrato o scollegato:

1. Nella console Google Cloud , utilizza il selettore di progetti per selezionare il progetto di gestione.

2. Vai alla pagina Applicazioni da App Hub:

   Vai a Applicazioni

   La pagina mostra un elenco delle tue applicazioni.

3. Fai clic sul nome dell'applicazione da cui vuoi visualizzare i dettagli del servizio o del workload.

4. Nella scheda Servizi e workload, fai clic sul nome del servizio o del workload che vuoi visualizzare.

5. Nella pagina Dettagli del componente, puoi visualizzare informazioni come il nome visualizzato, la località, lo stato di registrazione, le proprietà e gli attributi.

In alternativa, visualizza un elenco di tutti i servizi e i workload con un valore dello stato di registrazione rilevato o registrato:

1. Vai alla pagina Servizi e workload da App Hub:

   Vai a Servizi e workload

   La pagina mostra un elenco di tutti i servizi e i workload rilevati e registrati.

2. Utilizza il campo Filtro per restringere i risultati in base a proprietà, attributi o stato, utilizzando valori come Ambiente, Proprietari o Stato registrazione.

gcloud

Visualizza i dettagli dei servizi e dei workload di un'applicazione con un valore dello stato di registrazione registrato o scollegato:

1. Trova l'ID progetto del tuo progetto di gestione.

2. Descrivi un servizio o un workload di un'applicazione per esaminarne i dettagli, tra cui proprietà e attributi:

   • Descrivi un servizio:

     gcloud apphub applications services describe SERVICE \
         --project=PROJECT_ID \
         --application=APPLICATION \
         --location=LOCATION
     

     Sostituisci quanto segue:

     • SERVICE: l'ID del servizio.
     • PROJECT_ID: l'ID del progetto di gestione.
     • APPLICATION: l'ID dell'applicazione in cui è registrato il servizio.
     • LOCATION: la località del servizio. Utilizza global per le risorse globali o una regione specifica, ad esempio us-east1, per le risorse regionali.

   • Descrivi un workload:

     gcloud apphub applications workloads describe WORKLOAD \
         --project=PROJECT_ID \
         --application=APPLICATION \
         --location=LOCATION
     

     Sostituisci quanto segue:

     • WORKLOAD: l'ID del workload.
     • PROJECT_ID: l'ID del progetto di gestione.
     • APPLICATION: l'ID dell'applicazione a cui è registrato il workload.
     • LOCATION: la località del workload. Utilizza global per le risorse globali o una regione specifica, ad esempio us-east1, per le risorse regionali.

L'output mostra i dettagli del componente, ad esempio il nome visualizzato, la località e lo stato della registrazione. Include anche proprietà e attributi, se presenti nella risorsa.

In alternativa, visualizza un elenco di tutti i servizi e i workload con un valore dello stato di registrazione rilevato o registrato:

Rilevato

Le risorse Google Cloud rilevate all'interno del confine di gestione delle applicazioni sono disponibili per essere registrate come servizi o workload in un'applicazione. Per elencare le risorse individuate, segui questi passaggi:

1. Elenca i servizi rilevati:

   gcloud apphub discovered-services list \
       --project=PROJECT_ID \
       --location=LOCATION
   

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID del progetto di gestione.
   • LOCATION: la località in cui vuoi scoprire le risorse. Utilizza global per le risorse globali o una regione specifica, ad esempio us-east1, per le risorse regionali.

2. Elenca i workload rilevati:

   gcloud apphub discovered-workloads list \
       --project=PROJECT_ID \
       --location=LOCATION
   

Registrato

I servizi e i workload registrati fanno parte di un'applicazione. Segui questi passaggi per elencare i componenti registrati di una determinata applicazione. Puoi filtrare l'elenco in base agli attributi utilizzando il flag --filter:

1. Elenca i servizi registrati in un'applicazione:

   gcloud apphub applications services list \
       --application=APPLICATION_NAME \
       --project=PROJECT_ID \
       --location=LOCATION \
       --filter=FILTER_EXPRESSION
   

   Sostituisci quanto segue:

   • APPLICATION_NAME: il nome della tua applicazione. Questo valore viene specificato quando crei un'applicazione.
   • PROJECT_ID: l'ID del progetto di gestione.
   • LOCATION: la posizione del componente. Utilizza global per i componenti globali o una regione specifica, ad esempio us-east1, per i componenti regionali.
   • (Facoltativo) FILTER_EXPRESSION: l'espressione di filtro per specificare gli attributi. Ad esempio, per elencare i componenti con un tipo di ambiente PRODUCTION, utilizza attributes.environment.type=PRODUCTION.

2. Elenca i workload registrati in un'applicazione:

   gcloud apphub applications workloads list \
       --application=APPLICATION_NAME \
       --project=PROJECT_ID \
       --location=LOCATION \
       --filter=FILTER_EXPRESSION
   

Lo stato di registrazione dei servizi e dei workload in un'applicazione potrebbe cambiare in scollegato se sposti un progetto o una cartella fuori dal confine di gestione delle applicazioni o se elimini la risorsa sottostante. I servizi e i workload scollegati rimangono nell'applicazione finché non ne annulli la registrazione, ma App Hub non può più gestirli o monitorarli. Per saperne di più, consulta Stato di registrazione di servizi e workload.

Per ricollegare servizi o workload a un'applicazione, devi registrarli di nuovo.

Visualizza gli schemi dei metadati estesi

Anteprima

Questo prodotto o questa funzionalità sono soggetti ai "Termini dell'offerta pre-GA" nella sezione Termini di servizio generali dei Termini specifici dei servizi. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

App Hub arricchisce i tuoi servizi e workload con metadati per migliorare la rilevabilità, la governance e l'integrazione con altri sistemi. Puoi cercare gli schemi dei metadati disponibili e visualizzarne le definizioni utilizzando l'API App Hub.

Segui questi passaggi per visualizzare la definizione dello schema della proprietà dei metadati estesi, elencando tutti gli schemi disponibili o recuperando i dettagli di uno schema specifico, se disponibile.

Per ulteriori informazioni sulla proprietà dei metadati estesi, consulta Proprietà e attributi. Per un elenco dei tipi di metadati supportati e dei relativi schemi, consulta Schemi di metadati estesi.

gcloud

• Elenca tutti gli schemi di metadati estesi disponibili in un progetto e in una località:

  gcloud alpha apphub extended-metadata-schemas list \
      --project=PROJECT_ID \
      --location=LOCATION \
  

  Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto di gestione.
  • LOCATION: la posizione del componente. Utilizza global per i componenti globali o una regione specifica, ad esempio us-east1, per i componenti regionali.

• Visualizza i dettagli di uno schema specifico:

  gcloud alpha apphub extended-metadata-schemas describe SCHEMA_NAME \
      --project=PROJECT_ID \
      --location=LOCATION \
  

  Sostituisci SCHEMA_NAME con il nome completo dello schema, ad esempio apphub.googleapis.com/AgentProperties.

Terraform

Puoi utilizzare un'origine dati in Terraform per recuperare i dettagli di uno schema specifico. L'esempio seguente consente di visualizzare i dettagli dello schema apphub.googleapis.com/AgentProperties per un workload con il tipo funzionale AGENT nel progetto my-project-id nella località us-central1.

data "google_apphub_extended_metadata_schema" "agent_properties" {
  project  = "my-project-id"
  location = "us-central1"
  name     = "apphub.googleapis.com/AgentProperties"
}

Aggiorna gli attributi di servizi e workload

Per modificare gli attributi di servizi e workload registrati in un'applicazione, segui questi passaggi:

Nota: non puoi modificare gli attributi per i servizi condivisi.

Console

1. Nella console Google Cloud , utilizza il selettore di progetti per selezionare il progetto di gestione.

2. Vai alla pagina Applicazioni da App Hub:

   Vai a Applicazioni

   La pagina mostra un elenco delle tue applicazioni.

3. Fai clic sul nome dell'applicazione per cui vuoi aggiornare gli attributi del servizio o del workload.

4. Nella scheda Servizi e workload, trova il nome del servizio o del workload che vuoi aggiornare.

5. Fai clic su more_vert Altro, quindi su Modifica servizio o Modifica workload.

6. Nel riquadro che si apre, modifica i campi in base alle necessità e fai clic su Salva.

gcloud

1. Trova l'ID progetto del tuo progetto di gestione.

2. Aggiorna gli attributi del servizio o del workload:

   • Aggiorna gli attributi del servizio:

     gcloud apphub applications services update SERVICE_NAME \
         --application=APPLICATION_NAME \
         --project=PROJECT_ID \
         --location=LOCATION \
         --display-name=DISPLAY_NAME \
         --criticality-type=CRITICALITY_LEVEL \
         --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
     

     Sostituisci SERVICE_NAME con il nome del servizio che vuoi aggiornare.

   • Aggiorna gli attributi del workload:

     gcloud apphub applications workloads update WORKLOAD_NAME \
         --application=APPLICATION_NAME \
         --project=PROJECT_ID \
         --location=LOCATION \
         --display-name=DISPLAY_NAME \
         --criticality-type=CRITICALITY_LEVEL \
         --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
     

     Sostituisci WORKLOAD_NAME con il nome del workload che vuoi aggiornare.

     Sostituisci i seguenti flag obbligatori e facoltativi:

     • Obbligatorio: APPLICATION_NAME: il nome della tua applicazione. Questo valore viene specificato quando crei un'applicazione.
     • Obbligatorio: PROJECT_ID: l'ID del progetto di gestione.
     • Obbligatorio: LOCATION: la località del componente. Utilizza global per i componenti globali o una regione specifica, ad esempio us-east1, per i componenti regionali.
     • (Facoltativo) DISPLAY_NAME: il nome visualizzato del componente.

     • (Facoltativo) CRITICALITY_LEVEL: il livello di importanza del componente. Utilizza uno dei seguenti valori:

       • MISSION_CRITICAL
       • HIGH
       • MEDIUM
       • LOW

     • (Facoltativo) ENVIRONMENT: la fase del ciclo di vita del software. Usa uno dei seguenti valori:

       • PRODUCTION
       • STAGING
       • DEVELOPMENT
       • TEST

     • Facoltativo: DEV_NAME e DEV_EMAIL: rispettivamente il nome visualizzato e l'indirizzo email del proprietario sviluppatore.

     • (Facoltativo) OPERATOR_NAME e OPERATOR_EMAIL: rispettivamente il nome visualizzato e l'indirizzo email del proprietario dell'operatore.

     • (Facoltativo) BUSINESS_NAME e BUSINESS_EMAIL: rispettivamente il nome visualizzato e l'indirizzo email del proprietario dell'attività.

     Nota: gli indirizzi email devono avere il formato username@yourdomain, ad esempio [e-mail].

Terraform

Per aggiornare gli attributi del servizio o del workload con Terraform, modifica gli argomenti all'interno del blocco di risorse google_apphub_service o google_apphub_workload corrispondente nel file di configurazione. Quando applichi le modifiche, Terraform aggiorna la risorsa in modo che corrisponda alla nuova configurazione.

I seguenti esempi aggiornano gli attributi di criticità e ambiente dei servizi e dei workload di un'applicazione regionale:

• Aggiorna gli attributi del servizio:

  resource "google_apphub_service" "example" {
      # ... other arguments
      attributes {
          criticality {
              type = "HIGH" # Updated criticality
          }
          environment {
              type = "PRODUCTION"
          }
          # ... other attributes
      }
  }
  

• Aggiorna gli attributi del workload:

  resource "google_apphub_workload" "example" {
      # ... other arguments
      attributes {
          criticality {
              type = "HIGH" # Updated criticality
          }
          environment {
              type = "PRODUCTION"
          }
          # ... other attributes
      }
  }
  

Annulla la registrazione di servizi e workload

L'annullamento della registrazione di un servizio o di un workload lo rimuove da un'applicazione. La risorsa sottostante non viene eliminata. Se si trova ancora all'interno del confine di gestione delle applicazioni, diventa una risorsa con lo stato di registrazione rilevata, disponibile per la registrazione in un'altra applicazione.

Segui questi passaggi per annullare la registrazione di servizi e workload:

Console

1. Nella console Google Cloud , utilizza il selettore di progetti per selezionare il progetto di gestione.

2. Vai alla pagina Applicazioni da App Hub:

   Vai a Applicazioni

   La pagina mostra un elenco delle tue applicazioni.

3. Fai clic sul nome dell'applicazione da cui vuoi annullare la registrazione di servizi o workload.

4. Nella scheda Servizi e workload, fai clic sul nome del servizio o del workload di cui vuoi annullare la registrazione.

5. Nella pagina dei dettagli del componente, fai clic su Annulla registrazione.

gcloud

1. Trova l'ID progetto del tuo progetto di gestione.

2. Annulla la registrazione di un servizio o di un workload:

   • Annulla la registrazione di un servizio:

     gcloud apphub applications services delete SERVICE_NAME \
         --application=APPLICATION_NAME \
         --project=PROJECT_ID \
         --location=LOCATION
     

     Sostituisci quanto segue:

     • SERVICE_NAME: il nome del servizio di cui vuoi annullare la registrazione.
     • APPLICATION_NAME: il nome della tua applicazione. Questo valore viene specificato quando crei un'applicazione.
     • PROJECT_ID: l'ID del progetto di gestione.
     • LOCATION: la posizione del componente. Utilizza global per i componenti globali o una regione specifica, ad esempio us-east1, per i componenti regionali.

   • Annulla la registrazione di un workload:

     gcloud apphub applications workloads delete WORKLOAD_NAME \
         --application=APPLICATION_NAME \
         --project=PROJECT_ID \
         --location=LOCATION
     

     Sostituisci WORKLOAD_NAME con il nome del workload di cui vuoi annullare la registrazione.

Terraform

Per annullare la registrazione di un servizio o di un workload gestito da Terraform, rimuovi il blocco di risorse google_apphub_service o google_apphub_workload corrispondente dal file di configurazione ed esegui terraform apply. Quando applichi le modifiche, Terraform rimuove la registrazione da App Hub.

Dopo aver annullato la registrazione di tutti i servizi e i workload, puoi eliminare l'applicazione.

Passaggi successivi

• Gestisci le tue applicazioni
• Ottimizza un'applicazione con i suggerimenti di progettazione
• Monitora le tue applicazioni