Creare code di Cloud Tasks

Questa pagina descrive come creare code Cloud Tasks. Quando le attività vengono aggiunte a una coda, questa 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 disporre di un progetto Google Cloud che fornisca l'ID progetto.

• Se utilizzi attività target App Engine, devi disporre anche di un'applicazione App Engine collocata in una regione specifica 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, si chiamano rispettivamente europe-west1 e us-central1 nei comandi Cloud Tasks.

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

Crea 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 imposta esplicitamente il servizio di destinazione contenente il worker appropriato, viene utilizzato il servizio predefinito. Per ulteriori informazioni, consulta Configurare le code Cloud Tasks.

Console

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

   Vai a Code di attesa

2. Fai clic su Crea coda.

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

4. Nell'elenco Regione, seleziona una posizione 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 della coda sia in us-central1 che in us-central2 (anche se hai bisogno di una coda solo in una di queste regioni).

5. Facoltativamente, puoi anche configurare 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 fila, ad esempio my-queue.

• LOCATION: un'area geografica 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 della coda sia in us-central1 che in us-central2 (anche se hai bisogno di una coda solo in una di queste regioni).

Altri flag per il comando gcloud CLI ti consentono di configurare limiti di frequenza, opzioni di ripetizione, 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: un'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 assegnato alla coda, ad esempio my-queue.

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:

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 ti 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 il seguente 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 alla CLI 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 il seguente 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 Esplora 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 coda

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

• Nella console Google Cloud
• Utilizzando l'interfaccia a riga di comando gcloud 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 di coda.

   Vai a Code di attesa

   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 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 è dipiattata la 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 ti 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 alla CLI 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 Esplora API. Puoi interagire con questo strumento per inviare richieste. Compila 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'attivazione 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ù località, devi effettuare più richieste.

• Controlla se hai raggiunto la quota della coda:

  1. Nella console Google Cloud, 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, fai clic sull'icona dei tre puntini nella riga corrispondente > Modifica quota.

     Per ulteriori informazioni, consulta Richiedere un valore di quota più elevato.

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

Passaggi successivi

• Configurare le code di Cloud Tasks
• Riferimento API REST
• Riferimento all'API RPC
• Comandi gcloud di Cloud Tasks