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 modificare il modello per apportare 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 template, consulta la documentazione di Application Design Center.

Prima di iniziare

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

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per gestire servizi e 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 dei servizi e dei carichi di lavoro 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 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 dei servizi e dei carichi di lavoro 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 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 carichi di lavoro 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.

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, quindi fai clic su Modifica servizio o Modifica workload.

  6. Nel riquadro che si apre, modifica i campi in base alle esigenze 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.

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 workload 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