Questa pagina descrive come creare le code di Cloud Tasks utilizzando il comando gcloud
di gcloud CLI.
Prima di iniziare
I nomi delle code sono costituiti da tre parti: un ID progetto, una località e un ID coda. Per tutti i tipi di destinazione, devi avere un progetto Google Cloud che fornisce l'ID progetto.
Se utilizzi le attività target di App Engine, devi avere anche un'app App Engine. L'app si trova in un'area geografica specifica, che funge da parte del nome della coda, pertanto prendine nota quando aggiungi l'app. Questa è la posizione in cui vengono eseguiti la coda e i tuoi gestori.
L'utilizzo delle attività HTTP Target, invece, non richiede un'app App Engine. Puoi selezionare una località Google Cloud quando crei la coda.
Crea una coda di attività Cloud Tasks
Utilizza Google Cloud SDK per creare la coda:
gcloud tasks queues create QUEUE_ID --location=LOCATION
Sostituisci quanto segue:
LOCATION
: la località in cui viene eseguita la coda, ad esempioeurope-west4
.- Se la tua organizzazione limita la località delle risorse e vuoi creare la coda in
us-central1
ous-central2
, il criterio dell'organizzazione deve consentire la creazione di code sia inus-central1
che inus-central2
(anche se hai bisogno di una coda solo in una di quelle regioni).
- Se la tua organizzazione limita la località delle risorse e vuoi creare la coda in
QUEUE_ID
: l'identificatore assegnato alla coda, ad esempiomy-queue
.
Potrebbero essere necessari alcuni minuti prima che una coda appena creata sia disponibile. Utilizza quindi describe
per verificare che la coda sia stata creata correttamente:
gcloud tasks queues describe QUEUE_ID --location=LOCATION
Sostituisci quanto segue:
QUEUE_ID
: l'ID coda (nome breve)LOCATION
: la posizione della coda
L'output dovrebbe essere simile al seguente:
name: projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID rateLimits: maxBurstSize: 100 maxConcurrentDispatches: 1000 maxDispatchesPerSecond: 500.0 retryConfig: maxAttempts: 100 maxBackoff: 3600s maxDoublings: 16 minBackoff: 0.100s state: RUNNING
Se non vedi l'output precedente, puoi provare quanto segue:
- Attendi almeno un minuto per l'inizializzazione della coda.
Assicurati che non esista già una coda con lo stesso ID. Puoi visualizzare le code del progetto chiamando:
gcloud tasks queues list --location=LOCATION
Per cercare in più sedi devi effettuare più richieste.
Controlla se hai raggiunto il limite di code:
Vai alla pagina dell'API Cloud Tasks
e seleziona Quote.
Per aumentare i limiti delle risorse, seleziona Modifica quote nella pagina Quote della console Google Cloud
Controlla ogni parte del comando ed eseguilo di nuovo.
Passaggi successivi
- Scopri di più sulla configurazione delle code di Cloud Tasks.
- Scopri di più sulla gestione delle code nel riferimento dell'API RPC.
- Scopri di più sulla gestione delle code nel riferimento sull'API REST.
- Consulta l'elenco completo dei comandi
gcloud
di Cloud Tasks.