Questa pagina spiega come eseguire la migrazione del codice delle code in coda in modalità pull dalle code di attività a Pub/Sub. Pub/Sub è ora il modo consigliato per gestire code in modalità coda in modalità pull in App Engine.
Se la tua app utilizza sia code in modalità pull sia code in modalità push, usa questa guida per eseguire la migrazione delle code in modalità pull a Pub/Sub prima di eseguire la migrazione delle code in modalità push al nuovo servizio di coda in modalità push Cloud Tasks. La migrazione delle code in modalità pull dopo la migrazione delle code in modalità push a Cloud Tasks non è consigliata perché l'utilizzo obbligatorio del file queue.yaml potrebbe causare un comportamento imprevisto con Cloud Tasks.
Funzionalità non attualmente disponibili in Pub/Sub
Le seguenti funzionalità delle code di attività non sono attualmente disponibili in Pub/Sub:
- Batching per tag
- Deduplicazione automatica
Prezzi e quote
La migrazione delle code in modalità pull a Pub/Sub potrebbe influire sui prezzi e sulle quote della tua app.
Prezzi
Pub/Sub ha prezzi propri. Come per le code di attività, l'invio di richieste alla tua app App Engine con Pub/Sub può comportare costi per l'app.
Quote
Le quote di Pub/Sub quotas sono diverse da quelle delle quote per le code di attività. Come per le code di attività, l'invio di richieste alla tua app App Engine da Pub/Sub potrebbe influire sulle quote di richieste di App Engine richieste.
Prima della migrazione
Le sezioni seguenti illustrano i passaggi di configurazione prima di eseguire la migrazione delle code in modalità pull a Pub/Sub.
Abilitazione dell'API Pub/Sub
Per abilitare l'API Pub/Sub, fai clic su Abilita nell' API Pub/Sub nella libreria API. Se vedi un pulsante Gestisci anziché un pulsante Abilita, significa che hai già abilitato l'API Pub/Sub per il tuo progetto e non devi farlo di nuovo.
Autenticazione dell'app nell'API Pub/Sub
Devi autenticare la tua app nell'API Pub/Sub. Questa sezione illustra l'autenticazione per due casi d'uso diversi.
Per sviluppare o testare l'app in locale, ti consigliamo di utilizzare un account di servizio. Per istruzioni su come configurare un account di servizio e connetterlo alla tua app, leggi Ottenere e fornire manualmente le credenziali dell'account di servizio.
Per eseguire il deployment dell'app su App Engine, non devi fornire una nuova autenticazione. Le Credenziali predefinite dell'applicazione (ADC) deducono i dettagli di autenticazione per le app App Engine.
Download di Google Cloud CLI
Scarica e installa il Google Cloud CLI per utilizzare il gcloud CLI con l'API Pub/Sub se non l'hai installato in precedenza. Esegui il seguente comando dal terminale se hai già installato Google Cloud CLI.
gcloud components update
Importazione delle librerie client di Cloud
Segui le istruzioni di Pub/Sub per installare la libreria client da utilizzare con la tua app.Pub/Sub e code in modalità pull
Confronto delle funzioni
Pub/Sub invia il lavoro ai worker tramite una relazione publisher/sottoscrittore. Una sottoscrizione pull in Pub/Sub è simile a una coda in modalità pull nelle code di attività perché il sottoscrittore esegue il pull del messaggio dall'argomento. La tabella seguente elenca la funzionalità principale per le code in modalità pull nelle code di attività e la funzionalità associata per le sottoscrizioni pull in Pub/Sub.
| Funzionalità delle code di attività | Funzionalità di Pub/Sub |
|---|---|
| Coda | Argomento |
| Attività | Messaggio |
| Worker | Sottoscrittore |
Per saperne di più sull'architettura di Pub/Sub, leggi Google Cloud Pub/Sub: un servizio di messaggistica su scala Google.
Confronto dei flussi di lavoro
Di seguito è riportato un confronto tra un flusso di lavoro tipico per una coda in modalità pull in code di attività e una sottoscrizione pull in Pub/Sub.
| Flusso di lavoro delle code di attività | Flusso di lavoro di Pub/Sub |
|---|---|
| Crei la coda in modalità pull | Crei l'argomento e sottoscrivi il sottoscrittore (ovvero il worker) a l'argomento |
| Crei e metti in coda l'attività | Crei il messaggio e lo pubblichi nell'argomento |
| Il worker acquisisce la lease dell'attività | Il sottoscrittore esegue il pull del messaggio dall'argomento |
| Il worker elabora l'attività | Il sottoscrittore elabora il messaggio |
| Il worker elimina l'attività dalla coda | Il sottoscrittore conferma il messaggio |
| La lease scade | L'argomento elimina il messaggio quando tutti i sottoscrittori lo hanno confermato |
Creazione di sottoscrizioni pull in Pub/Sub
Puoi utilizzare una sottoscrizione pull Pub/Sub come una coda in modalità pull delle code di attività. Le sottoscrizioni a un argomento non scadono e possono esistere contemporaneamente per più worker. Ciò significa che un messaggio può essere elaborato da più di un worker, che è uno dei casi d'uso principali di Pub/Sub. Per ricreare le code in modalità pull delle code di attività come sottoscrizioni pull Pub/Sub, crea un argomento per ogni worker e sottoscrivi solo il worker associato all'argomento. In questo modo, ogni messaggio viene elaborato da un solo worker, come nelle code di attività. Per scoprire come creare e gestire le sottoscrizioni pull, leggi Gestire argomenti e sottoscrizioni.
Eliminazione delle code in modalità pull
Dopo aver eseguito la migrazione delle code in modalità pull delle code di attività alle sottoscrizioni pull Pub/Sub, eliminale dalle code di attività utilizzando il file queue.yaml. Ti consigliamo di eliminare ogni coda in modalità pull prima di eseguire la migrazione della successiva. In questo modo, l'app non duplica il lavoro ricevuto dalla nuova sottoscrizione pull Pub/Sub durante la migrazione delle altre code in modalità pull. Tieni presente che l'eliminazione delle
code in modalità pull delle code di attività una alla volta anziché in un singolo
deployment potrebbe avere un impatto maggiore sulla quota di deployment di App Engine
deployment.
Dopo aver eliminato tutte le code in modalità pull dalle code di attività, puoi omettere il file queue.yaml dai deployment futuri dell'app.
Se la tua app utilizza solo code in modalità pull, rimuovi tutti i riferimenti all'API delle code di attività nel codice. Se la tua app utilizza sia code in modalità pull sia code in modalità push, puoi rimuovere i riferimenti all'API delle code di attività che si trovano nei file che utilizzano solo code in modalità pull oppure attendere di aver eseguito la migrazione anche delle code in modalità push e poi rimuovere i riferimenti all'API delle code di attività da tutti i file.