Gestire servizi e workload

Quando configuri App Hub, crei un confine amministrativo per le tue applicazioni. Questo confine è il progetto di gestione o l'insieme di progetti host e di servizio che hai configurato per la gestione delle applicazioni, a seconda del modello di configurazione. Servizi e workload sono registrati come applicazioni all'interno di questo limite amministrativo.

Per evitare la deriva della configurazione e mantenere una fonte di verità chiara, ti consigliamo di gestire le risorse dell'applicazione nell'ambiente in cui sono state originariamente definite:

  • 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 in App Hub: gestisci l'applicazione, i relativi servizi e i 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 come applicazioni. 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

Prima di poter visualizzare, aggiornare e annullare la registrazione di servizi e workload in App Hub, completa i seguenti passaggi:

  1. Configura App Hub utilizzando uno dei modelli di configurazione supportati.
  2. Registra le risorse supportate in un'applicazione.

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 confine amministrativo dell'applicazione del modello di configurazione (il progetto di gestione o i progetti host e di servizio) :

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.

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

Visualizza i dettagli di servizi e carichi di lavoro

Segui questi passaggi per visualizzare i dettagli di servizi e workload, inclusi la posizione e lo stato di registrazione di un'applicazione, all'interno del limite amministrativo di App Hub:

Console

Visualizza i dettagli dei servizi e dei carichi di lavoro registrati o separati da un'applicazione:

  1. Nella pagina Benvenuto della console Google Cloud , utilizza il selettore di progetti per selezionare il progetto di gestione o il progetto host:

    Vai a Benvenuto

  2. Vai alla pagina Applicazioni di 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 servizi o i workload.

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

  5. Nella pagina Dettagli della risorsa, puoi visualizzare dettagli come il nome visualizzato, la posizione, lo stato di registrazione e gli 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 di 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 ad attributi come Ambiente o Stato della registrazione.

gcloud

Visualizza i dettagli dei servizi e dei carichi di lavoro registrati o separati da un'applicazione:

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

  2. Descrivi un servizio o un carico di lavoro di un'applicazione per esaminarne i dettagli:

    • 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 host o del 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 progetto host o del 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 della risorsa, come il nome visualizzato, la posizione, lo stato di registrazione e gli 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:

Risorse rilevate

Le risorse rilevate sono disponibili per essere registrate 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 progetto host o 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

Risorse registrate

Le risorse registrate fanno parte di un'applicazione. Segui questi passaggi per elencare le risorse registrate 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 progetto host o del progetto di gestione.
    • LOCATION: la posizione della risorsa. Utilizza global per le risorse globali o una regione specifica, ad esempio us-east1, per le risorse regionali.
    • (Facoltativo) FILTER_EXPRESSION: l'espressione di filtro per specificare gli attributi. Ad esempio, per elencare le risorse 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 carichi di lavoro di un'applicazione può cambiare in disaccoppiato se modifichi la struttura organizzativa delle tue risorse Google Cloud o 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 carichi di lavoro a un'applicazione, devi registrarli di nuovo in base alla gerarchia delle risorse del tuo modello di configurazione.

Aggiorna gli attributi di servizio e workload

Per modificare gli attributi definiti dall'utente di servizi e carichi di lavoro registrati a un'applicazione:

Console

  1. Nella pagina Benvenuto della console Google Cloud , utilizza il selettore di progetti per selezionare il progetto di gestione o il progetto host:

    Vai a Benvenuto

  2. Vai alla pagina Applicazioni di 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 o progetto host.

  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 host o del progetto di gestione.
      • Obbligatorio: LOCATION: la posizione della risorsa. Utilizza global per le risorse globali o una regione specifica, ad esempio us-east1, per le risorse regionali.
      • (Facoltativo) DISPLAY_NAME: il nome visualizzato della risorsa.

      • Facoltativo: CRITICALITY_LEVEL: il livello di importanza della risorsa. 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 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 e diventa di nuovo una risorsa rilevata, disponibile per la registrazione a un'altra applicazione.

Per annullare la registrazione di servizi e carichi di lavoro:

Console

  1. Nella pagina Benvenuto della console Google Cloud , utilizza il selettore di progetti per selezionare il progetto di gestione o il progetto host:

    Vai a Benvenuto

  2. Vai alla pagina Applicazioni di 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 della risorsa, fai clic su Annulla registrazione.

gcloud

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

  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 progetto host o del progetto di gestione.
      • LOCATION: la posizione della risorsa. Utilizza global per le risorse globali o una regione specifica, ad esempio us-east1, per le risorse 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