Puoi configurare i controlli di avvio HTTP, TCP e gRPC, nonché i controlli di attività HTTP e gRPC per i servizi Cloud Run nuovi ed esistenti. La configurazione varia a seconda del tipo di sonda.
Tieni presente che un probe di avvio TCP viene configurato automaticamente per un nuovo servizio Cloud Run. Vedi Il probe di avvio TCP predefinito per maggiori dettagli.
Casi d'uso
Puoi configurare due tipi di probe del controllo di integrità:
I probe di attività determinano se riavviare un container.
- Il riavvio di un container in questo caso può aumentare la disponibilità del servizio in la presenza di insetti.
- I probe di attività hanno lo scopo di riavviare singole istanze che non possono essere recuperate in nessun altro modo. Devono essere utilizzati principalmente per i fallimenti delle istanze non recuperabili, ad esempio per rilevare un deadlock in cui un servizio è in esecuzione, ma non riesce a progredire. Puoi richiedere un probe di attività per ogni contenitore utilizzando i criteri dell'organizzazione personalizzati.
I probe di avvio determinano se il container è stato avviato ed è pronto ad accettare il traffico.
- Quando configuri un probe di avvio, i controlli di attività vengono disattivati finché il probe di avvio non determina che il contenitore è avviato, per evitare interferenze con l'avvio del servizio.
- I probe di avvio sono particolarmente utili se usi i controlli di attività su operazioni avviano i container, perché ne impedisce l'arresto prematuramente prima che i container siano attivi e in esecuzione.
Tieni presente che, quando si verificano ripetuti errori del probe di attività o di avvio, Cloud Run limita i riavvii delle istanze per evitare loop di arresti anomali incontrollati.
Il probe di avvio TCP predefinito
Un probe di avvio TCP viene configurato automaticamente per un nuovo Cloud Run con valori predefiniti. Il probe predefinito è equivalente al seguente:
startupProbe: tcpSocket: port: CONTAINER_PORT timeoutSeconds: 240 periodSeconds: 240 failureThreshold: 1
Sostituisci CONTAINER_PORT con la porta del container per il tuo servizio.
Puoi modificare questi valori predefiniti seguendo le istruzioni in configurazione del probe in questa pagina.
Fatturazione e allocazione della CPU
- La CPU è allocata per ogni probe.
- A tutti i probe viene fatturato il consumo di CPU e memoria, ma non è previsto alcun addebito basato sulle richieste.
Requisiti e comportamento dei probe
Tipo di sonda | Requisiti | Comportamento |
---|---|---|
Avvio TCP | Nessuno | Per impostazione predefinita, Cloud Run stabilisce una connessione TCP per aprire la porta TCP specificata. Se Cloud Run non è in grado di stabilire una connessione, indica un errore. Se un probe di avvio non ha esito positivo entro il periodo di tempo specificato ( failureThreshold * periodSeconds ), che non può superare i 240 secondi, il container viene arrestato. Consulta anche i valori predefiniti TCP. |
Avvio HTTP | Crea un endpoint di controllo di integrità HTTP Utilizza HTTP/1 |
Dopo la configurazione del probe, Cloud Run effettua una richiesta HTTP GET all'endpoint del controllo di integrità del servizio (ad esempio, /ready ). Le risposte tra 200 e 400 sono riuscite, tutto il resto indica un errore.Se un probe di avvio non riesce entro il tempo specificato ( failureThreshold * periodSeconds ), che non può superare i 240 secondi, il container viene arrestato.Se il probe di avvio HTTP ha esito positivo entro il periodo di tempo specificato e hai configurato un probe di attività HTTP, viene avviato il probe di attività HTTP. |
Attualità HTTP | Crea un endpoint del controllo di integrità HTTP Utilizza HTTP/1 |
Il probe di attività viene avviato solo dopo che il probe di avvio è riuscito. Dopo la configurazione del probe e il buon esito di qualsiasi probe di avvio, Cloud Run invia una richiesta GET HTTP all'endpoint di controllo di integrità del servizio (ad esempio /health ). Qualsiasi risposta compresa tra 200 e 400 indica un esito positivo, mentre tutte le altre indicano un errore.Se un probe di verifica della presenza non va a buon fine entro il tempo specificato ( failureThreshold * periodSeconds ), il contenitore viene arrestato utilizzando un segnale SIGKILL . Eventuali richieste rimanenti ancora in esecuzione dal contenitore vengono interrotte con il codice di stato HTTP 503 . Dopo l'arresto del contenitore, l'autoscaling di Cloud Run avvia una nuova istanza container. |
Avvio di gRPC | Implementa il protocollo gRPC Controllo di integrità nel servizio Cloud Run | Se un probe di avvio non va a buon fine entro il tempo specificato (failureThreshold * periodSeconds ), che non può superare i 240 secondi, il contenitore viene arrestato. |
Attività gRPC | Implementa il protocollo di controllo dell'integrità gRPC nel tuo servizio Cloud Run | Se configuri un probe di avvio gRPC, il probe di attività viene avviato solo al termine del probe di attività. Una volta configurato il probe di attività e dopo l'esito positivo dell'eventuale probe di attività, Cloud Run invia una richiesta di controllo di integrità al servizio. Se un probe di attività non riesce entro il tempo specificato ( failureThreshold * periodSeconds ), il container viene arrestato utilizzando un segnale SIGKILL . Dopo l'arresto del container, la scalabilità automatica di Cloud Run avvia una nuova istanza di container. |
Configura probe
Qualsiasi modifica alla configurazione porta la creazione di una nuova revisione. Anche le revisioni successive acquisiranno automaticamente questa impostazione di configurazione, a meno che non apporti aggiornamenti espliciti per modificarla.
Puoi configurare probe HTTP, TCP e gRPC utilizzando la console Google Cloud, YAML Terraform:
Console
Importante: se stai configurando il servizio Cloud Run per HTTP devi anche aggiungere un endpoint per il controllo di integrità HTTP nel servizio per rispondere al probe. Se stai configurando una sonda gRPC, devi anche implementare il protocollo di controllo dell'integrità gRPC nel tuo servizio Cloud Run.
Nella console Google Cloud, vai alla pagina Cloud Run.
Per un nuovo servizio, espandi Container, volumi, networking, sicurezza per visualizzare il controllo di integrità. le opzioni di CPU e memoria disponibili. Per un servizio esistente, fai clic sul servizio che vuoi configurare, quindi su Modifica ed esegui il deployment per visualizzare le opzioni di controllo dell'integrità.
Nella sezione Contenitori, vai a Controlli di integrità e fai clic su Aggiungi controllo di integrità per aprire il riquadro di configurazione Aggiungi controllo di integrità.
Nel menu Seleziona il tipo di controllo di integrità, seleziona il tipo di controllo di integrità da aggiungere, ad esempio avvio o attività.
Nel menu Seleziona il tipo di probe, seleziona il tipo di probe da utilizzare, ad esempio HTTP o gRPC. Viene visualizzato il form di configurazione della sonda.
Tieni presente che la configurazione della sonda varia in base al tipo di sonda. Configura le impostazioni del probe:
- Se utilizzi probe HTTP:
- Assicurati che il servizio utilizzi HTTP/1 (l'impostazione predefinita di Cloud Run), non HTTP/2.
- Utilizza il campo Percorso per specificare il percorso relativo dell'endpoint, ad esempio
/
. - Seleziona la casella di controllo Intestazioni HTTP per specificare intestazioni personalizzate facoltative. Poi specifica il nome dell'intestazione nel campo Nome e il valore dell'intestazione nel campo Valore. Fai clic su Aggiungi intestazione HTTP per specificare altre intestazioni.
- Per Porta, specifica la porta del container utilizzati per il tuo servizio.
- Per Ritardo iniziale, specifica il numero di secondi di attesa dopo che il container viene avviato prima di eseguire il primo probe. Specifica un valore da da 0 a 240 secondi. Il valore predefinito è 0 secondi.
- Per Periodo, specifica il periodo (in secondi) in cui eseguire il probe. Ad esempio,
2
deve eseguire il probe ogni 2 secondi. Specifica un valore compreso tra 1 e 240 secondi. Il valore predefinito è 10 secondi. - Per Soglia di errore, specifica il numero di volte per cui riprovare il probe prima e l'arresto del container. Il valore predefinito è 3.
- Per Timeout, specifica il numero di secondi di attesa prima del timeout della sonda. Questo valore non può superare il valore specificato per
periodSeconds
. Specifica un valore compreso tra 1 e 240. Il valore predefinito è 1.
- Se utilizzi probe HTTP:
Fai clic su Aggiungi per aggiungere la nuova soglia.
YAML
Importante: se stai configurando il servizio Cloud Run per i controlli HTTP, devi anche aggiungere un endpoint nel codice del servizio per rispondere al controllo. Se configuri un probe gRPC, devi di implementare anche Protocollo gRPC Health Control nel tuo servizio Cloud Run.
avvio TCP
-
Se stai creando un nuovo servizio, salta questo passaggio. Se stai aggiornando un servizio esistente, scarica
la sua configurazione YAML:
gcloud run services describe SERVICE --format export > service.yaml
Configura l'attributo
startupProbe
come mostrato:apiVersion: serving.knative.dev/v1 kind: Service metadata: name: SERVICE spec: template: metadata: spec: containers: - image: IMAGE_URL startupProbe: tcpSocket: port: CONTAINER_PORT initialDelaySeconds: DELAY timeoutSeconds: TIMEOUT failureThreshold: THRESHOLD periodSeconds: PERIOD
Sostituisci
- SERVICE con il nome del servizio Cloud Run.
- IMAGE_URL con un riferimento all'immagine container, per
ad esempio
us-docker.pkg.dev/cloudrun/container/hello:latest
. Se utilizzi Artifact Registry, il repository REPO_NAME deve essere già creati. L'URL ha la formaLOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
- (FACOLTATIVO) CONTAINER_PORT deve essere impostato sulla porta del container utilizzati per il tuo servizio.
- DELAY con numero di secondi di attesa dopo il container viene avviato prima di eseguire il primo probe. Specifica un valore compreso tra 0 e 240 secondi. Il valore predefinito è 0 secondi.
- (FACOLTATIVO) TIMEOUT con il numero di secondi da attendere prima del time out del probe. Questo valore non può superare il valore specificato per
periodSeconds
. Specifica un valore compreso tra 1 e 240. Il valore predefinito è 1. - THRESHOLD con il numero di volte per ripetere il probe prima di spegnere il container. Il valore predefinito è 3.
- PERIOD con il periodo (in secondi) in cui eseguire il probe.
Ad esempio,
2
deve eseguire il probe ogni 2 secondi. Specifica un valore compreso tra 1 e 240 secondi. Il valore predefinito è 10 secondi.
-
Crea o aggiorna il servizio utilizzando il seguente comando:
gcloud run services replace service.yaml
Avvio HTTP
-
Se stai creando un nuovo servizio, salta questo passaggio. Se stai aggiornando un servizio esistente, scarica la relativa configurazione YAML:
gcloud run services describe SERVICE --format export > service.yaml
Assicurati che il servizio utilizzi HTTP/1 (l'impostazione predefinita di Cloud Run), non HTTP/2.
Configura l'attributo
startupProbe
come mostrato:apiVersion: serving.knative.dev/v1 kind: Service metadata: name: SERVICE spec: template: metadata: spec: containers: - image: IMAGE_URL startupProbe: httpGet: path: PATH port: CONTAINER_PORT httpHeaders: - name: HEADER_NAME value: HEADER_VALUE initialDelaySeconds: DELAY timeoutSeconds: TIMEOUT failureThreshold: THRESHOLD periodSeconds: PERIOD
sostituisci
- SERVICE con il nome del servizio Cloud Run.
- IMAGE_URL con un riferimento all'immagine del container, ad esempio
us-docker.pkg.dev/cloudrun/container/hello:latest
. Se utilizzi Artifact Registry, il repository REPO_NAME deve essere già stato creato. L'URL ha la formaLOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
- PATH con il percorso relativo dell'endpoint HTTP, ad esempio
/ready
. - (FACOLTATIVO) CONTAINER_PORT deve essere impostato sulla porta del container utilizzati per il tuo servizio.
- (FACOLTATIVO)
httpHeaders
può essere utilizzato per fornire risposte multiple intestazioni personalizzate utilizzando HEADER_NAME e HEADER_VALUE come mostrato. - (FACOLTATIVO) DELAY con numero di secondi di attesa dopo il container viene avviato prima di eseguire il primo probe. Specifica un valore compreso tra 0 e 240 secondi. Il valore predefinito è 0 secondi.
- (FACOLTATIVO) TIMEOUT con il numero di secondi di attesa fino al probe
si verifica un timeout. Questo valore non può superare il valore specificato per
periodSeconds
. Specifica un valore compreso tra 1 e 240. Il valore predefinito è 1. - (FACOLTATIVO) THRESHOLD con il numero di tentativi del probe prima di chiudere il contenitore. Il valore predefinito è 3.
- (FACOLTATIVO) PERIOD con il periodo (in secondi) in cui eseguire il probe.
Ad esempio
2
per eseguire la sonda ogni 2 secondi. Specifica un valore compreso tra 1 e 240 secondi. Il valore predefinito è 10 secondi.
-
Crea o aggiorna il servizio utilizzando il seguente comando:
gcloud run services replace service.yaml
Attività HTTP
-
Se stai creando un nuovo servizio, salta questo passaggio. Se stai aggiornando un servizio esistente, scarica
la sua configurazione YAML:
gcloud run services describe SERVICE --format export > service.yaml
Assicurati che il servizio utilizzi HTTP/1 (l'impostazione predefinita di Cloud Run), non HTTP/2.
Configura l'attributo
livenessProbe
come mostrato:apiVersion: serving.knative.dev/v1 kind: Service metadata: name: SERVICE spec: template: metadata: spec: containers: - image: IMAGE_URL livenessProbe: httpGet: path: PATH port: CONTAINER_PORT httpHeaders: - name: HEADER_NAME value: HEADER_VALUE initialDelaySeconds: DELAY timeoutSeconds: TIMEOUT failureThreshold: THRESHOLD periodSeconds: PERIOD
Sostituisci
- SERVICE con il nome del servizio Cloud Run.
- IMAGE_URL con un riferimento all'immagine container, per
ad esempio
us-docker.pkg.dev/cloudrun/container/hello:latest
. Se utilizzi Artifact Registry, il repository REPO_NAME deve essere già stato creato. L'URL ha la formaLOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
- PATH con il percorso relativo dell'endpoint HTTP, ad esempio
/ready
. - (FACOLTATIVO) CONTAINER_PORT deve essere impostato sulla porta del contenitore impiegata per il servizio.
- (FACOLTATIVO)
httpHeaders
può essere utilizzato per fornire intestazioni personalizzate ripetute o multiple utilizzando i campi HEADER_NAME e HEADER_VALUE come mostrato. - (FACOLTATIVO) DELAY con numero di secondi di attesa dopo il container viene avviato prima di eseguire il primo probe. Specifica un valore compreso tra 0 e 240 secondi. Il valore predefinito è 0 secondi.
- (FACOLTATIVO) TIMEOUT con il numero di secondi di attesa fino al probe
si verifica un timeout. Questo valore non può superare il valore specificato per
periodSeconds
. Specifica un valore compreso tra 1 e 3600. Il valore predefinito è 1. - (FACOLTATIVO) THRESHOLD con il numero di tentativi del probe prima di chiudere il contenitore. Il valore predefinito è 3.
- (FACOLTATIVO) PERIOD con il periodo (in secondi) in cui eseguire il probe.
Ad esempio,
2
deve eseguire il probe ogni 2 secondi. Specifica un valore compreso tra 1 e 3600 secondi. Il valore predefinito è 10 secondi.
-
Crea o aggiorna il servizio utilizzando il seguente comando:
gcloud run services replace service.yaml
Avvio di gRPC
-
Se stai creando un nuovo servizio, salta questo passaggio. Se stai aggiornando un servizio esistente, scarica
la sua configurazione YAML:
gcloud run services describe SERVICE --format export > service.yaml
Configura l'attributo
startupProbe
come mostrato:apiVersion: serving.knative.dev/v1 kind: Service metadata: name: SERVICE spec: template: metadata: spec: containers: - image: IMAGE_URL startupProbe: grpc: service: GRPC_SERVICE port: CONTAINER_PORT initialDelaySeconds: DELAY timeoutSeconds: TIMEOUT failureThreshold: THRESHOLD periodSeconds: PERIOD
Sostituisci
- SERVICE con il nome del servizio Cloud Run.
- IMAGE_URL con un riferimento all'immagine container, per
ad esempio
us-docker.pkg.dev/cloudrun/container/hello:latest
. Se utilizzi Artifact Registry, il repository REPO_NAME deve essere già creati. L'URL ha la formaLOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
- GRPC_SERVICE con il nome del servizio gRPC a cui inviare il controllo di integrità.
- (FACOLTATIVO) CONTAINER_PORT deve essere impostato sulla porta del container utilizzati per il tuo servizio.
- (FACOLTATIVO) DELAY con numero di secondi di attesa dopo il container viene avviato prima di eseguire il primo probe. Specifica un valore compreso tra 0 e 240 secondi. Il valore predefinito è 0 secondi.
- (FACOLTATIVO) TIMEOUT con il numero di secondi di attesa prima del timeout del probe. Questo valore non può superare il valore specificato per periodSeconds. Specifica un valore compreso tra 1 e 240. Il valore predefinito è 1.
- (FACOLTATIVO) THRESHOLD con il numero di volte per riprovare il probe prima del giorno e l'arresto del container. Il valore predefinito è 3.
- (FACOLTATIVO) PERIOD con il periodo (in secondi) in cui eseguire il probe.
Ad esempio
2
per eseguire la sonda ogni 2 secondi. Specifica un valore compreso tra 1 e 240 secondi. Il valore predefinito è 10 secondi.
-
Crea o aggiorna il servizio utilizzando il comando seguente:
gcloud run services replace service.yaml
Attività gRPC
-
Se stai creando un nuovo servizio, salta questo passaggio. Se stai aggiornando un servizio esistente, scarica
la sua configurazione YAML:
gcloud run services describe SERVICE --format export > service.yaml
Configura l'attributo
livenessProbe
come mostrato:apiVersion: serving.knative.dev/v1 kind: Service metadata: name: SERVICE spec: template: metadata: spec: containers: - image: IMAGE_URL livenessProbe: grpc: port: CONTAINER_PORT service: GRPC_SERVICE initialDelaySeconds: DELAY timeoutSeconds: TIMEOUT failureThreshold: THRESHOLD periodSeconds: PERIOD
Sostituisci
- SERVICE con il nome del servizio Cloud Run.
- IMAGE_URL con un riferimento all'immagine del container, ad esempio
us-docker.pkg.dev/cloudrun/container/hello:latest
. Se utilizzi Artifact Registry, il repository REPO_NAME deve essere già creati. L'URL ha la formaLOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
- (FACOLTATIVO) CONTAINER_PORT deve essere impostato sulla porta del contenitore impiegata per il servizio.
- GRPC_SERVICE con il nome del servizio gRPC a cui inviare il controllo di integrità.
- (FACOLTATIVO) DELAY con il numero di secondi da attendere dopo l'avvio del container prima di eseguire il primo probe. Specifica un valore compreso tra 0 e 240 secondi. Il valore predefinito è 0 secondi.
- (FACOLTATIVO) TIMEOUT con il numero di secondi di attesa fino al probe
si verifica un timeout. Questo valore non può superare il valore specificato per
periodSeconds
. Specifica un valore compreso tra 1 e 3600. Il valore predefinito è 1. - (FACOLTATIVO) THRESHOLD con il numero di tentativi del probe prima di chiudere il contenitore. Il valore predefinito è 3.
- (FACOLTATIVO) PERIOD con il periodo (in secondi) in cui eseguire il probe. Ad esempio,
2
deve eseguire il probe ogni 2 secondi. Specifica un valore compreso tra 1 e 3600 secondi. Il valore predefinito è 10 secondi.
-
Crea o aggiorna il servizio utilizzando il seguente comando:
gcloud run services replace service.yaml
Terraform
Importante: se stai configurando il servizio Cloud Run per i controlli HTTP, devi anche aggiungere un endpoint nel codice del servizio per rispondere al controllo. Se configuri un probe gRPC, devi di implementare anche Protocollo gRPC Health Control nel tuo servizio Cloud Run.
Per scoprire come applicare o rimuovere una configurazione Terraform, consulta: Comandi Terraform di base.
avvio TCP
Configura il tuo servizio Cloud Run con l'attributo startup_probe
come mostrato di seguito:
Avvio HTTP
Assicurati che il servizio utilizzi HTTP/1 (l'impostazione predefinita di Cloud Run), non HTTP/2.
Configura il servizio Cloud Run con l'attributo startup_probe
come mostrato:
Attualità HTTP
Assicurati che il servizio utilizzi HTTP/1 (l'impostazione predefinita di Cloud Run), non HTTP/2.
Configura il tuo servizio Cloud Run con l'attributo liveness_probe
come mostrato di seguito:
Avvio di gRPC
Configura il tuo servizio Cloud Run con l'attributo startup_probe
come mostrato di seguito:
Attività gRPC
Configura il tuo servizio Cloud Run con l'attributo liveness_probe
come mostrato di seguito:
Creare endpoint di controllo di integrità HTTP
Se configuri il servizio Cloud Run per un probe di avvio HTTP o un probe di verifica della funzionalità, devi aggiungere un endpoint nel codice del servizio per rispondere al probe. L'endpoint può avere il nome che preferisci, ad esempio
/startup
o /ready
, ma devono corrispondere ai valori specificati per
path
nella configurazione del probe. Ad esempio, se specifichi /ready
per un
probe di avvio HTTP, specifica path
nella configurazione del probe come mostrato:
startupProbe: httpGet: path: /ready
Gli endpoint per il controllo di integrità HTTP sono accessibili dall'esterno e seguono lo stesso come qualsiasi altro endpoint del servizio HTTP esposto esternamente.