Conditionally end a running job gracefully

Fernando

September 22, 2020 19:22

Sometimes during a build, you may want to end the job early without generating a failure.

You can end a job gracefully by running the command: circleci-agent step halt

You can combine this with if statements or when steps to control the lifecycle of the job conditionally.

run: |
    if [ "$CIRCLE_BRANCH" = "develop" ]; then
        circleci-agent step halt
    fi

- when:
    condition: false
    steps:
      - run:
          command: circleci-agent step halt

Was this article helpful?

23 out of 28 found this helpful

0 comments

Article is closed for comments.