Créer des files d'attente Cloud Tasks

Cette page explique comment créer des files d'attente Cloud Tasks. Lorsque des tâches sont ajoutées à une file d'attente, celle-ci les envoie et s'assure qu'elles sont traitées de manière fiable par un service, également appelé nœud de calcul.

Veuillez noter les points suivants :

Les noms de files d'attente comportent trois parties : un ID de projet, un emplacement et un ID de file d'attente. Vous devez disposer d'un Google Cloud projet qui fournit l'ID de projet.
Si vous utilisez des tâches cibles App Engine, vous devez également disposer d'une application App Engine située dans une région spécifique et dans laquelle votre file d'attente et vos gestionnaires s'exécutent. Notez la région lorsque vous ajoutez l'application.

Remarque : Sachez que deux emplacements, appelés europe-west et us-central dans les commandes App Engine, sont appelés respectivement europe-west1 et us-central1 dans les commandes Cloud Tasks.
L'utilisation de tâches cibles HTTP ne nécessite pas d'application App Engine. Vous sélectionnez un Google Cloud emplacement lorsque vous créez votre file d'attente.

Créer une file d'attente

Vous pouvez créer une file d'attente de différentes manières :

Dans la Google Cloud console
À l'aide de Google Cloud CLI dans votre terminal ou Cloud Shell
En envoyant une requête directe à l'API Cloud Tasks

Console

Dans la Google Cloud console, accédez à la page Cloud Tasks > Queues (Files d'attente).

Accéder aux files d'attente
Cliquez sur Create queue (Créer une file d'attente).
Saisissez un Queue name (Nom de file d'attente), par exemple my-queue.
Dans la liste Region (Région), sélectionnez un emplacement compatible dans lequel la file d'attente s'exécutera, par exemple asia-south1.

Si votre organisation limite l'emplacement des ressources et que vous souhaitez créer votre file d'attente dans us-central1 ou us-central2, la règle d'administration doit autoriser la création de files d'attente dans us-central1 et us-central2 (même si vous n'avez besoin d'une file d'attente que dans l'une de ces régions).
Vous pouvez également configurer votre file d'attente .
Cliquez sur Create (Créer).

gcloud

Utilisez la gcloud tasks queues create commande pour créer votre file d'attente :

  gcloud tasks queues create QUEUE_ID \
      --location=LOCATION

Remplacez les éléments suivants :

QUEUE_ID: identifiant que vous attribuez à votre file d'attente, par exemple my-queue.
LOCATION : région compatible dans laquelle la file d'attente s'exécutera, par exemple asia-south1.

Si votre organisation limite l'emplacement des ressources et que vous souhaitez créer votre file d'attente dans us-central1 ou us-central2, la règle d'administration doit autoriser la création de files d'attente dans us-central1 et us-central2 (même si vous n'avez besoin d'une file d'attente que dans l'une de ces régions).

D'autres options de la commande gcloud CLI vous permettent de configurer les limites de débit, les options de nouvelle tentative, les types de files d'attente, etc.

API REST

Pour créer une file d'attente, utilisez la projects.locations.queues.create méthode.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

PROJECT_ID: ID de votre Google Cloud projet.
LOCATION : région compatible dans laquelle la file d'attente s'exécutera, par exemple asia-south1.
Si votre organisation limite l'emplacement des ressources et que vous souhaitez créer votre file d'attente dans us-central1 ou us-central2, la règle d'administration doit autoriser la création de files d'attente dans us-central1 et us-central2 (même si vous n'avez besoin d'une file d'attente que dans l'une de ces régions).
QUEUE_ID : identifiant que vous attribuez à votre file d'attente, par exemple my-queue.

D'autres propriétés configurables pour la Queue ressource incluent les limites de débit, les options de nouvelle tentative, les types de files d'attente, etc.

Corps JSON de la requête :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json. Exécutez la commande suivante dans le terminal pour créer ou écraser ce fichier dans le répertoire actuel :

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

Exécutez ensuite la commande suivante pour envoyer votre requête 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)

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json. Exécutez la commande suivante dans le terminal pour créer ou écraser ce fichier dans le répertoire actuel :

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

Exécutez ensuite la commande suivante pour envoyer votre requête 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

APIs Explorer (navigateur)

Copiez le corps de la requête et ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Collez le corps de la requête dans cet outil, renseignez tous les champs obligatoires, puis cliquez sur Execute (Exécuter).

Si la requête aboutit, le corps de la réponse contient une nouvelle instance de 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"
}

Quelques minutes peuvent être nécessaires pour qu'une file d'attente nouvellement créée soit disponible.

Décrire votre file d'attente

Vous pouvez vérifier que votre file d'attente a été créée de différentes manières :

Dans la Google Cloud console
À l'aide de gcloud CLI dans votre terminal ou Cloud Shell
En envoyant une requête directe à l'API Cloud Tasks

Console

Dans la Google Cloud console, accédez à la page Cloud Tasks > Queues (Files d'attente).

Accéder aux files d'attente

Une coche verte doit indiquer que votre file d'attente est en cours d'exécution.
Pour en savoir plus, cliquez sur le nom de la file d'attente, puis sur l'onglet Configuration.

gcloud

Utilisez la gcloud tasks queues describe commande pour vérifier que votre file d'attente a été créée :

gcloud tasks queues describe QUEUE_ID \
    --location=LOCATION

Remplacez les éléments suivants :

QUEUE_ID : ID de la file d'attente (son nom court)
LOCATION : emplacement de la file d'attente

La sortie devrait ressembler à ce qui suit :

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

Pour récupérer une file d'attente, utilisez la projects.locations.queues.get méthode.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

PROJECT_ID: ID de votre Google Cloud projet.
LOCATION : région dans laquelle la file d'attente est déployée, par exemple us-central1.
QUEUE_ID : ID court de la file d'attente, par exemple my-queue.

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Exécutez la commande suivante :

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)

Exécutez la commande suivante :

$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

APIs Explorer (navigateur)

Ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Renseignez tous les champs obligatoires, puis cliquez sur Execute (Exécuter).

Si la requête aboutit, le corps de la réponse contient une instance de 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"
}

Résoudre les problèmes liés à la création d'une file d'attente

Si le résultat attendu ne s'affiche pas, vous pouvez essayer ce qui suit :

Attendez au moins une minute pour que la file d'attente s'initialise.
Assurez-vous qu'une file d'attente avec le même ID n'existe pas déjà. Vous pouvez afficher les files d'attente de votre projet à l'aide de la gcloud tasks queues list commande :
```
gcloud tasks queues list \
    --location=LOCATION
```
Pour effectuer une recherche dans plusieurs emplacements, vous devez envoyer plusieurs requêtes.
Vérifiez si vous avez atteint votre quota de files d'attente quota :
1. Dans la Google Cloud console, accédez à la page API/Service Details (Détails de l'API/du service) pour l'API Cloud Tasks.
  
  Accéder aux détails de l'API/du service
2. Cliquez sur l'onglet Quotas &System limits (Quotas et limites du système).
3. Pour augmenter un quota, dans la ligne correspondant au quota, cliquez sur l'icône en forme de points de suspension > Edit quota (Modifier le quota).
  
  Pour en savoir plus, consultez Demander un ajustement de quota.
Exécutez à nouveau les commandes pour créer votre file d'attente et assurez-vous que chaque étape est correctement effectuée.

Créer des files d'attente Cloud Tasks Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Créer une file d'attente

Console

gcloud

API REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

APIs Explorer (navigateur)

Décrire votre file d'attente

Console

gcloud

API REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

APIs Explorer (navigateur)

Résoudre les problèmes liés à la création d'une file d'attente

Étape suivante

Créer des files d'attente Cloud Tasks