Concevoir et créer un job Node.js dans Cloud Run
Avant de commencer
- Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
Recherchez le compte de service Compute Engine par défaut. Par défaut, le compte de service Compute Engine par défaut est créé automatiquement et suit le format d'adresse e-mail suivant :
PROJECT_NUMBER-compute@developer.gserviceaccount.com
Remplacez
PROJECT_NUMBER
par votre numéro de projet Google Cloud. Vous pouvez trouver le numéro de votre projet sur la page Bienvenue de la console Google Cloud ou en exécutant la commande suivante :gcloud projects describe PROJECT_ID --format='value(projectNumber)'
Pour les environnements de production, nous vous recommandons vivement de créer un compte de service et de lui attribuer un ou plusieurs rôles IAM contenant les autorisations minimales requises conformément au principe du moindre privilège.
- Pour que Cloud Build puisse créer vos sources, attribuez le rôle Compte de service Cloud Build au compte de service Compute Engine par défaut en exécutant la commande suivante :
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=serviceAccount:PROJECT_NUMBER-compute@developer.gserviceaccount.com \ --role=roles/cloudbuild.builds.builder
Écrire l'exemple de tâche
Pour écrire une tâche dans Node.js, procédez comme suit :
Créez un répertoire nommé
jobs
et modifiez les sous-répertoires comme suit :mkdir jobs cd jobs
Créez un fichier
package.json
avec le contenu suivant :Dans le même répertoire, créez un fichier
index.js
pour le code de la tâche réelle. Copiez les exemples de lignes suivants :Les jobs Cloud Run permettent aux utilisateurs de spécifier le nombre de tâches que le job doit exécuter. Cet exemple de code montre comment utiliser la variable d'environnement
CLOUD_RUN_TASK_INDEX
intégrée. Chaque tâche correspond à une copie en cours d'exécution du conteneur. Notez que les tâches sont généralement exécutées en parallèle. L'utilisation de plusieurs tâches est pertinente si chacune d'elles peut traiter indépendamment un sous-ensemble de vos données.Chaque tâche connaît son index, stocké dans la variable d'environnement
CLOUD_RUN_TASK_INDEX
. La variable d'environnementCLOUD_RUN_TASK_COUNT
intégrée contient le nombre de tâches fournies au moment de l'exécution du job via le paramètre--tasks
.Le code présenté montre également comment relancer des tâches à l'aide de la variable d'environnement intégrée
CLOUD_RUN_TASK_ATTEMPT
, qui contient le nombre de tentatives d'exécution de cette tâche, commençant à 0 pour la première tentative et incrémentée de 1 pour chaque nouvelle tentative, jusqu'à--max-retries
.Le code vous permet également de générer des échecs afin de tester la répétition des tentatives et de générer des journaux d'erreurs afin que vous puissiez voir à quoi ils ressemblent.
Créez un fichier
Procfile
avec le contenu suivant :
Votre code est terminé et prêt à être empaqueté dans un conteneur.
Créer un conteneur de jobs, l'envoyer à Artifact Registry et le déployer dans Cloud Run
Important : Dans ce guide de démarrage rapide, nous partons du principe que vous disposez de rôles de propriétaire ou d'éditeur dans le projet que vous utilisez pour les besoins du guide de démarrage rapide. Sinon, reportez-vous au rôle Développeur source Cloud Run afin de connaître les autorisations requises pour déployer une ressource Cloud Run depuis la source.
Ce guide de démarrage rapide utilise un déploiement à partir d'une source pour créer le conteneur, l'importer dans Artifact Registry et déployer le job dans Cloud Run :
gcloud run jobs deploy job-quickstart \ --source . \ --tasks 50 \ --set-env-vars SLEEP_MS=10000 \ --set-env-vars FAIL_RATE=0.1 \ --max-retries 5 \ --region REGION \ --project=PROJECT_ID
où PROJECT_ID correspond à votre ID de projet et REGION à votre région, par exemple us-central1
. Notez que vous pouvez remplacer les différents paramètres par les valeurs que vous souhaitez utiliser à des fins de test.
SLEEP_MS
simule le travail et FAIL_RATE
entraîne l'échec de X
% des tâches afin que vous puissiez tester le parallélisme et réessayer les tâches ayant échoué.
Exécuter un job dans Cloud Run
Pour exécuter le job que vous venez de créer, procédez comme suit :
gcloud run jobs execute job-quickstart --region REGION
Remplacez REGION par la région que vous avez utilisée lors de la création et du déploiement du job (par exemple, us-central1
).
Étapes suivantes
Pour savoir comment créer un conteneur à partir d'une source de code et le transférer vers un dépôt, consultez la section suivante :