Quando un'istanza di container riceve richieste, Cloud Run esegue il downgrade di queste richieste da HTTP/2 a HTTP/1, ad eccezione del traffico gRPC nativo, che richiede HTTP/2 per funzionare correttamente. Questa pagina mostra come configurare il servizio in modo che utilizzi HTTP/2 end-to-end, il che impedisce a Cloud Run di eseguire il downgrade delle richieste a HTTP1.
Per saperne di più sulla chiamata di servizi tramite HTTP, consulta Richiamare un servizio con una richiesta HTTPS.
Prima della configurazione
Il servizio Cloud Run deve gestire le richieste in formato HTTP/2 cleartext (h2c). L'infrastruttura di gestione del frontend di Google termina TLS e poi inoltra il traffico h2c a Cloud Run e al tuo container tramite un canale criptato.
Per verificare che il tuo servizio supporti le richieste h2c, testa il servizio localmente utilizzando questo comando curl:
curl -i --http2-prior-knowledge http://localhost:PORT
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per configurare ed eseguire il deployment di servizi Cloud Run, chiedi all'amministratore di concederti i seguenti ruoli IAM:
- Cloud Run Developer (
roles/run.developer) sul servizio Cloud Run - Utente dell'account di servizio (
roles/iam.serviceAccountUser) sull'identità di servizio
Se esegui il deployment di un servizio o di una funzione dal codice sorgente, devi disporre anche di ruoli aggiuntivi concessi al tuo progetto e al account di servizio Cloud Build.
Per un elenco di ruoli e autorizzazioni IAM associati a Cloud Run, consulta Ruoli IAM di Cloud Run e Autorizzazioni IAM di Cloud Run. Se il tuo servizio Cloud Run interagisce con le APICloud de Confiance , come le librerie client Cloud, consulta la guida alla configurazione dell'identità del servizio. Per saperne di più sulla concessione dei ruoli, consulta Autorizzazioni di deployment e Gestisci l'accesso.
Servizi HTTP/2 supportati
HTTP/2 è ideale per una varietà di applicazioni. Ecco alcuni casi d'uso comuni:
- Servizi gRPC: crea microservizi ad alte prestazioni e a bassa latenza che comunicano utilizzando gRPC.
- API con throughput elevato: riducono l'overhead per le applicazioni che richiedono una gestione efficiente di numerose richieste di piccole dimensioni o che devono inviare dati ai client.
Imposta e aggiorna HTTP/2 end-to-end
Qualsiasi modifica alla configurazione comporta la creazione di una nuova revisione. Anche le revisioni successive riceveranno automaticamente questa impostazione di configurazione, a meno che non vengano apportati aggiornamenti espliciti per modificarla.
Puoi specificare l'utilizzo di HTTP/2 end-to-end utilizzando la console Cloud de Confiance , Google Cloud CLI o YAML quando crei un nuovo servizio o esegui il deployment di una nuova revisione:
Console
Nella console Cloud de Confiance , vai alla pagina Cloud Run:
Seleziona Servizi dal menu di navigazione di Cloud Run:
Se stai configurando un nuovo servizio, fai clic su Esegui il deployment del container e compila la pagina delle impostazioni iniziali del servizio. Quindi fai clic su Container, networking, sicurezza per espandere la pagina di configurazione del servizio.
Se stai configurando un servizio esistente, fai clic sul servizio.
Fai clic sulla scheda Networking.
Seleziona la casella di controllo accanto a Utilizza HTTP/2 end-to-end. Assicurati che l'immagine container personalizzata supporti le richieste HTTP/2.
Fai clic su Crea per un nuovo servizio. Fai clic su Visualizza differenze e fai di nuovo il deployment, quindi su Esegui il deployment delle modifiche per un servizio esistente.
gcloud
Puoi aggiornare un determinato servizio per utilizzare HTTP/2 utilizzando il seguente comando:
gcloud run services update SERVICE --use-http2
Sostituisci SERVICE con il nome del servizio.
Puoi anche impostare il servizio in modo che utilizzi HTTP/2 durante il deployment utilizzando il comando:
gcloud run deploy --image IMAGE_URL --use-http2
Sostituisci IMAGE_URL con un riferimento all'immagine container personalizzata che supporta le richieste HTTP/2.
YAML
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
Aggiorna
portscon il nomeh2cecontainerPortcon la porta che preferisci, come mostrato nell'esempio seguente:apiVersion: serving.knative.dev/v1 kind: Service metadata: name: SERVICE spec: template: metadata: name: REVISION spec: containers: - image: IMAGE_URL ports: - name: h2c containerPort: 8080
Sostituisci quanto segue:
- SERVICE: il nome del tuo servizio Cloud Run
- IMAGE_URL: un riferimento all'immagine container personalizzata che supporta le richieste HTTP/2
REVISION: un nuovo nome della revisione o eliminalo (se presente). Se fornisci un nuovo nome per la revisione, questo deve soddisfare i seguenti criteri:- Inizia con
SERVICE- - Contiene solo lettere minuscole, numeri e
- - Non termina con
- - Non supera i 63 caratteri
- Inizia con
Crea o aggiorna il servizio utilizzando il seguente comando:
gcloud run services replace service.yaml
Per impostazione predefinita, il comando
gcloud run services replaceutilizza il fileservice.yaml, se presente.
Terraform
Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.
Aggiungi quanto segue a una risorsagoogle_cloud_run_v2_service nella configurazione Terraform: resource "google_cloud_run_v2_service" "default" {
name = "cloudrun-service-h2c"
location = "us-central1"
deletion_protection = false # set to "true" in production
template {
containers {
image = IMAGE_URL
# Enable HTTP/2
ports {
name = "h2c"
container_port = 8080
}
}
}
}
Sostituisci IMAGE_URL con un riferimento all'immagine container personalizzata che supporta le richieste HTTP/2.
Se il container rimane in ascolto delle richieste HTTP su una porta diversa da 8080, sostituisci 8080 con il numero di porta.
Visualizza le impostazioni HTTP/2
Per visualizzare le impostazioni HTTP/2 attuali per il tuo servizio Cloud Run:
Console
Nella console Cloud de Confiance by S3NS , vai alla pagina Servizi di Cloud Run:
Fai clic sul servizio che ti interessa per aprire la pagina Dettagli servizio.
Fai clic sulla scheda Networking per visualizzare le impostazioni.
gcloud
Utilizza il seguente comando:
gcloud run services describe SERVICE
Individua l'impostazione HTTP/2 nella configurazione restituita.
Utilizza HTTP/2 dietro un bilanciatore del carico
Se configurato per l'ascolto di HTTP/2, Cloud Run gestisce automaticamente il traffico HTTP/2 o gRPC proveniente dal bilanciatore del carico delle applicazioni. Non è necessaria alcuna configurazione specifica sul servizio di backend del bilanciatore del carico.
Per configurare Cloud Run in modo che utilizzi HTTP/2 o gRPC, utilizza uno dei seguenti metodi:
- Imposta e aggiorna HTTP/2 end-to-end
- Configura un bilanciatore del carico delle applicazioni esterno con il tuo servizio Cloud Run come backend.