Ce document explique comment créer et exécuter un job par lot installe automatiquement l'agent Ops. Installez l'agent Ops pour fournir des métriques supplémentaires dans Cloud Monitoring sur les performances ressources. Pour en savoir plus sur l'utilisation des métriques de performances des ressources pour un emploi, consultez Surveillez et optimisez les ressources de tâches en affichant les métriques.
Avant de commencer
- Si vous n'avez jamais utilisé Batch auparavant, consultez Premiers pas avec Batch et activez Batch en suivant la les conditions préalables pour les projets et les utilisateurs.
- Si votre projet ne l'a pas déjà fait, activez les API Cloud Monitoring et Cloud Logging:
-
Pour obtenir les autorisations nécessaires à la création d'un job, demandez à votre administrateur de vous accorder le rôles IAM suivants:
-
Pour créer une tâche:
<ph type="x-smartling-placeholder">
- </ph>
-
Éditeur de jobs par lot (
roles/batch.jobsEditor
) sur le projet -
Utilisateur du compte de service (
roles/iam.serviceAccountUser
) sur le compte de service du job, qui est par défaut le compte de service Compute Engine par défaut
-
Éditeur de jobs par lot (
-
Pour afficher les journaux:
Lecteur de journaux (
roles/logging.viewer
) sur le projet
Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.
Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.
-
Pour créer une tâche:
<ph type="x-smartling-placeholder">
À moins que vous n'utilisiez la configuration par défaut le compte de service de la tâche ; s'assure qu'il dispose des autorisations nécessaires.
Pour s'assurer que le compte de service du job dispose des autorisations les autorisations requises pour écrire des métriques de l'agent Ops dans Monitoring ; demandez à votre administrateur d'accorder au compte de service du job rôles IAM suivants:
-
Rédacteur de métriques de surveillance (
roles/monitoring.metricWriter
) sur le projet -
Rédacteur de journaux (
roles/logging.logWriter
) sur le projet
-
Rédacteur de métriques de surveillance (
- Assurez-vous que la configuration de votre job planifié respecte les Conditions requises pour l'Agent Ops
Conditions requises pour l'Agent Ops
Pour que vous puissiez créer et exécuter un job qui utilise l'agent Ops, celui-ci doit respecter les toutes les exigences suivantes:
Assurez-vous que les VM du job utilisent un système d'exploitation (OS) compatible avec l'agent Ops. Pour en savoir plus sur l'image d'OS de VM utilisée pour un job, consultez la page Présentation de l'environnement de système d'exploitation pour les VM d'un job
Si votre job utilise une configuration réseau autre que celle par défaut ou utilise VPC Service Controls, vérifiez que le job respecte les conditions d'accès pour l'agent Ops. Pour en savoir plus, consultez VM sans accès au package distant dans la documentation Google Cloud Observability.
Assurez-vous que le job n'installe pas d'ancien agent Cloud Logging un agent Cloud Monitoring, par exemple via une image personnalisée ou d'instance unique.
Pour en savoir plus sur les fonctionnalités et les exigences de l'agent Ops, consultez la page Présentation de l'agent Ops. dans la documentation Google Cloud Observability.
Créer un job qui installe automatiquement l'agent Ops
Utiliser la Google Cloud CLI ou l'API REST pour
créer une tâche qui
inclut les
Champ installOpsAgent
défini sur true
dans le champ allocationPolicy.instances
du corps principal de la
Fichier JSON:
"allocationPolicy": {
"instances": [
{
"installOpsAgent": true
}
]
}
Par exemple, un job qui installe automatiquement l'agent Ops peut avoir un fichier JSON de configuration Terraform semblable à celui-ci:
{
"taskGroups": [
{
"taskSpec": {
"runnables": [
{
"script": {
"text": "echo Hello World! This is task $BATCH_TASK_INDEX."
}
}
]
},
"taskCount": 3,
}
],
"allocationPolicy": {
"instances": [
{
"installOpsAgent": true
}
]
},
"logsPolicy": {
"destination": "CLOUD_LOGGING"
}
}
Une fois que les VM du job commencent à s'exécuter, les métriques de l'agent Ops s'affichent de la même manière que toute autre métrique liée aux ressources. Pour en savoir plus, consultez Surveillez et optimisez les ressources de tâches en affichant les métriques.
Étape suivante
- Si vous rencontrez des problèmes pour créer ou exécuter un job, consultez Dépannage
- Afficher les missions et les tâches
- En savoir plus options de création de tâche.