Creare controlli di uptime privati

Console Google Cloud

Per creare un controllo di uptime utilizzando la console Google Cloud:

1. Nella console Google Cloud, vai alla pagina  Controlli di uptime:

   Vai a Controlli di uptime

   Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

2. Fai clic su Crea controllo di uptime.

   

3. Specifica un controllo di uptime privato:

   1. Seleziona il protocollo, che può essere HTTP, HTTPS o TCP.

   2. Scegli il tipo di risorsa IP interno.

4. Se non hai configurato un servizio Service Directory per il tuo progetto o se vuoi crearne uno, fai clic su Visualizza e completa il riquadro Prerequisiti per i controlli di uptime privati:

   1. Se richiesto, abilita l'API Compute Engine o l'API Directory Service. L'attivazione delle API potrebbe richiedere un minuto.

   2. Espandi arrow_drop_down Account di servizio, se visualizzato, quindi fai clic su Crea account di servizio.

      Se non esiste un account di servizio di monitoraggio, viene creato uno. Poi, il monitoraggio concede all'account di servizio due ruoli di Service Directory.

   3. Espandi il menu arrow_drop_down Directory dei servizi e poi segui questi passaggi:

      1. Espandi arrow_drop_down Regione e poi seleziona la regione della VM che gestisce le richieste.
      2. Espandi arrow_drop_down Spazio dei nomi, quindi seleziona uno spazio dei nomi Service Directory esistente o fai clic su Crea spazio dei nomi e crea uno spazio dei nomi.
      3. Fai clic su Nome servizio e inserisci un nome. I servizi sono i target dei controlli di uptime privati.
      4. Fai clic su Nome endpoint e inserisci un nome per l'endpoint. Un endpoint è una coppia di valori di indirizzo IP e porta che un servizio può utilizzare per gestire le richieste. Quando il servizio contiene più endpoint, ne viene scelto uno a caso.
      5. Espandi arrow_drop_down Rete e poi seleziona la tua rete privata.
      6. Espandi arrow_drop_down Istanze e seleziona la VM sulla rete privata che sta servendo le richieste. Dopo aver selezionato l'istanza, viene visualizzato il relativo indirizzo IP interno.
      7. Fai clic su Fine.

   4. Espandi arrow_drop_down Regole firewall:

      1. Espandi arrow_drop_down Rete e seleziona la rete a cui è collegata la regola di rete.

      2. Fai clic su Crea regole firewall.

         La regola firewall consente il traffico TCP in entrata dalle route 35.199.192.0/19. Una route da 35.199.192.0/19 supporta la connettività ai target di inoltro che utilizzano il routing privato. Per ulteriori informazioni, consulta Route VPC.

5. Nel riquadro Controllo di uptime privato, per specificare il servizio Service Directory da utilizzare, svolgi una delle seguenti operazioni:

   • Seleziona Utilizza il nome completo del servizio e inserisci il nome completo del servizio:

     projects/SERVICE_DIRECTORY_PROJECT_ID/locations/REGION/namespaces/PRIVATE_NAMESPACE/services/PRIVATE_SERVICE
     

   • Seleziona Regione, Spazio dei nomi e Servizio utilizzando i menu. Se hai creato un servizio, questi campi vengono selezionati per te.

6. Nel riquadro Controllo di uptime privato, completa la descrizione del target del controllo di uptime:

   1. (Facoltativo) Inserisci un componente del percorso per la richiesta.

      I controlli di uptime privati che utilizzano il protocollo HTTP o HTTPS inviano una richiesta a http://target/path. In questa expressione, target è l'indirizzo IP interno configurato nell'endpoint di Service Directory.

      Se lasci vuoto il campo Percorso o se imposti il valore su /, la richiesta viene inviata a http://target/.

   2. (Facoltativo) Per impostare la frequenza di esecuzione del controllo dell'uptime, utilizza il campo Frequenza controllo.

   3. (Facoltativo) Per selezionare le regioni dei controlli o per configurare l'autenticazione, le intestazioni per i controlli HTTP e HTTPS e altri valori, fai clic su Altre opzioni di destinazione:

      • Regioni: seleziona le regioni in cui devono essere ricevute le richieste per i controlli di uptime. Un controllo di uptime deve avere almeno tre controlli. È presente un ispettore in tutte le regioni, tranne negli Stati Uniti, che ne ha tre. L'impostazione predefinita, Globale, include tutte le regioni.
      • Metodo richiesta: seleziona GET o POST.
      • Testo: per i controlli HTTP POST, inserisci il corpo con codifica URL. Devi eseguire la codifica autonomamente. Per tutti gli altri controlli, lascia vuoto questo campo.
      • Intestazione host: non impostare questo campo quando configuri i controlli di uptime privati.
      • Porta: qualsiasi valore impostato qui sostituisce la porta nella configurazione dell'endpoint di Service Directory. Non impostare un valore qui se vuoi che venga utilizzata la configurazione dell'endpoint.
      • Intestazioni personalizzate: fornisci intestazioni personalizzate e, facoltativamente, criptale. La crittografia nasconde i valori nell'intestazione del modulo. Utilizza la crittografia per le intestazioni relative all'autenticazione che non vuoi rendere visibili ad altri.
      • Autenticazione: fornisci un singolo nome utente e una singola password. Questi valori vengono inviati come intestazione di autorizzazione. Se imposti i valori qui, non impostare un'intestazione di autorizzazione separata; se imposti un'intestazione di autorizzazione, non impostare i valori qui. Le password sono sempre nascoste nel modulo.

7. Fai clic su Continua e configura i requisiti di risposta. Tutte le impostazioni in questa sezione hanno valori predefiniti:

   • Per impostare un periodo di timeout per il controllo dell'uptime, utilizza il campo Timeout risposta. Un controllo di uptime non va a buon fine quando non viene ricevuta alcuna risposta da più di una località entro questo periodo.

   • Per configurare il controllo di uptime in modo che esegua la corrispondenza dei contenuti, assicurati che l'etichetta del pulsante di attivazione/disattivazione sia La corrispondenza dei contenuti è abilitata:

     • Seleziona il Tipo di corrispondenza dei contenuti della risposta dal menu delle opzioni. Questo campo determina il modo in cui i contenuti della risposta vengono confrontati con i dati restituiti. Ad esempio, supponiamo che i contenuti della risposta siano abcd e che il tipo di corrispondenza dei contenuti sia Contiene. Il controllo di uptime è positivo solo se i dati di risposta contengono abcd. Per ulteriori informazioni, consulta la sezione Convalidare i dati di risposta.
     • Inserisci i contenuti della risposta. Il contenuto della risposta deve essere una stringa non più lunga di 1024 byte. Nell'API, questo campo è l'oggetto ContentMatcher.

   • Per impedire la creazione di voci di log a causa dei controlli di uptime, elimina Logging degli errori dei controlli.

   • Per i controlli di uptime HTTP, configura i codici di risposta accettabili. Per impostazione predefinita, i controlli di uptime HTTP contrassegnano qualsiasi risposta2xx come risposta positiva.

8. Fai clic su Continua e configura le notifiche e i criteri di avviso.

   Per ricevere una notifica quando un controllo di uptime non va a buon fine, crea un criterio di avviso e configura i canali di notifica per quel criterio:

   1. (Facoltativo) Aggiorna il nome del criterio di avviso.
   2. (Facoltativo) Nel campo Durata, seleziona per quanto tempo i controlli di uptime devono avere esito negativo prima che vengano inviate le notifiche. Per impostazione predefinita, le notifiche vengono inviate quando almeno due regioni segnalano errori di controllo dell'uptime per una durata di almeno un minuto.

   3. Nella casella Canali di notifica, espandi arrow_drop_down Menu, seleziona i canali da aggiungere e poi fai clic su Ok.

      Nel menu, i canali di notifica sono raggruppati in ordine alfabetico per ciascun tipo di canale.

   Se non vuoi creare un criterio di avviso, assicurati che il testo del pulsante di attivazione/disattivazione sia Non creare un avviso.

9. Fai clic su Continua e completa il controllo dell'uptime:

   1. Inserisci un titolo descrittivo per il controllo di uptime.

   2. (Facoltativo) Per aggiungere etichette definite dall'utente al controllo dell'uptime:

      1. Fai clic su expand_more Mostra etichette utente.
      2. Nel campo Chiave, inserisci un nome per l'etichetta. I nomi delle etichette devono iniziare con una lettera minuscola e possono contenere lettere minuscole, numeri, trattini bassi e trattini. Ad esempio, inserisci severity.
      3. Nel campo Valore, inserisci un valore per l'etichetta. I valori dell'etichetta possono contenere lettere minuscole, numeri, trattini bassi e trattini. Ad esempio, inserisci critical.
      4. Per ogni etichetta aggiuntiva, fai clic su Aggiungi etichetta utente e poi inserisci la chiave e il valore dell'etichetta.

   3. Per verificare la configurazione del controllo di uptime, fai clic su Test. Se il risultato non è quello previsto, consulta la sezione Risoluzione dei problemi, correggi la configurazione e ripeti il passaggio di verifica.

   4. Fai clic su Crea.

API: progetto di definizione dell'ambito

Per creare la configurazione per un controllo di uptime privato, crea un oggetto UptimeCheckConfig e passalo al metodo uptimeCheckConfigs.create nell'API Cloud Monitoring.

L'oggetto UptimeCheckConfig per un controllo di uptime privato è diverso dall'oggetto per un controllo di uptime pubblico nei seguenti modi:

• La risorsa monitorata specificata nella configurazione del controllo dell'uptime deve essere di tipo servicedirectory_service. Questo tipo di risorsa ha le seguenti etichette:

  • project_id: l'ID progetto associato al servizio Service Directory.
  • location: la regione cloud associata al servizio.
  • namespace_name: lo spazio dei nomi Service Directory.
  • service_name: il nome del servizio Service Directory.

• Non è necessario specificare un valore port nella configurazione del controllo dell'uptime. Il valore della porta dell'endpoint di Service Directory sostituisce qualsiasi valore impostato nella configurazione del controllo dell'uptime e il controllo non va a buon fine se non viene specificata alcuna porta nella configurazione di Service Directory.

• La configurazione del controllo di uptime deve specificare il campo checker_type con il valore VPC_CHECKERS. Questo valore è obbligatorio per i controlli di uptime privato. Per impostazione predefinita, i controlli di uptime sono pubblici, pertanto non è necessario specificare questo campo.

Il seguente codice JSON illustra un oggetto UptimeCheckConfig per un controllo di uptime privato che utilizza le risorse di Service Directory configurate per un'istanza VM su una rete privata:

{
  "displayName": "private-check-demo",
  "monitoredResource": {
    "type": "servicedirectory_service",
    "labels": {
      "project_id": "SERVICE_DIRECTORY_PROJECT_ID",
      "service_name": "PRIVATE_SERVICE",
      "namespace_name": "PRIVATE_NAMESPACE",
      "location": "REGION"
    }
  },
  "httpCheck": {
    "requestMethod": "GET"
  },
  "period": "60s",
  "timeout": "10s",
  "checker_type": "VPC_CHECKERS"
}'

Per creare un controllo di uptime privato quando il servizio Service Directory si trova nello stesso progetto Google Cloud del controllo di uptime, segui questi passaggi:

1. Imposta il progetto Google Cloud predefinito per l'interfaccia a riga di comando gcloud:

   gcloud config set project PROJECT_ID
   

2. Crea una variabile di ambiente per archiviare il tuo ID progetto:

   export PROJECT_ID=$(gcloud config get-value core/project)
   

3. Crea una variabile di ambiente contenente un token di accesso:

   export TOKEN=`gcloud auth print-access-token`
   

4. Utilizza lo strumento curl per invocare il metodo uptimeCheckConfigs.create e pubblicare un oggetto di configurazione:

   curl https://monitoring.googleapis.com/v3/projects/${PROJECT_ID}/uptimeCheckConfigs \
   -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
   --request POST --data '{
   "displayName": "private-check-demo",
   "monitoredResource": {
     "type": "servicedirectory_service",
     "labels": {
       "project_id": "'"$PROJECT_ID"'",
       "service_name": "PRIVATE_SERVICE",
       "namespace_name": "PRIVATE_NAMESPACE",
       "location": "REGION"
     }
   },
   "httpCheck": {
     "requestMethod": "GET"
   },
   "period": "60s",
   "timeout": "10s",
   "checker_type": "VPC_CHECKERS"
   }'
   

Se la creazione del controllo di uptime non riesce, verifica che l'account di servizio disponga dei ruoli necessari. Per ulteriori informazioni, consulta Creazione del controllo di uptime non riuscita.

API: progetto monitorato

Per creare la configurazione per un controllo di uptime privato, devi creare un oggetto UptimeCheckConfig e passarlo al metodo uptimeCheckConfigs.create nell'API Cloud Monitoring.

L'oggetto UptimeCheckConfig per un controllo di uptime privato è diverso dall'oggetto per un controllo di uptime pubblico nei seguenti modi:

• La risorsa monitorata specificata nella configurazione del controllo dell'uptime deve essere di tipo servicedirectory_service. Questo tipo di risorsa ha le seguenti etichette:

  • project_id: l'ID progetto associato al servizio Service Directory.
  • location: la regione cloud associata al servizio.
  • namespace_name: lo spazio dei nomi Service Directory.
  • service_name: il nome del servizio Service Directory.

• Non è necessario specificare un valore port nella configurazione del controllo dell'uptime. Il valore della porta dell'endpoint di Service Directory sostituisce qualsiasi valore impostato nella configurazione del controllo dell'uptime e il controllo non va a buon fine se non viene specificata alcuna porta nella configurazione di Service Directory.

• La configurazione del controllo di uptime deve specificare il campo checker_type con il valore VPC_CHECKERS. Questo valore è obbligatorio per i controlli di uptime privato. Per impostazione predefinita, i controlli di uptime sono pubblici, pertanto non è necessario specificare questo campo.

Il seguente codice JSON illustra un oggetto UptimeCheckConfig per un controllo di uptime privato che utilizza le risorse di Service Directory configurate per un'istanza VM su una rete privata:

{
  "displayName": "private-check-demo",
  "monitoredResource": {
    "type": "servicedirectory_service",
    "labels": {
      "project_id": "SERVICE_DIRECTORY_PROJECT_ID",
      "service_name": "PRIVATE_SERVICE",
      "namespace_name": "PRIVATE_NAMESPACE",
      "location": "REGION"
    }
  },
  "httpCheck": {
    "requestMethod": "GET"
  },
  "period": "60s",
  "timeout": "10s",
  "checker_type": "VPC_CHECKERS"
}'

Per creare un controllo di uptime privato quando il servizio Service Directory si trova in un progetto Google Cloud monitorato dall'ambito delle metriche del progetto Google Cloud del controllo di uptime, svolgi i seguenti passaggi:

1. Configura l'interfaccia alla gcloud CLI in modo che utilizzi per impostazione predefinita il progetto Google Cloud in cui deve essere creato il controllo dell'uptime:

   gcloud config set project PROJECT_ID
   

2. Crea una variabile di ambiente per archiviare il tuo ID progetto:

   export PROJECT_ID=$(gcloud config get-value core/project)
   

3. Crea una variabile di ambiente per archiviare l'ID progetto del progetto Google Cloud in cui è definito il servizio Service Directory:

   export MONITORED_PROJECT_ID=MONITORED_PROJECT_ID
   

   Questo progetto deve rientrare nell'ambito delle metriche del progetto del controllo dell'uptime.

4. Crea una variabile di ambiente contenente un token di accesso:

   export TOKEN=`gcloud auth print-access-token`
   

5. Utilizza lo strumento curl per invocare il metodo uptimeCheckConfigs.create e pubblicare un oggetto di configurazione:

   curl https://monitoring.googleapis.com/v3/projects/${PROJECT_ID}/uptimeCheckConfigs \
   -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
   --request POST --data '{
   "displayName": "private-check-demo",
   "monitoredResource": {
     "type": "servicedirectory_service",
     "labels": {
       "project_id": "'"$MONITORED_PROJECT_ID"'",
       "service_name": "PRIVATE_SERVICE",
       "namespace_name": "PRIVATE_NAMESPACE",
       "location": "REGION"
     }
   },
   "httpCheck": {
     "requestMethod": "GET"
   },
   "period": "60s",
   "timeout": "10s",
   "checker_type": "VPC_CHECKERS"
   }'
   

Se la creazione del controllo di uptime non riesce, verifica che l'account di servizio disponga dei ruoli necessari. Per ulteriori informazioni, consulta Creazione del controllo di uptime non riuscita.

Console Google Cloud

Quando utilizzi la console Google Cloud, dopo aver selezionato IP interno come tipo di risorsa per un controllo dell'uptime, ti viene chiesto di creare un Service Directory e un servizio.

Gcloud CLI - VM

Per informazioni sui comandi utilizzati in questo documento per servizi, namespaces ed endpoint, consulta il gruppo di comandi gcloud service-directory.

Per creare risorse di Service Directory per una VM, procedi nel seguente modo:

1. Configura Google Cloud CLI in modo che utilizzi per impostazione predefinita il progetto Google Cloud in cui devono essere create le risorse di Service Directory:

   gcloud config set project PROJECT_ID
   

2. Crea variabili di ambiente per archiviare l'ID e il numero del progetto:

   export PROJECT_ID=$(gcloud config get-value core/project)
   
   export PROJECT_NUMBER=$(gcloud projects describe $PROJECT_ID --format='get(projectNumber)')
   

3. Crea uno spazio dei nomi Service Directory:

   gcloud service-directory namespaces create PRIVATE_NAMESPACE --location=REGION
   

4. Crea un servizio Service Directory nello spazio dei nomi:

   gcloud service-directory services create PRIVATE_SERVICE \
   --namespace PRIVATE_NAMESPACE --location=REGION
   

5. Crea una variabile di ambiente per contenere l'indirizzo IP della VM sulla rete privata:

   export INTERNAL_IP=$(gcloud compute instances describe --zone=ZONE \
   PRIVATE_SERVICE_INSTANCE --format='get(networkInterfaces[0].networkIP)')
   

6. Crea un endpoint di Service Directory contenente l'indirizzo IP interno e una porta:

   gcloud service-directory endpoints create PRIVATE_ENDPOINT \
   --location=REGION --namespace=PRIVATE_NAMESPACE \
   --service=PRIVATE_SERVICE \
   --network=projects/$PROJECT_NUMBER/locations/global/networks/PRIVATE_CHECK_NETWORK \
   --address=$INTERNAL_IP --port=80
   

Interfaccia alla gcloud CLI - L4 ILB

Per informazioni sui comandi utilizzati in questo documento per servizi, namespaces ed endpoint, consulta il gruppo di comandi gcloud service-directory.

Puoi utilizzare i controlli di uptime privati per monitorare la disponibilità di un bilanciatore del carico interno L4 (ILB) creando risorse Service Directory per l'ILB L4.

Quando crei nuovi bilanciatori del carico interni L4, puoi utilizzare l'integrazione automatica fornita da Service Directory. Per saperne di più, consulta Configurare i bilanciatori del carico interni in Service Directory.

Se hai ILB L4 creati senza utilizzare l'integrazione automatica fornita da Service Directory, puoi configurare manualmente le risorse di Service Directory nel seguente modo:

1. Configura Google Cloud CLI in modo che utilizzi per impostazione predefinita il progetto Google Cloud in cui devono essere create le risorse di Service Directory:

   gcloud config set project PROJECT_ID
   

2. Crea variabili di ambiente per archiviare l'ID e il numero del progetto:

   export PROJECT_ID=$(gcloud config get-value core/project)
   
   export PROJECT_NUMBER=$(gcloud projects describe $PROJECT_ID --format='get(projectNumber)')
   

3. Per consentire a tutti i controlli di uptime di trasferire dati al tuo bilanciatore di carico L4, attiva l'accesso globale al bilanciatore di carico:

   gcloud compute forwarding-rules update ILB_FORWARDING_RULE_NAME \
   --region=ILB_REGION --allow-global-access
   

   Se il bilanciatore del carico interno L4 non consente l'accesso globale, le metriche relative al tempo di attività sono disponibili solo se ILB_REGION è uno dei seguenti valori:

   • us-east4
   • us-central1
   • us-west1
   • europe-west1
   • southamerica-east1
   • asia-southeast1

4. Crea uno spazio dei nomi Service Directory:

   gcloud service-directory namespaces create PRIVATE_NAMESPACE_FOR_ILB\
   --location=REGION
   

5. Crea un servizio Service Directory nello spazio dei nomi:

   gcloud service-directory services create PRIVATE_SERVICE_FOR_ILB \
   --namespace PRIVATE_NAMESPACE_FOR_ILB --location=REGION
   

6. Crea una variabile di ambiente per contenere l'indirizzo IP del bilanciatore del carico sulla rete privata:

   export INTERNAL_IP=$( gcloud compute forwarding-rules describe ILB_FORWARDING_RULE_NAME\
   --region=ILB_REGION --format='get(IPAddress)')
   

7. Crea un endpoint di Service Directory contenente l'indirizzo IP interno e una porta:

   gcloud service-directory endpoints create PRIVATE_ENDPOINT_FOR_ILB \
   --location=ILB_REGION --namespace=PRIVATE_NAMESPACE_FOR_ILB \
   --service=PRIVATE_SERVICE_FOR_ILB \
   --network=projects/$PROJECT_NUMBER/locations/global/networks/PRIVATE_CHECK_NETWORK \
   --address=$INTERNAL_IP --port=80
   

Console Google Cloud

Quando utilizzi la console Google Cloud, dopo aver selezionato IP interno come tipo di risorsa per un controllo dell'uptime, ti viene chiesto di autorizzare l'account di servizio.

API: progetto di definizione dell'ambito

Per concedere i ruoli di Directory dei servizi a un account di servizio esistente:

1. Configura l'interfaccia alla gcloud CLI in modo che utilizzi per impostazione predefinita il progetto Google Cloud in cui deve essere creato il controllo dell'uptime:

   gcloud config set project PROJECT_ID
   

2. Crea variabili di ambiente per archiviare l'ID e il numero del progetto:

   export PROJECT_ID=$(gcloud config get-value core/project)
   
   export PROJECT_NUMBER=$(gcloud projects describe $PROJECT_ID --format='get(projectNumber)')
   

3. Esegui questi comandi:

   gcloud projects add-iam-policy-binding $PROJECT_ID \
   --member='serviceAccount:service-'$PROJECT_NUMBER'@gcp-sa-monitoring-notification.iam.gserviceaccount.com' \
   --role='roles/servicedirectory.viewer'
   

   gcloud projects add-iam-policy-binding $PROJECT_ID \
   --member='serviceAccount:service-'$PROJECT_NUMBER'@gcp-sa-monitoring-notification.iam.gserviceaccount.com' \
   --role='roles/servicedirectory.pscAuthorizedService'
   

   I comandi precedenti concedono i seguenti ruoli all'account di servizio:

   • roles/servicedirectory.viewer
   • roles/servicedirectory.pscAuthorizedService

API: progetto monitorato

Per concedere i ruoli di Directory dei servizi a un account di servizio esistente:

1. Configura l'interfaccia alla gcloud CLI in modo che utilizzi per impostazione predefinita il progetto Google Cloud in cui deve essere creato il controllo dell'uptime:

   gcloud config set project PROJECT_ID
   

2. Crea variabili di ambiente per archiviare l'ID e il numero del progetto:

   export PROJECT_ID=$(gcloud config get-value core/project)
   
   export PROJECT_NUMBER=$(gcloud projects describe $PROJECT_ID --format='get(projectNumber)')
   

3. Crea una variabile di ambiente contenente l'ID progetto in cui è definito il servizio Service Directory:

   export MONITORED_PROJECT_ID=MONITORED_PROJECT_ID
   

   Questo progetto deve rientrare nell'ambito delle metriche del progetto del controllo dell'uptime.

4. Crea una variabile di ambiente contenente l'ID progetto in cui è definita la rete:

   export NETWORK_PROJECT_ID=NETWORK_PROJECT_ID
   

   Questo progetto non deve necessariamente rientrare nell'ambito delle metriche del progetto del controllo dell'uptime.

5. Esegui questi comandi:

   gcloud projects add-iam-policy-binding $MONITORED_PROJECT_ID \
   --member='serviceAccount:service-'$PROJECT_NUMBER'@gcp-sa-monitoring-notification.iam.gserviceaccount.com' \
   --role='roles/servicedirectory.viewer'
   

   gcloud projects add-iam-policy-binding $NETWORK_PROJECT_ID \
   --member='serviceAccount:service-'$PROJECT_NUMBER'@gcp-sa-monitoring-notification.iam.gserviceaccount.com' \
   --role='roles/servicedirectory.pscAuthorizedService'
   

   I comandi precedenti concedono i seguenti ruoli all'account di servizio:

   • roles/servicedirectory.viewer per il progetto monitorato in cui è configurato il servizio Service Directory$SERVICE_MONITORED_PROJECT_ID.
   • roles/servicedirectory.pscAuthorizedService per il progetto in cui è configurata la rete privata, $NETWORK_PROJECT_ID.

Console Google Cloud

Quando utilizzi la console Google Cloud, dopo aver selezionato IP interno come tipo di risorsa per un controllo dell'uptime, ti viene chiesto di configurare le regole del firewall.

Interfaccia a riga di comando gcloud

Per creare una regola firewall che consenta il traffico TCP in entrata tramite il firewall per l'accesso alla rete privata, esegui il seguente comando:

1. Configura l'interfaccia alla gcloud CLI in modo che utilizzi per impostazione predefinita il progetto Google Cloud in cui deve essere creato il controllo dell'uptime:

   gcloud config set project PROJECT_ID
   

2. Crea variabili di ambiente per archiviare l'ID e il numero del progetto:

   export PROJECT_ID=$(gcloud config get-value core/project)
   

3. Crea la regola di rete:

   gcloud compute firewall-rules create PRIVATE_CHECK_NETWORK_HOPE_RULE \
   --network="PRIVATE_CHECK_NETWORK"  \
   --action=allow   --direction=ingress   --source-ranges="35.199.192.0/19" \
   --rules=tcp   --project="$PROJECT_ID"
   

   Nel comando precedente, PRIVATE_CHECK_NETWORK è la rete a cui è collegata questa regola, mentre PRIVATE_CHECK_NETWORK_HOPE_RULE è il nome della regola firewall.

Per ulteriori informazioni su questo passaggio, consulta Configurare il progetto di rete.

Console Google Cloud

Quando utilizzi la console Google Cloud per creare il controllo di uptime privato, la console emette i comandi per concedere all'account di servizio i ruoli di Service Directory.

Per informazioni su come concedere i ruoli a un account di servizio, consulta Autorizzare l'account di servizio.

API: progetto di definizione dell'ambito

La prima volta che crei un controllo dell'uptime privato per un servizio Service Directory e risorse private in un singolo progetto Google Cloud, la richiesta potrebbe riuscire o meno. Il risultato dipende dal fatto che tu abbia disattivato la concessione automatica dei ruoli per gli account di servizio nel tuo progetto:

• La prima creazione del controllo dell'uptime va a buon fine se il progetto consente la concessione automatica dei ruoli per gli account di servizio. Viene creato un account di servizio per te a cui vengono concessi i ruoli necessari.

• La prima creazione del controllo dell'uptime non va a buon fine se il progetto non consente la concessione automatica dei ruoli per gli account di servizio. Viene creato un account di servizio, ma non vengono concessi ruoli.

Se la creazione del controllo di uptime non va a buon fine, svolgi i seguenti passaggi:

1. Autorizza l'account di servizio.
2. Attendi qualche minuto per la propagazione delle autorizzazioni.
3. Prova a creare di nuovo il controllo di uptime privato.

API: progetto monitorato

La prima volta che crei un controllo dell'uptime privato che ha come target un servizio Service Directory in un progetto monitorato o risorse private in un altro progetto Google Cloud, la richiesta non va a buon fine e viene creato un account di servizio di monitoraggio.

La modalità di autorizzazione dell'account di servizio dipende dal numero di progetti Google Cloud in uso e dalle relative relazioni. Potrebbero essere coinvolti fino a quattro progetti:

• Il progetto in cui hai definito il controllo di uptime privato.
• Il progetto monitorato in cui hai configurato il servizio Service Directory.
• Il progetto in cui hai configurato la rete VPC.
• Il progetto in cui sono configurate le risorse di rete come VM o bilanciatori del carico. Questo progetto non ha alcun ruolo nell'autorizzazione dell'account di servizio discussa qui.

Quando la creazione del primo controllo di uptime non va a buon fine:

1. Autorizza l'account di servizio.
2. Attendi qualche minuto per la propagazione delle autorizzazioni.
3. Prova a creare di nuovo il controllo di uptime privato.