Creazione delle code in modalità pull

In questa pagina viene descritto 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 Go 1.12 o versioni successive , 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 in modalità pull utilizzando il file queue.yaml dell'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

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 della gestione delle code e della coda.yaml. Tieni inoltre presente che il caricamento di un file queue.yaml tramite l'interfaccia a riga di comando gcloud precedente alla versione 332.0.0 utilizza un'interfaccia deprecata del 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 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 dall'interno Pagina Cloud Tasks nella console Google Cloud.

Eliminazione delle code

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 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 in modalità 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à.