Skip to main content

Troubleshooting

This page lists common issues with Jobs and possible solutions, workarounds or debugging tips.

My job has an error

If you see an error on your job on Operator, refer to this table to find out more:

Error nameLink
FAILED_PREPARATIONlink
RUNNER_DISPATCH_FAILEDlink
RUNNER_FAILEDlink
UPLOAD_FAILEDlink
NOT_ACCESSIBLElink

FAILED_PREPARATION

Failed preparation means that there was an internal issue. Retry the job. If you still have this issue after retrying, contact us.

RUNNER_DISPATCH_FAILED

MaaS refused to run the provided workflow. This generally happens if your workflow is invalid. Here are some examples of issues that can cause a RUNNER_DISPATCH_FAILED error:

  • Excessive or incoherent RAM/CPU requests. See this section for more details.

  • Invalid timeout values

  • Invalid file paths, invalid image, invalid mount syntax

  • Using both command and commands at the same time.

  • Empty workflow (no stages)

  • Empty stage (no task in stage)

  • Dangerous file mounting behavior

    • Specifically, within the same stage, trying to mount a and a/b in separate tasks. There is a possible attack where a student may try to switch in their own b at just the right time.
  • Invalid JSON when using a WORKFLOW document to import the workflow (syntax error or incorrect structure).

  • Tried to reference an image that is not allowed in the tenant.

RUNNER_FAILED

This means that the runner has failed during the execution of the workflow. This can happen because:

  • The runner tried to pull a Docker image that does not exist

    • Try pulling your images yourself using docker pull
  • The pipeline timed out

  • A nonzero return code was returned by a task where interruptOnFailure is true

In all cases, you should check the logs of the MaaS pipeline.

UPLOAD_FAILED

Your upload may fail if

  • your XML is incorrect (invalid syntax, invalid unescaped special characters like \0)

  • the intranet messed up temporarily. As with FAILED_PREPARATION, retry the job and, if the problem still appears, contact us.

NOT_ACCESSIBLE

This means that you have not yet unlocked the submission on which you are trying to submit. This can happen because:

  • The graph has changed between the push and the execution of the workflow.
  • You are the manager of your project, and you submit a submission without having submitted the previous ones (as a manager, you have read access to the entire graph).