Registra le risorse esistenti in un'applicazione

La registrazione dei servizi e dei workload esistenti in un'applicazione consente di semplificare la gestione organizzando le risorse in base al loro scopo aziendale. Questo approccio fornisce visibilità, monitoraggio, governance e controllo operativo unificati.

Questa guida mostra come raggruppare i servizi e i carichi di lavoro esistenti in esecuzione in Google Cloud che non sono ancora definiti formalmente come applicazione.

Prima di iniziare

Devi completare la configurazione iniziale per la gestione delle applicazioni prima di organizzare le risorse in applicazioni. Questo processo in genere prevede i seguenti ruoli e passaggi:

  • Per gli amministratori:

    1. Configura la gestione delle applicazioni. Configura una cartella abilitata per le app o un progetto host in modo che funga da confine amministrativo per le tue applicazioni.
    2. Abilita le API richieste Abilita le API per tutte le risorse che intendi utilizzare.
    3. Concedi l'accesso agli utenti. Assegna i ruoli IAM appropriati in base alle responsabilità dell'utente nel ciclo di vita dell'applicazione.

  • Per sviluppatori e operatori:

    1. Chiedi all'amministratore di confermare che la configurazione iniziale sia stata completata.
    2. Assicurati di disporre dei ruoli IAM necessari per le attività che vuoi eseguire.
    3. Apri la cartella abilitata per le app o il progetto host, a seconda del tuo modello di configurazione.

Crea un'applicazione

Crea un'applicazione in App Hub che funga da container logico per i tuoi servizi e workload esistenti:

Console

  1. Nella console Google Cloud , utilizza il selettore di progetti per selezionare il progetto host o il progetto di gestione della cartella abilitata per l'app, a seconda del tuo modello di configurazione.

  2. Vai alla pagina Applicazioni da App Hub:

    Vai a Applicazioni

  3. Fai clic su Crea applicazione.

  4. Nel riquadro Scegli la regione e il nome dell'applicazione, seleziona la posizione migliore per la tua applicazione in base ai requisiti di distribuzione geografica:

    • Seleziona Regionale per creare un'applicazione regionale. Poi, seleziona la regione specifica per la tua applicazione in base alle regioni supportate da App Hub.
    • Seleziona Globale per creare un'applicazione globale.

    Per saperne di più sulla posizione migliore per la tua applicazione, consulta Applicazioni globali e regionali.

  5. Inserisci il nome dell'applicazione e fai clic su Continua.

  6. (Facoltativo) Definisci gli attributi di primo livello dell'applicazione per supportare la rilevabilità e la governance:

    • Nella sezione Aggiungi attributi, inserisci il nome visualizzato.
    • Nell'elenco Criticità, seleziona un valore per indicare l'importanza dell'applicazione.
    • Nell'elenco Ambiente, seleziona un valore per indicare la fase del ciclo di vita del software.
    • Aggiungi i dettagli dei dati di contatto dei proprietari, inclusi nome visualizzato e indirizzo email. Tieni presente che gli indirizzi email devono avere il formato username@yourdomain, ad esempio jane-doe@gmail.com.

  7. Fai clic su Crea.

gcloud

  1. Utilizza Google Cloud CLI per creare un'applicazione dal terminale o da Cloud Shell:

    gcloud apphub applications create APPLICATION_NAME \
  --project=PROJECT_ID \
  --scope-type=LOCATION \
  --location=REGION \
  --display-name=DISPLAY_NAME \
  --criticality-type=CRITICALITY \
  --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 APPLICATION_NAME con il nome della tua applicazione. Il nome deve includere solo caratteri alfanumerici minuscoli senza spazi.

    Utilizza flag facoltativi come --criticality-type per definire gli attributi di primo livello dell'applicazione e supportare la rilevabilità e la governance.

    Per i flag obbligatori e facoltativi, sostituisci quanto segue:

    • Obbligatorio: PROJECT_ID: l'ID del progetto host o del progetto di gestione, a seconda del modello di configurazione.

    • Obbligatorio: LOCATION: la posizione della tua applicazione in base ai requisiti di distribuzione geografica. Utilizza uno dei seguenti valori:

      • REGIONAL per le applicazioni regionali.
      • GLOBAL per le applicazioni globali.

      Per saperne di più sulla posizione migliore per la tua applicazione, consulta Applicazioni globali e regionali.

    • Obbligatorio: REGION: la regione specifica per la tua applicazione. Utilizza uno dei seguenti valori:

      • Se la località --scope-type per la tua applicazione è impostata su REGIONAL, specifica un nome di regione supportato da App Hub.
      • Se la posizione --scope-type per la tua applicazione è impostata su GLOBAL, utilizza global.

    • (Facoltativo) DISPLAY_NAME: il nome visualizzato della tua applicazione.

    • (Facoltativo) CRITICALITY: il livello di importanza dell'applicazione per le tue operazioni. 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.

  2. Elenca le applicazioni nel tuo progetto:

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

    Devi ottenere un output simile al seguente:

    ID                 DISPLAY_NAME   CREATE_TIME
APPLICATION_NAME   DISPLAY_NAME   2023-10-31T18:33:48

Registra servizi e workload

Dopo aver creato un'applicazione, registra i servizi e i workload esistenti:

Console

  1. Nella console Google Cloud , utilizza il selettore di progetti per selezionare il progetto host o il progetto di gestione della cartella abilitata per l'app, a seconda del tuo modello di configurazione.

  2. Vai alla pagina Applicazioni da App Hub:

    Vai a Applicazioni

  3. Fai clic sul nome dell'applicazione per cui vuoi registrare servizi e carichi di lavoro esistenti.

  4. Nella pagina dei dettagli dell'applicazione, seleziona la scheda Servizi e carichi di lavoro. Questa scheda mostra l'elenco delle risorse esistenti che puoi registrare nell'applicazione. App Hub ti consente di selezionare risorse supportate che si trovano all'interno della gerarchia delle risorse come servizi e carichi di lavoro.

  5. Per ogni servizio o carico di lavoro che vuoi registrare, procedi nel seguente modo:

    1. Nella scheda Servizi e workload, fai clic su Registra servizio/workload.
    2. Vai al riquadro Seleziona risorsa e fai clic su Sfoglia per trovare il servizio o il workload che vuoi registrare.
    3. Scegli il servizio o il workload e fai clic su Seleziona.
    4. Nel riquadro Seleziona risorsa, inserisci un nome per il servizio o il carico di lavoro e fai clic su Continua.

    5. (Facoltativo) Nel riquadro Aggiungi attributi, definisci gli attributi di primo livello della risorsa per supportare la rilevabilità e la governance.

    6. Fai clic su Continua.

    7. (Facoltativo) Nella sezione Aggiungi proprietari, aggiungi ulteriori dettagli sui proprietari del servizio o del workload.

    8. Fai clic su Register (Registrati).

La scheda Servizi e workload mostra il servizio o il workload registrato.

gcloud

App Hub ti consente di selezionare risorse supportate situate all'interno della tua gerarchia delle risorse come servizi e carichi di lavoro. Utilizza Google Cloud CLI per elencare i servizi o i carichi di lavoro che puoi registrare nell'applicazione dal terminale o da Cloud Shell. I comandi sono leggermente diversi per servizi e carichi di lavoro:

Registra servizi

  1. Elenca i servizi disponibili che puoi registrare in un'applicazione:

    gcloud apphub discovered-services list \
  --project=PROJECT_ID \
  --location=REGION \
  --filter=FILTER_EXPRESSION

    Per i flag obbligatori e facoltativi, sostituisci quanto segue:

    • Obbligatorio: PROJECT_ID: l'ID del progetto host o del progetto di gestione, a seconda del modello di configurazione.

    • Obbligatorio: REGION: la regione specifica del tuo servizio in base alla tua distribuzione geografica. Utilizza uno dei seguenti valori:

    • (Facoltativo) FILTER_EXPRESSION: l'espressione di filtro per il flag --filter per visualizzare solo i servizi di un progetto specifico o con una proprietà specifica, ad esempio:

      • service_properties.gcp_project=projects/PROJECT_ID
      • service_properties.gcp_project=projects/PROJECT_ID AND service_reference.uri~"forwardingRules"

    L'output è simile al seguente:

    ID            SERVICE_REFERENCE                                                                                             SERVICE_PROPERTIES
SERVICE_ID    {'uri': '//compute.googleapis.com/projects/PROJECT_NUMBER/regions/REGION/forwardingRules/forwarding-rule'}    {'gcpProject': 'projects/PROJECT_ID', 'location': 'REGION'}

  2. Copia l'ID servizio, SERVICE_ID, dall'output.

  3. Registra il servizio nella tua applicazione:

    gcloud apphub applications services create SERVICE_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --application=APPLICATION_NAME \
  --discovered-service=projects/PROJECT_ID/locations/REGION/discoveredServices/SERVICE_ID \
  --display-name=SERVICE_DISPLAY_NAME \
  --criticality-type=CRITICALITY \
  --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 che vuoi utilizzare per registrare il servizio nell'applicazione.

    Utilizza flag facoltativi come --criticality-type per definire gli attributi di primo livello del servizio e supportare la rilevabilità e la governance.

    Per i flag obbligatori e facoltativi, sostituisci quanto segue:

    • Obbligatorio: PROJECT_ID: l'ID del progetto host o del progetto di gestione, a seconda del modello di configurazione.

    • Obbligatorio: REGION: la regione specifica del tuo servizio in base alla tua distribuzione geografica. Utilizza uno dei seguenti valori:

    • Obbligatorio: APPLICATION_NAME: il nome dell'applicazione per cui vuoi registrare il servizio.

    • Obbligatorio: SERVICE_ID: l'ID servizio che hai copiato dall'output precedente.

    • (Facoltativo) SERVICE_DISPLAY_NAME: il nome visualizzato del tuo servizio.

    • (Facoltativo) CRITICALITY: il livello di importanza del servizio per le tue operazioni. 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.

  4. Elenca i servizi registrati nella tua applicazione:

    gcloud apphub applications services list \
  --application=APPLICATION_NAME
  --project=PROJECT_ID \
  --location=REGION

    Per ogni servizio registrato, devi ottenere un output simile al seguente:

    ID              DISPLAY_NAME            SERVICE_REFERENCE                                                                                             CREATE_TIME
SERVICE_NAME    SERVICE_DISPLAY_NAME    {'uri': '//compute.googleapis.com/projects/PROJECT_NUMBER/regions/REGION/forwardingRules/forwarding-rule'}    2023-11-01T21:38:08

Registra workload

  1. Elenca i carichi di lavoro disponibili che puoi registrare in un'applicazione:

    gcloud apphub discovered-workloads list \
  --project=PROJECT_ID \
  --location=REGION \
  --filter=FILTER_EXPRESSION

    Per i flag obbligatori e facoltativi, sostituisci quanto segue:

    • Obbligatorio: PROJECT_ID: l'ID del progetto host o del progetto di gestione, a seconda del modello di configurazione.

    • Obbligatorio: REGION: la regione specifica del tuo workload in base alla tua distribuzione geografica. Utilizza uno dei seguenti valori:

    • (Facoltativo) FILTER_EXPRESSION: l'espressione di filtro per il flag --filter per visualizzare solo i carichi di lavoro di un progetto specificato o con una proprietà specifica, ad esempio workload_properties.gcp_project=projects/PROJECT_ID.

    L'output è simile al seguente:

    ID             WORKLOAD_REFERENCE                                                                                    WORKLOAD_PROPERTIES
WORKLOAD_ID    {'uri': '//compute.googleapis.com/projects/PROJECT_NUMBER/regions/REGION/instanceGroups/mig-name'}    {'gcpProject': 'projects/PROJECT_ID', 'location': 'REGION'}

  2. Copia l'ID workload, WORKLOAD_ID, dall'output.

  3. Registra il workload nella tua applicazione:

    gcloud apphub applications workloads create WORKLOAD_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --application=APPLICATION_NAME \
  --discovered-workload=projects/PROJECT_ID/locations/REGION/discoveredWorkloads/WORKLOAD_ID \
  --display-name=WORKLOAD_DISPLAY_NAME \
  --criticality-type=CRITICALITY \
  --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 che vuoi utilizzare per registrare il workload nell'applicazione.

    Utilizza flag facoltativi come --criticality-type per definire gli attributi di primo livello del workload e supportare la rilevabilità e la governance.

    Per i flag obbligatori e facoltativi, sostituisci quanto segue:

    • Obbligatorio: PROJECT_ID: l'ID del progetto host o del progetto di gestione, a seconda del modello di configurazione.

    • Obbligatorio: REGION: la regione specifica del tuo workload in base alla tua distribuzione geografica. Utilizza uno dei seguenti valori:

    • Obbligatorio: APPLICATION_NAME: il nome dell'applicazione per cui vuoi registrare il workload.

    • Obbligatorio: WORKLOAD_ID: l'ID workload che hai copiato dall'output precedente.

    • (Facoltativo) WORKLOAD_DISPLAY_NAME: il nome visualizzato del tuo workload.

    • (Facoltativo) CRITICALITY: il livello di importanza del carico di lavoro per le tue operazioni. 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.

  4. Elenca i workload registrati nella tua applicazione:

    gcloud apphub applications workloads list \
  --application=APPLICATION_NAME
  --project=PROJECT_ID \
  --location=REGION

    Per ogni carico di lavoro registrato, devi ottenere un output simile al seguente:

    ID               DISPLAY_NAME             WORKLOAD_REFERENCE                                                                                    CREATE_TIME
WORKLOAD_NAME    WORKLOAD_DISPLAY_NAME    {'uri': '//compute.googleapis.com/projects/PROJECT_NUMBER/regions/REGION/instanceGroups/mig-name'}    2023-11-01T21:38:08

Concedere le autorizzazioni e iniziare le operazioni

Dopo aver creato un'applicazione e registrato le risorse in App Hub, concedi l'accesso degli utenti in base alle responsabilità e gestisci questo raggruppamento logico come una singola unità:

  1. A seconda delle tue esigenze di accesso, puoi concedere autorizzazioni alla tua applicazione. Per un elenco dei ruoli consigliati, vedi Concedere ruoli incentrati sulle applicazioni agli utenti.
  2. Vai a Cloud Hub per visualizzare una dashboard operativa unificata per l'applicazione definita, inclusi i dati relativi a integrità, prestazioni e costi.