Gestire servizi e workload

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 le pratiche di gestione delle applicazioni, vedi Prepararsi alla gestione del ciclo di vita delle applicazioni.

Per evitare la deriva della configurazione e mantenere una fonte di verità 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 modello di Application Design Center: Utilizza Application Design Center per gestire e aggiornare l'applicazione. Puoi rivedere il modello per le modifiche alla progettazione dell'applicazione o creare una revisione dell'applicazione per aggiornare le impostazioni, ad esempio i dettagli dell'applicazione e dei componenti.

  Vai ad Application Design Center

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

  Vai ad App Hub

Questa pagina descrive come gestire i servizi e i workload rilevati o registrati direttamente in App Hub. Puoi eseguire queste azioni utilizzando la console Google Cloud o Google Cloud CLI. Per le applicazioni di cui è stato eseguito il deployment da un modello, consulta la documentazione di App Design Center.

Prima di iniziare

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

Ruoli obbligatori

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

• Aggiorna e annulla la registrazione di servizi e workload: Editor App Hub (roles/apphub.editor)
• Visualizza servizi, workload e relativi dettagli: Visualizzatore App Hub (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, inclusi posizione, stato di registrazione a un'applicazione, attributi e proprietà, all'interno del limite di gestione delle applicazioni. Per saperne di più su questi dettagli, consulta Concetti e modello di dati di App Hub.

Console

Visualizza i dettagli di servizi e carichi di lavoro di un'applicazione con un valore dello stato di registrazione registrato o separato:

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 carichi di lavoro, fai clic sul nome del servizio o del carico di lavoro che vuoi visualizzare.

5. Nella pagina Dettagli del componente, puoi visualizzare informazioni come nome visualizzato, posizione, stato di registrazione, proprietà e attributi.

In alternativa, visualizza un elenco di tutti i servizi e i carichi di lavoro con un valore di stato di registrazione pari a Rilevato o Registrato:

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

   Vai a Servizi e carichi di lavoro

   La pagina mostra un elenco di tutti i servizi e i carichi di lavoro 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 di servizi e carichi di lavoro di un'applicazione con un valore dello stato di registrazione registrato o separato:

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 tuo progetto di gestione.
     • APPLICATION: l'ID dell'applicazione a cui è registrato il servizio.
     • LOCATION: la posizione 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 tuo progetto di gestione.
     • APPLICATION: l'ID dell'applicazione a cui è registrato il workload.
     • LOCATION: la posizione 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, come il nome visualizzato, la posizione e lo stato di 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 di stato di registrazione pari a Rilevato o Registrato:

Rilevato

Le risorse Google Cloud scoperte all'interno del limite di gestione delle applicazioni sono disponibili per essere registrate come servizi o workload in un'applicazione. Per elencare le risorse rilevate:

1. Elenca i servizi rilevati:

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

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID del tuo 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. Specifichi questo valore quando crei un'applicazione.
   • PROJECT_ID: l'ID del tuo 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 di servizi e workload in un'applicazione potrebbe cambiare in detached se sposti un progetto o una cartella al di fuori del limite di gestione delle applicazioni o se elimini la risorsa sottostante. I servizi e i workload scollegati rimangono nell'applicazione finché non li annulli la registrazione, ma App Hub non può più gestirli o monitorarli. Per ulteriori informazioni, vedi Stato di registrazione di servizi e workload.

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

Visualizzare gli schemi dei metadati estesi

Anteprima

Questo prodotto o funzionalità è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini di servizio specifici. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni delle fasi di lancio.

App Hub arricchisce i tuoi servizi e carichi di lavoro con metadati per migliorare l'individuazione, la governance e l'integrazione con altri sistemi. Puoi cercare gli schemi di 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 ottenendo i dettagli di uno schema specifico, se disponibile. Per saperne di più sulla proprietà dei metadati estesi, consulta Proprietà e attributi. Per un elenco dei tipi di metadati supportati e dei relativi schemi, vedi Schemi dei metadati estesi.

gcloud

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

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

  Sostituisci quanto segue:

  • PROJECT_ID: l'ID del tuo 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 carico di lavoro 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 servizio e workload

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

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 carichi di lavoro, trova il nome del servizio o del carico di lavoro che vuoi aggiornare.

5. Fai clic su more_vert Altro, poi fai clic 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 da aggiornare.

     Sostituisci i seguenti flag obbligatori e facoltativi:

     • Obbligatorio: APPLICATION_NAME: il nome della tua applicazione. Specifichi questo valore quando crei un'applicazione.
     • Obbligatorio: PROJECT_ID: l'ID del progetto di gestione.
     • Obbligatorio: LOCATION: la posizione 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. Utilizza uno dei seguenti valori:

       • PRODUCTION
       • STAGING
       • DEVELOPMENT
       • TEST

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

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

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

     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.

Gli esempi seguenti aggiornano gli attributi di criticità e ambiente di servizi e 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 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 rientra ancora nel limite di gestione delle applicazioni, diventa una risorsa con un valore di stato di registrazione scoperto, disponibile per la registrazione a un'altra applicazione.

Per annullare la registrazione di servizi e carichi di lavoro:

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 carichi di lavoro, fai clic sul nome del servizio o del carico di lavoro 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:

   • Annullare 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 che vuoi annullare la registrazione.
     • APPLICATION_NAME: il nome della tua applicazione. Specifichi questo valore quando crei un'applicazione.
     • PROJECT_ID: l'ID del tuo 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 carico di lavoro che vuoi annullare la registrazione.

Terraform

Per annullare la registrazione di un servizio o di un carico di lavoro 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

• Gestire le applicazioni
• Ottimizzare un'applicazione con i consigli di progettazione
• Monitorare le applicazioni