Do manual build fail in Jenkins using shell script

Question

I would like to mark a Jenkins build to fail on one scenario for example:

if [ -f "$file" ]
then
    echo "$file found."
else
    echo "$file not found."
    #Do Jenkins Build Fail
fi

Is it possible via Shell Script?

Answer: If we exit with integer 1, Jenkins build will be marked as failed. So I replaced the comment with exit 1 to resolve this.

I posted my answer below before I saw the update. Glad you figured it out! — alk3ovation, Dec 30 '13 at 18:46

score 86 · Accepted Answer · answered Dec 30 '13 at 18:45

86

All you need to do is exit 1.

if [ -f "$file" ]
then
    echo "$file found."
else
    echo "$file not found."
    exit 1
fi

answered Dec 30 '13 at 18:45

alk3ovation

3

Could you add a link to the documentation that explains this? Thanks for the answer btw. – TyMayn Oct 30 '14 at 23:37
And it's possible set exit to another number for jenkins mark to another status type, i.e. unestable? – albertoiNET Mar 14 '17 at 13:17
1

@albertoiNET as far as I remember, any non-zero exit code will be interpreted by the shell as an error. However, the information is kept, so you can test which specific error code was returned. This is kind of the point of error codes in the first place. – Jonathan Benn Oct 05 '20 at 18:27

score 3 · Answer 2 · edited May 23 '17 at 11:47

3

To fail a Jenkins build from .NET, you can use Environment.Exit(1).

edited May 23 '17 at 11:47

Community

answered Oct 20 '14 at 17:18

Ben

score 2 · Answer 3 · edited May 23 '17 at 12:10

To fail a Jenkins build from Windows PowerShell, you can use Steve's tip for C# as follows:

$theReturnCode = 1
[System.Environment]::Exit( $theReturnCode )

Notes;

1.Windows recycles exit codes higher than 65535. ( https://stackoverflow.com/a/31881959/242110 )

2.The Jenkins REST API has a '/stop' command, but that will cancel the build instead of actually failing it. ( https://jenkinsapi.readthedocs.org/en/latest/build.html )

3.Jenkins can also mark a build 'unstable', and this post ( https://stackoverflow.com/a/8822743/242110 ) has details on that solution.

3 Answers3