Creazione delle code in modalità pull

Questa pagina descrive come creare una coda in modalità pull. Devi creare la coda prima puoi aggiungervi attività. In questa pagina viene inoltre descritto 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 ad App Engine in Python 3, 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. Il processo è lo stesso della creazione di code in modalità push denominate, con un'istruzione specializzata, mode: pull, aggiunta al file.

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

Utilizzerai il comando gcloud dell'interfaccia alla 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 della coda disponibili direttamente tramite l'API Cloud Tasks, ma l'unione del metodo di caricamento queue.yaml con i metodi di gestione della coda 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 seguente 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'interfaccia a riga di comando gcloud sia aggiornata almeno alla versione 332.0.0.

Disabilitazione delle code

Puoi disattivare o mettere in pausa una coda rimuovendo la relativa definizione dalla coda. di configurazione del deployment e poi caricare il file aggiornato.

Una volta caricato il file aggiornato, la coda viene impostata su "disattivata" e la sua frequenza è impostata 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 dall'interno Pagina Cloud Tasks nella console Google Cloud.

Eliminazione delle code in corso...

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. Seleziona la coda nella console Google Cloud.

   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 in modalità pull. Per testare le code in modalità pull e assicurarti che i dettagli della configurazione siano corretti, dovrai eseguire il push del file di configurazione della coda a un ambiente di gestione temporanea di App Engine.

Passaggi successivi

Scopri come creare attività.