Gestire le applicazioni App Hub

Quando scegli il modello di configurazione dell'applicazione, definisci un limite di gestione delle applicazioni per le applicazioni App Hub in un progetto di gestione. Puoi quindi registrare servizi e workload nelle applicazioni all'interno di questo limite.

Per i casi d'uso consigliati per introdurre le pratiche di gestione delle applicazioni, consulta Prepararsi alla gestione delle applicazioni. Per creare un'applicazione e registrare le risorse, consulta Registrare le risorse esistenti in un'applicazione.

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:

Questa pagina descrive come gestire le applicazioni registrate direttamente in App Hub. Puoi eseguire queste azioni utilizzando la Google Cloud console 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 le applicazioni in App Hub, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto di gestione che definisce il limite 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 le applicazioni

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

Console

  1. Nella Google Cloud console, utilizza il selettore di progetti per selezionare il tuo 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 tuo 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 --filter flag:

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

      Sostituisci quanto segue:

      • PROJECT_ID: l'ID del tuo 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 Google Cloud console, utilizza il selettore di progetti per selezionare il tuo 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 dell'applicazione. Specifichi questo valore quando crei un'applicazione.
    • PROJECT_ID: l'ID del tuo progetto di gestione.
    • LOCATION: la posizione dell'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 la sua creazione, segui questi passaggi. I servizi e i workload possono anche utilizzare gli stessi attributi dell'applicazione durante la registrazione.

Console

  1. Nella Google Cloud console, utilizza il selettore di progetti per selezionare il tuo 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 uno qualsiasi degli attributi modificabili, 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 dell'applicazione. Specifichi questo valore quando crei un'applicazione.
    • Obbligatorio: PROJECT_ID: l'ID del tuo progetto di gestione.
    • Obbligatorio: LOCATION: la posizione dell'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 dell'applicazione.

    • (Facoltativo) CRITICALITY_LEVEL: il livello di importanza dell'applicazione. 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 dell'applicazione con Terraform, modifica gli argomenti all'interno del google_apphub_application blocco di risorse 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. Quindi, segui questi passaggi per eliminare l'applicazione:

Console

  1. Nella Google Cloud console, utilizza il selettore di progetti per selezionare il tuo 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 Annullare 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 Annullare la registrazione di servizi e workload.

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

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

    Sostituisci quanto segue:

    • APPLICATION_NAME: il nome dell'applicazione. Specifichi questo valore quando crei un'applicazione.
    • PROJECT_ID: l'ID del tuo progetto di gestione.
    • LOCATION: la posizione dell'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 google_apphub_application blocco di risorse dal file Terraform e poi esegui terraform apply. Terraform riconosce che la risorsa non è più 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