Creare code di Cloud Tasks

Questa pagina descrive come creare code 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 costituiti 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 attività di destinazione 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.

  Nota: due posizioni, chiamate europe-west e us-central nei comandi App Engine, sono chiamate rispettivamente europe-west1 e us-central1 nei comandi Cloud Tasks.

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

Creare una coda

Puoi creare una coda nei seguenti modi:

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

Nota: se stai configurando il routing per una coda App Engine e non imposti esplicitamente il servizio di destinazione che contiene il worker appropriato, viene utilizzato il servizio predefinito. Per saperne di più, vedi Configurare le code Cloud Tasks.

Console

1. Nella console Google Cloud , 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 di code sia in us-central1 che in us-central2 (anche se ti serve una coda solo in una di queste regioni).

5. Facoltativamente, puoi configurare ulteriormente la coda.

6. Fai clic su Crea.

gcloud

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

  gcloud tasks queues create QUEUE_ID \
      --location=LOCATION

Sostituisci quanto segue:

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

• LOCATION: una regione 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 di code sia in us-central1 che in us-central2 (anche se ti serve una coda solo in una di queste regioni).

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

API REST

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

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

• PROJECT_ID: il tuo ID progetto Google Cloud .
• LOCATION: una regione 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, i criteri dell'organizzazione devono consentire la creazione di code sia in us-central1 sia in us-central2 (anche se hai bisogno di una coda solo in una di queste regioni).

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

Altre proprietà configurabili per la risorsa Queue includono limiti di frequenza, opzioni di ripetizione dei tentativi, 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:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json. Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory corrente:

cat > request.json << 'EOF'
{
  "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID"
}
EOF

Quindi, esegui questo comando per inviare la richiesta REST:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues"

PowerShell (Windows)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json. Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory corrente:

@'
{
  "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID"
}
'@  | Out-File -FilePath request.json -Encoding utf8

Quindi, esegui questo comando per inviare la richiesta REST:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues" | Select-Object -Expand Content

Explorer API (browser)

Copia il corpo della richiesta e apri la pagina di riferimento del metodo. Sul lato destro della pagina si apre il riquadro Explorer API. Puoi interagire con questo strumento per inviare richieste. Incolla il corpo della richiesta in questo strumento, compila gli altri campi obbligatori e fai clic su Esegui.

In caso di esito positivo, il corpo della risposta contiene un'istanza appena creata 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"
}

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

Descrivi la tua coda

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

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

• Inviando una richiesta diretta all'API Cloud Tasks

Console

1. Nella console Google Cloud , 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 comando gcloud tasks queues 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 della 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

API REST

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

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

• PROJECT_ID: il tuo ID progetto Google Cloud .
• LOCATION: la regione in cui viene eseguito il deployment della coda, ad esempio us-central1.
• QUEUE_ID: l'ID breve della coda, ad esempio my-queue.

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID"

PowerShell (Windows)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID" | Select-Object -Expand Content

Explorer API (browser)

Apri la pagina di riferimento del metodo. Sul lato destro della pagina si apre il riquadro Explorer API. Puoi interagire con questo strumento per inviare richieste. Completa i campi obbligatori e fai clic su Esegui.

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

Nota: la registrazione per la coda non è abilitata per impostazione predefinita. Per informazioni sull'abilitazione della registrazione, consulta Utilizzare Cloud Logging con le code.

Se non vedi l'output previsto, puoi provare a procedere nel seguente modo:

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

  gcloud tasks queues list \
      --location=LOCATION

  Per cercare in più posizioni, devi effettuare più richieste.

• Controlla di aver raggiunto la quota della coda:

  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 tre puntini > 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

• Configura le code di Cloud Tasks
• Riferimento API REST
• Riferimento API RPC
• Comandi gcloud di Cloud Tasks