Creazione delle code in modalità pull

Questa pagina descrive come creare una coda in modalità pull. Devi creare la coda prima di potervi aggiungere attività. La pagina descrive anche come mettere in pausa o eliminare una coda.

Questa API è supportata per runtime di prima generazione e può essere utilizzata quando eseguire l'upgrade ai runtime di seconda generazione corrispondenti. Se esegui l'aggiornamento al runtime App Engine Java 11/17, consulta la guida alla migrazione per scoprire di più sulle opzioni di migrazione per i servizi in bundle legacy.

Definizione delle code con queue.yaml

Puoi definire le code pull utilizzando il file queue.yaml per la tua applicazione. La procedura è la stessa utilizzata per creare code push con nome, con l'aggiunta al file di un'istruzione specializzata, mode: pull.

queue:
- name: my-queue-name
  mode: pull

Utilizza il comando gcloud gcloud CLI per caricare il file.

gcloud app deploy queue.yaml

Nota: se utilizzi un account di servizio per gestire l'autenticazione per il deployment del file di configurazione della coda, questo deve disporre dell'autorizzazione serviceusage.services.list. Questa autorizzazione può essere aggiunta utilizzando il ruolo serviceusage.serviceUsageViewer o creando un ruolo personalizzato con questa autorizzazione.

Attenzione: la creazione di code per il servizio Coda di attività può essere gestita anche utilizzando metodi di gestione delle code disponibili direttamente tramite l'API Cloud Tasks, ma l'unione del metodo di caricamento queue.yaml con i metodi di gestione delle code può produrre risultati imprevisti e non è consigliata. Per ulteriori informazioni, consulta la panoramica di Gestione delle code e queue.yaml. Tieni inoltre presente che il caricamento di un file queue.yaml tramite gcloud CLI precedente alla versione 332.0.0 utilizza un'interfaccia deprecata per il servizio. A partire dal giorno 2022-09-20, i tentativi di utilizzare il metodo di caricamento possono non riuscire con errori del server. Per risolvere il problema, assicurati che l'API Cloud Tasks sia abilitata nel tuo progetto e che l'gcloud CLI sia aggiornata almeno alla versione 332.0.0.

Disattivazione delle code

Puoi disattivare o mettere in pausa una coda rimuovendo la relativa definizione dal file di configurazione della coda e caricando il file aggiornato.

Una volta caricato il file aggiornato, la coda viene impostata su "disattivata" e la relativa frequenza su 0. Le attività in coda o le nuove attività aggiunte alla coda non verranno elaborate. Puoi riattivare la coda disattivata caricando un nuovo file coda con la coda definita.

Puoi anche mettere in pausa una coda dalla pagina Cloud Tasks nella console Google Cloud.

Eliminazione delle code

Per eliminare una coda, devi prima disattivarla:

1. Rimuovi la definizione della coda dal file di configurazione della coda.

2. Carica il file modificato.

   gcloud app deploy queue.yaml
   

Una volta disattivata la coda, utilizza la console Google Cloud per eliminarla.

1. Nella console Google Cloud, seleziona la coda.

   Vai a Cloud Tasks

2. Fai clic su Elimina coda.

Se elimini una coda dalla console Google Cloud, devi attendere 7 giorni prima di ricrearla con lo stesso nome.

Importante: il server di sviluppo locale (dev_appserver) non supporta le code pull. Per testare le code pull e assicurarti che i dettagli della configurazione siano corretti, devi eseguire il push del file di configurazione della coda in un ambiente di staging App Engine.

Passaggi successivi

Scopri come creare attività.