Limiter la durée d'exécution des tâches et des exécutables à l'aide de délais avant expiration

Ce document explique comment limiter la durée d'exécution des tâches et des exécutables en définissant des délais avant expiration.

Un délai avant expiration spécifie la durée pendant laquelle une tâche ou un exécutable est autorisé à s'exécuter. Batch n'autorise pas l'exécution des tâches pendant plus de 14 jours et ne définit pas de délai avant expiration par défaut pour des tâches et des exécutables individuels. Par conséquent, une tâche individuelle ou un exécutable peuvent s'exécuter jusqu'à 14 jours avant l'échec automatique. Toutefois, si vos tâches et vos exécutables ne sont pas destinés à s'exécuter pendant une durée aussi longue, cette configuration peut entraîner des coûts et des retards imprévus. Pour éviter des temps d'exécution excessifs, vous pouvez définir des délais avant expiration pour les tâches et les exécutables.

Avant de commencer

Définir les délais avant expiration

Vous pouvez définir des délais avant expiration pour les exécutables, les tâches ou les deux. Le délai avant expiration d'un exécutable spécifie la durée d'exécution maximale de cet exécutable. Le délai avant expiration d'une tâche spécifie la durée d'exécution maximale de cette tâche, qui correspond à la somme de toutes les durées d'exécution individuelles de ses exécutables. Par exemple, si une tâche comporte trois exécutables qui s'exécutent tous en même temps pendant une minute, la durée d'exécution de la tâche est de trois minutes, et non d'une minute.

Si vous définissez des délais avant expiration qui se chevauchent, tels qu'un délai avant expiration pour un exécutable et une tâche de l'exécutable, un seul délai avant expiration doit être dépassé pour déclencher un échec automatique. Par exemple, supposons que vous définissiez le délai avant expiration d'une tâche sur 60 secondes et le délai d'expiration de chacun des exécutables de cette tâche sur 120 secondes. Ensuite, cet exemple de tâche et tous ses exécutables échouent lorsque la somme des durées d'exécution de ses exécutables dépasse 60 secondes et il est impossible de déclencher les délais avant expiration de 120 secondes.

Pour choisir le délai d'expiration approprié à définir pour les tâches et les exécutables de votre tâche, analysez les journaux des tâches similaires que vous avez précédemment exécutées afin de déterminer la durée d'exécution typique des tâches et des exécutables pour des charges de travail similaires.

Définir un délai d'inactivité pour une tâche

Utilisez Google Cloud CLI ou l'API REST pour créer une tâche incluant le champ maxRunDuration dans l'objet taskSpec du fichier JSON:

{
    "taskGroups": [
      {
        "taskSpec": {
          ...
          "maxRunDuration": "TIMEOUT"
        }
      }
    ]
}

Remplacez TIMEOUT par le nombre maximal de secondes ou de portions de sections pour lequel vous souhaitez autoriser l'exécution de la tâche. Exemple :255s

Une tâche qui définit un délai avant expiration de 255 secondes possède un fichier de configuration JSON semblable à celui-ci:

{
    "taskGroups": [
      {
        "taskSpec": {
          "runnables": [
            {
              "script": {
                "text": "echo Hello world! This is task ${BATCH_TASK_INDEX}. This job has a total of ${BATCH_TASK_COUNT} tasks."
              }
            }
          ],
          "maxRunDuration": "255s"
        },
        "taskCount": 3
      }
    ],
    "logsPolicy": {
        "destination": "CLOUD_LOGGING"
    }
}

Si le délai avant expiration d'une tâche est dépassé, celle-ci échoue automatiquement et le délai avant expiration dépassé est indiqué par le code de sortie 50005 dans les événements d'état et les journaux de la tâche. Pour en savoir plus sur les délais avant expiration dépassé, consultez la documentation de dépannage pour le code de sortie 50005.

Définir un délai d'inactivité pour un exécutable

Utilisez Google Cloud CLI ou l'API REST pour créer une tâche incluant le champ timeout dans l'objet runnable du fichier JSON:

{
    "taskGroups": [
      {
        "taskSpec": {
          "runnables": [
            {
              ...
              "timeout": "TIMEOUT"
            }
          ]
        }
      }
    ]
}

Remplacez TIMEOUT par le nombre maximal de secondes ou de sections fractionnaires pour lequel vous souhaitez autoriser l'exécution de l'exécutable. Exemple : 3.5s.

Une tâche qui définit un délai avant expiration de 3,5 secondes pour un exécutable comporte un fichier de configuration JSON semblable à celui-ci:

{
    "taskGroups": [
      {
        "taskSpec": {
          "runnables": [
            {
              "script": {
                "text": "echo Hello world! This is task ${BATCH_TASK_INDEX}. This job has a total of ${BATCH_TASK_COUNT} tasks."
              },
              "timeout": "3.5s"
            }
          ]
        },
        "taskCount": 3
      }
    ],
    "logsPolicy": {
        "destination": "CLOUD_LOGGING"
    }
}

Si le délai avant expiration d'un exécutable est dépassé, celui-ci échoue automatiquement et le délai avant expiration dépassé est indiqué par le code de sortie 50005 dans les événements d'état et les journaux de la tâche. Pour en savoir plus sur les délais avant expiration dépassé, consultez la documentation de dépannage pour le code de sortie 50005.

Étapes suivantes