Creare code di Cloud Tasks

Questa pagina descrive come creare code di Cloud Tasks utilizzando il comando gcloud della gcloud CLI.

Prima di iniziare

I nomi delle code sono composti da tre parti: un ID progetto, una località e un ID coda. Per tutti i tipi di destinazione, devi disporre di un progetto Google Cloud, che fornisce l'ID progetto.

Se utilizzi attività target di App Engine, devi disporre anche di un'app App Engine. L'app si trova in una regione specifica e questa regione funge da parte della località del nome della coda, quindi prendine nota quando aggiungi l'app. In questa località vengono eseguiti la coda e i gestori.

L'utilizzo delle attività di destinazione HTTP, invece, non richiede un'app App Engine. Devi selezionare una località Google Cloud quando crei la coda.

Crea una coda di attività Cloud Tasks

Utilizza l'SDK Google Cloud per creare la coda:

    gcloud tasks queues create QUEUE_ID --location=LOCATION

Sostituisci quanto segue:

  • LOCATION: la posizione in cui viene eseguita la coda, ad esempio asia-south1.

    • Se la tua organizzazione limita la località delle risorse e vuoi creare la coda in us-central1 o us-central2, i criteri dell'organizzazione devono consentire la creazione della coda sia in us-central1 sia in us-central2 (anche se hai bisogno di una sola coda in una di queste regioni).

  • QUEUE_ID: l'identificatore che assegni alla coda, ad esempio my-queue.

Potrebbero essere necessari alcuni minuti prima che una coda appena creata sia disponibile. Quindi, utilizza 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 (il 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 nel tuo progetto chiamando:

    gcloud tasks queues list --location=LOCATION

    Per cercare in più località, devi effettuare più richieste.

  • Controlla se hai raggiunto il limite della coda:

    Vai alla pagina dell'API Cloud Tasks

    e seleziona Quote.

    Per aumentare i limiti di risorse, seleziona Modifica quote nella pagina Quote della console Google Cloud.

  • Controlla ogni parte del comando ed eseguilo di nuovo.

Passaggi successivi