如何防止 Jenkins 构建因 Shell 失败而终止？

2024-03-11 17:09:53

防止 Jenkins 在执行 Shell 失败时导致构建失败

在 Jenkins 构建管道中，执行 Shell 命令是司空见惯的做法。然而，当工作区中没有更改时，git commit 命令可能会返回错误代码，导致 Jenkins 构建失败。本文将深入探讨如何解决此问题，确保构建过程的稳定性。

问题：Jenkins 构建因 Shell 失败而终止

想象一下这样的场景：你在 Jenkins 中设置了一个构建作业，其中包括执行 git commit 命令的 Shell 步骤。当工作区中没有未提交的更改时，git commit 将返回非零错误代码。默认情况下，Jenkins 会将此解释为构建失败，导致构建终止。

解决方案：掌控构建失败

为了防止 Jenkins 在 Shell 失败时终止构建，我们可以采取多种策略：

使用 Jenkins Pipeline

Jenkins Pipeline 提供了一个强大的方式来控制构建流程。我们可以利用其 try 和 catch 块来处理 git commit 错误：

try {
    sh 'git commit -am "My commit message"'
} catch (err) {
    if (err.getMessage().contains('nothing to commit')) {
        echo 'No changes to commit. Aborting build.'
        error 'Build aborted due to no changes.'
    } else {
        echo 'Error committing changes. Marking build unstable.'
        unstable 'Build marked unstable due to error committing changes.'
    }
}

此脚本会尝试执行 git commit。如果返回了 "nothing to commit" 错误，脚本将中止构建。如果遇到其他错误，脚本会将构建标记为不稳定，而不是终止。

利用参数化构建

Jenkins 的参数化构建功能允许我们在构建开始时指定参数。我们可以使用此功能来传递一个布尔值，指示是否存在要提交的更改：

创建一个新的 Jenkins 作业，并启用参数化构建。
添加一个名为 "commit_changes" 的布尔参数。
在构建脚本中，根据 "commit_changes" 参数的值执行 git commit：

if (!params.commit_changes) {
    echo 'No changes to commit. Aborting build.'
    error 'Build aborted due to no changes.'
} else {
    sh 'git commit -am "My commit message"'
}

此方法可让你在构建启动时动态决定是否执行 git commit。

自定义 Shell 脚本

我们还可以编写一个自定义 Shell 脚本来检查 git 状态，并根据其输出采取相应措施：

#!/bin/bash

# 检查 git 状态
git status > /dev/null 2>&1

# 如果没有更改，中止构建
if [ $? -eq 0 ]; then
    echo 'No changes to commit. Aborting build.'
    exit 1
fi

# 提交更改
git commit -am "My commit message"