目录
然jekins中几乎每个应用程序都有对应的插件,同时每个函数都有流水线步骤,但有时你可能需要执行一些没 有相关步骤的操作。如果可以通过操作系统中的shel步骤成操作,则可使用流水线中的内置步骤来执行该操作。内置步骤为返回值提供了多个集成点,因此你可以在流水线中利用这些集成点来执行后续操作或决策点。
另一个集成点是环境: Jenkins运行的外部环境和脚本本地的继承环境。除了能够诙取和设置环境变量之外,Jenkins 还包含一个block步骤,允许块内的步骤使用隔离环境。工作空间也构成了流水线环境的一部分。 如果你要更密切地管理自定义工作空间,Jenkins也包含一些 与工作空间相关的步骤,值得我们了解一下。
最后,毫无疑问的是,你需要在项目中操纵文件或目录。该流水线包括一组有限的步骤,以允许最常见的文件和目录的操作。插件会极大地扩展这些操作。
我们将在本章中介绍所有这些内容,以便你全面地了解如何集成流水线和操作系统。
1、使用shell
1.1 sh步骤
script:要执行的操作,表现为字符串。这是默认参数。多行脚本三重引号括起来。
encoding:输出的编码,表示为字符串。默认UTF-8。
returnStdout(返回标注输出):返回一个布尔值,设置为false(默认值),打印到控制台。true,返回字符串。
returnStats:一个布尔值,如果为false(默认值),则非0状态码,导致步骤失败,抛出异常。为true,返回码将是步骤中的返回代码,你可以获取代码并检查,自后处理。
def listing = sh script : 'ls -la /', returnStdout: true 输出重定向到变量
1.2 set选项
jenkins的sh步骤中自动包含一个set -e:运行到某一行遇见错误时将使shell停止执行。set +e :执行脚本中的所有行。
自动包含一个set -x:在sh执行它时逐个显示被调的操作系统内置命令。set +e :关闭这个功能。
1.3 语言解释器
使用sh步骤时,第一行添加解释器,解释器指定语言执行程序。
node {
sh 'export NAME=Jenkins; echo Hello, $NAME from shell!'
sh '''#!/usr/bin/perl
my $name = "Jenkins";
print "Hello, $name from Perl!\n";'''
sh '''#!/usr/bin/python
name="Jenkins"
print('Hello {} from Python!'.format(name))'''
}
1.4 从共享库执行shell脚本
将shell脚本放在resource下面,可以执行shell脚本。脚本式流水线执行示例:
def myExternalScript = libraryResources 'externalCommands.sh'
sh myExternalScript
脚本式:sh "${libraryResource 'ws-get-latest.sh'}"
扩展:检查平台
if(isUnix()){
sh 'ls -latr'
}else{
bat "dir /o:d"
}
1.5 bat步骤 (类似改成 bat)
1.6 powershell步骤
2、使用环境变量
2.1、设置环境变量
//脚本式设置
env.USER = 'ken'
env.PATH = env.PATH + ':/home/aiuser2'
// 流水线设置方法
environment {
USER = 'ken'
PATH = '/home/aiuser2:$PATH'
}
2.2 withEnv 步骤
设置环境变量仅在下面的代码块里面有效。
withEnv(["PATH+GRADLE=${tool 'gradle3'}/bin", 'USER=Jenkins2']) {
sh 'echo PATH = $PATH'
}
取消设置的环境变量:env.<NAME> =
3、使用工作空间
3.1 创建自定义空间
ws将创建自己的工作空间,并尝试将其锁定,以供独占使用。可以是相对于节点的目录或绝对路径。如果,目录不存在则创建该目录。不关心锁定功能,可以使用dir切换正在执行的目录。
node {
print pwd()
ws ('myWorkspace') {
print pwd()
ws ('myWorkspace') {
print pwd()
}
}
}
3.2 清理工作空间
jenkins的工作空间不会自动删除。流水线提供了cleanWs步骤用于清除工作空间。默认情况下,无论构建结果如何,该步骤都会删除工作空间的所有文件。如果删除失败,则构建失败。
4、文件和目录步骤