Creare code di Cloud Tasks

Questa pagina descrive come creare code di Cloud Tasks. Quando le attività vengono aggiunte a una coda, la coda le invia e si assicura che vengano elaborate in modo affidabile da un servizio, noto anche come worker.

Tieni presente quanto segue:

  • I nomi delle code sono composti da tre parti: un ID progetto, una località e un ID coda. Devi avere un Google Cloud progetto che fornisca l'ID progetto.

  • Se utilizzi le attività di destinazione di App Engine, devi anche avere un' applicazione App Engine che si trova in una regione specifica e in cui vengono eseguite la coda e i gestori. Prendi nota della regione quando aggiungi l'app.

  • L'utilizzo delle attività di destinazione HTTP non richiede un'app App Engine. Quando crei la coda, seleziona una Google Cloud località.

Creare una coda

Puoi creare una coda nei seguenti modi:

  • Nella Google Cloud console
  • Utilizzando Google Cloud CLI nel terminale o in Cloud Shell
  • Inviando una richiesta diretta all'API Cloud Tasks

Console

  1. Nella Google Cloud console, vai alla pagina Cloud Tasks > Code.

    Vai a Code

  2. Fai clic su Crea coda.

  3. Inserisci un Nome coda, ad esempio my-queue.

  4. Nell'elenco Regione, seleziona una località supportata in cui verrà 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, il criterio dell'organizzazione deve consentire la creazione della coda sia in us-central1 sia in us-central2 (anche se ti serve una coda in una sola di queste regioni).

  5. (Facoltativo) Puoi configurare ulteriormente la coda .

  6. Fai clic su Crea.

gcloud

Utilizza il gcloud tasks queues create comando per creare la coda:

  gcloud tasks queues create QUEUE_ID \
      --location=LOCATION

Sostituisci quanto segue:

Altri flag per il comando gcloud CLI consentono di configurare i limiti di frequenza, le opzioni di ripetizione, i tipi di coda e altro ancora.

API REST

Per creare una coda, utilizza il projects.locations.queues.create metodo.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

Altre proprietà configurabili per la Queue risorsa includono limiti di frequenza, opzioni di ripetizione, tipi di coda e altro ancora.

Corpo JSON della richiesta: 

{
  "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID"
}

Per inviare la richiesta, espandi una di queste opzioni:

In caso di esito positivo, il corpo della risposta contiene un'istanza di Queue appena creata: 

{
  "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID",
  "rateLimits": {
    "maxDispatchesPerSecond": 500,
    "maxBurstSize": 100,
    "maxConcurrentDispatches": 1000
  },
  "retryConfig": {
    "maxAttempts": 100,
    "minBackoff": "0.100s",
    "maxBackoff": "3600s",
    "maxDoublings": 16
  },
  "state": "RUNNING"
}

Potrebbero essere necessari alcuni minuti prima che una coda appena creata sia disponibile.

Descrivere la coda

Puoi verificare che la coda sia stata creata correttamente nei seguenti modi:

  • Nella Google Cloud console
  • Utilizzando gcloud CLI nel terminale o in Cloud Shell

  • Inviando una richiesta diretta all'API Cloud Tasks

Console

  1. Nella Google Cloud console, vai alla pagina Cloud Tasks > Code.

    Vai a Code

    Un segno di spunta verde dovrebbe indicare che la coda è in esecuzione.

  2. Per ulteriori dettagli, fai clic sul nome della coda, quindi fai clic sulla scheda Configurazione.

gcloud

Utilizza il gcloud tasks queues describe comando per verificare che la coda sia stata creata correttamente:

gcloud tasks queues describe QUEUE_ID \
    --location=LOCATION

Sostituisci quanto segue:

  • QUEUE_ID: l'ID della coda (il nome breve)
  • LOCATION: la località 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

API REST

Per recuperare una coda, utilizza il projects.locations.queues.get metodo.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

Per inviare la richiesta, espandi una di queste opzioni:

In caso di esito positivo, il corpo della risposta contiene un'istanza di Queue: 

{
  "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID",
  "rateLimits": {
    "maxDispatchesPerSecond": 500,
    "maxBurstSize": 100,
    "maxConcurrentDispatches": 1000
  },
  "retryConfig": {
    "maxAttempts": 100,
    "minBackoff": "0.100s",
    "maxBackoff": "3600s",
    "maxDoublings": 16
  },
  "state": "RUNNING"
}

Risolvere i problemi relativi alla creazione di una coda

Se non vedi l'output previsto, puoi provare a eseguire le seguenti operazioni:

  • 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 utilizzando il gcloud tasks queues list comando:

    gcloud tasks queues list \
    --location=LOCATION

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

  • Verifica se hai raggiunto la quota della coda quota:

    1. Nella Google Cloud console, vai alla pagina Dettagli API/servizio per l'API Cloud Tasks.

      Vai a Dettagli API/servizio

    2. Fai clic sulla scheda Quote e limiti di sistema.

    3. Per aumentare una quota, nella riga relativa alla quota, fai clic sull'icona con i puntini di sospensione > Modifica quota.

      Per ulteriori informazioni, consulta Richiedi un aggiustamento delle quote.

  • Esegui di nuovo i comandi per creare la coda e assicurati che ogni passaggio sia completato correttamente.

Passaggi successivi