Impostazione del timeout della richiesta

Scopri come impostare il tempo entro il quale i servizi Knative serving devono restituire una risposta a una richiesta. Se una risposta non viene restituita entro il tempo specificato, la richiesta termina e viene restituito l'errore 504.

Limiti di timeout

Il limite di timeout massimo varia in base alla versione del tuo cluster GKE.

Versione GKE Limite predefinito Limite di timeout massimo
0.16.0-gke.1 e versioni successive 300 secondi 24 ore
0.15.0-gke.3 e versioni precedenti 300 secondi 900 secondi

Oltre a modificare il timeout della richiesta di Knative serving, devi controllare il framework della lingua per verificare se ha una propria impostazione di timeout della richiesta che devi aggiornare.

Impostazione e aggiornamento del timeout della richiesta

Qualsiasi modifica alla configurazione comporta la creazione di una nuova revisione. Le revisioni successive riceveranno automaticamente anche questa impostazione di configurazione, a meno che tu non apporti aggiornamenti espliciti per modificarla.

Puoi impostare il timeout della richiesta utilizzando la Google Cloud console, Google Cloud CLI o un file YAML quando esegui il deployment di un nuovo servizio o aggiorni un servizio esistente ed esegui il deployment di una revisione:

Console

  1. Vai a Knative serving nella Google Cloud console:

    Vai a Knative serving

  2. Fai clic su Crea servizio se stai configurando un nuovo servizio di cui stai eseguendo il deployment. Se stai configurando un servizio esistente, fai clic sul servizio, quindi su Modifica ed esegui il deployment di una nuova revisione.

  3. In Impostazioni avanzate, fai clic su Container.

  4. Nel campo Timeout della richiesta, inserisci il valore di timeout che vuoi utilizzare. Il valore specificato deve essere inferiore al limite di timeout per la versione GKE del cluster.

  5. Fai clic su Avanti per continuare alla sezione successiva.

  6. Nella sezione Configura il funzionamento del trigger per questo servizio , seleziona la connettività che vuoi utilizzare per richiamare il servizio.

  7. Fai clic su Crea per eseguire il deployment dell'immagine in Knative serving e attendi il completamento del deployment.

Riga di comando

  • Per i servizi esistenti, imposta il timeout della richiesta eseguendo il comando gcloud run services update con il --timeout parametro:

    gcloud run services update SERVICE --timeout TIMEOUT

    Sostituisci:

    • SERVICE con il nome del tuo servizio.
    • TIMEOUT con il tempo desiderato, utilizzando un valore intero in secondi o un valore di durata assoluta, ad esempio 1m20s, ovvero 1 minuto e 20 secondi. Il valore specificato deve essere inferiore al limite di timeout per la versione GKE del cluster. Specifica 0 per impostare il timeout sul valore predefinito.
  • Per i nuovi servizi, imposta il timeout della richiesta eseguendo il comando gcloud run deploy con il --timeout parametro:

    gcloud run deploy SERVICE --image=IMAGE_URL --timeout TIMEOUT

    Sostituisci:

    • SERVICE con il nome del tuo servizio.
    • IMAGE_URL con un riferimento all'immagine container, ad esempio, gcr.io/cloudrun/hello.
    • TIMEOUT con il tempo desiderato, utilizzando un valore intero in secondi o un valore di durata assoluta, ad esempio 1m20s, ovvero 1 minuto e 20 secondi. Il valore specificato deve essere inferiore al limite di timeout per la versione GKE del cluster. Specifica 0 per impostare il timeout sul valore predefinito.

YAML

Puoi scaricare la configurazione di un servizio esistente in un file YAML con il gcloud run services describe comando utilizzando il --format=export flag. Puoi quindi modificare il file YAML ed eseguire il deployment delle modifiche con il comando gcloud run services replace. Devi assicurarti di modificare solo gli attributi specificati.

  1. Scarica la configurazione del servizio in un file denominato service.yaml nell'area di lavoro locale:

    gcloud run services describe SERVICE --format export > service.yaml

    Sostituisci SERVICE con il nome del tuo servizio Knative serving.

  2. Nel file locale, aggiorna l'attributo timeoutSeconds:

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
      name: SERVICE
    spec:
      template:
        spec:
          containers:
          - image: IMAGE
          timeoutSeconds: TIMEOUT

    Sostituisci:

    • SERVICE con il nome del tuo servizio Knative serving
    • IMAGE_URL con un riferimento all'immagine container, ad esempio, gcr.io/cloudrun/hello.
    • TIMEOUT con il timeout desiderato, in secondi.
  3. Sostituisci il servizio con la nuova configurazione utilizzando il seguente comando:

    gcloud run services replace service.yaml