Gestire le applicazioni App Hub

App Hub ti consente di visualizzare le applicazioni registrate, aggiornarne gli attributi ed eliminarle in modo da mantenere accurato l'inventario delle applicazioni. Per evitare la deviazione della configurazione, utilizza App Hub solo per aggiornare o eliminare le applicazioni che hai registrato direttamente e gestisci le applicazioni in base ai modelli 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 delle applicazioni. Per creare un'applicazione e registrare le risorse, consulta Registra le risorse esistenti in un'applicazione.

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

In App Hub, puoi eseguire queste azioni utilizzando la consoleGoogle 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 abbia un'applicazione con risorse supportate registrate.

Ruoli obbligatori

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

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.

Elenca applicazioni

Segui questi passaggi per elencare e filtrare tutte le applicazioni all'interno del tuo confine di gestione delle applicazioni:

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. Per filtrare l'elenco, utilizza il campo Filtra. Puoi filtrare in base ad attributi come Criticità o Ambiente.

gcloud

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

  2. Visualizza un elenco delle tue applicazioni utilizzando una delle seguenti opzioni:

    • Elenca tutte le applicazioni:

      gcloud apphub applications list \
    --project=PROJECT_ID \
    --location=LOCATION

      Sostituisci quanto segue:

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

    • Filtra l'elenco delle applicazioni in base agli attributi utilizzando il flag --filter:

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

      Sostituisci quanto segue:

      • PROJECT_ID: l'ID del progetto di gestione.
      • LOCATION: la posizione delle tue applicazioni. Utilizza global per le applicazioni globali o una regione specifica, ad esempio us-east1, per le applicazioni regionali.
      • FILTER_EXPRESSION: l'espressione di filtro per specificare gli attributi. Ad esempio, per elencare tutte le applicazioni con un tipo di ambiente PRODUCTION, utilizza attributes.environment.type=PRODUCTION.

Visualizza i dettagli dell'applicazione

Segui questi passaggi per visualizzare le informazioni dettagliate di un'applicazione specifica, inclusi i relativi attributi e metadati:

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 che vuoi visualizzare.

    Viene visualizzata la scheda Dettagli dell'applicazione.

gcloud

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

  2. Descrivi un'applicazione:

    gcloud apphub applications describe APPLICATION_NAME \
    --project=PROJECT_ID \
    --location=LOCATION

    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 località della tua applicazione. Utilizza global per le applicazioni globali o una regione specifica, ad esempio us-east1, per le applicazioni regionali.

Aggiorna gli attributi dell'applicazione

Per modificare gli attributi di un'applicazione dopo che è stata creata, segui questi passaggi. Anche i servizi e i workload possono utilizzare gli stessi attributi dell'applicazione durante la registrazione.

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. Per l'applicazione che vuoi aggiornare, fai clic su Modifica.

  4. Nel riquadro Modifica applicazione, modifica i campi in base alle necessità.

  5. Fai clic su Salva.

gcloud

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

  2. Aggiorna gli attributi dell'applicazione. Puoi aggiornare qualsiasi attributo modificabile, ad esempio display-name, criticality-type, environment-type e i proprietari:

    gcloud apphub applications update 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 quanto segue:

    • 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à della tua applicazione. Utilizza global per le applicazioni globali o una regione specifica, ad esempio us-east1, per le applicazioni regionali.
    • (Facoltativo) DISPLAY_NAME: il nome visualizzato della tua applicazione.

    • (Facoltativo) CRITICALITY_LEVEL: il livello di importanza dell'applicazione. Usa 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à.

Terraform

Per aggiornare gli attributi dell'applicazione con Terraform, modifica gli argomenti all'interno del blocco della risorsa google_apphub_application nel file di configurazione. Quando applichi le modifiche, Terraform aggiorna l'applicazione in modo che corrisponda alla nuova configurazione.

L'esempio seguente aggiorna gli attributi di criticità e ambiente di un'applicazione regionale in us-central1:

resource "google_apphub_application" "example" {
    project        = "my-project-id"
    location       = "us-central1"
    application_id = "my-application"
    display_name   = "My Application"
    description    = "This application represents our platform."
    attributes {
        criticality {
            type = "HIGH" # Updated criticality
        }
        environment {
            type = "PRODUCTION"
        }
        # ... other attributes
    }
}

Elimina un'applicazione

Prima di poter eliminare un'applicazione, devi prima annullare la registrazione di tutti i relativi servizi e workload. Poi, segui questi passaggi per eliminare l'applicazione:

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 che vuoi eliminare.

  4. Vai alla scheda Servizi e workload e assicurati di aver annullato la registrazione di tutti i componenti dell'applicazione. Per saperne di più, consulta Annulla la registrazione di servizi e workload.

  5. Dopo aver annullato la registrazione di tutti i servizi e i workload, torna ai dettagli dell'applicazione e fai clic su Elimina.

gcloud

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

  2. Assicurati di aver annullato la registrazione di tutti i componenti dell'applicazione. Per saperne di più, consulta Annulla la registrazione di servizi e workload.

  3. Dopo che l'applicazione non ha più componenti registrati, eliminala:

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

    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 località della tua applicazione. Utilizza global per le applicazioni globali o una regione specifica, ad esempio us-east1, per le applicazioni regionali.

Terraform

Per eliminare un'applicazione gestita da Terraform, hai le seguenti opzioni:

  • Rimuovi la risorsa dalla configurazione: elimina il blocco della risorsa google_apphub_application dal file Terraform, quindi esegui terraform apply. Terraform riconosce che la risorsa non è più presente nella configurazione e la elimina dal progetto.
  • Termina tutte le risorse: esegui il comando terraform destroy per terminare tutte le risorse gestite dalla configurazione Terraform, inclusa l'applicazione.

Passaggi successivi