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

Crea 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, la policy dell'organizzazione deve consentire la creazione della coda sia in us-central1 sia in us-central2 (anche se hai bisogno di una coda solo in una 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.

Descrivi 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 e poi 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