Creazione delle code in modalità pull

In questa pagina viene descritto 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 Python 3 runtime, consulta guida alla migrazione per saperne di più sulle opzioni di migrazione per i servizi in bundle legacy.

Definizione delle code con queue.yaml

Puoi definire le code in modalità 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 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 di configurazione della coda, deve avere l'autorizzazione serviceusage.services.list. Questa autorizzazione può essere aggiunta utilizzando il ruolo serviceusage.serviceUsageViewer o creando un ruolo personalizzato con tale autorizzazione.

Attenzione: la creazione di code per il servizio Coda di attività può essere gestita anche utilizzando I metodi di gestione delle code disponibili direttamente tramite l'API Cloud Tasks, ma combinando il metodo di caricamento queue.yaml con i metodi di gestione delle code può produrre risultati imprevisti e non è consigliato. Per ulteriori informazioni, consulta la Panoramica della gestione delle code e della coda.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 gcloud CLI viene 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. Qualsiasi attività in coda o nuove attività già presenti aggiunti alla coda non verranno elaborati. Puoi riattivare la coda disattivata caricando un nuovo file di 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 disabilitarla:

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

2. Carica il file modificato.

   gcloud app deploy queue.yaml
   

Una volta disabilitata 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à.