Jenkins構建後執行腳本的全面指南

一、執行腳本的基礎

在了解如何在Jenkins構建後執行腳本之前，需要先了解如何執行腳本。在Unix或Linux命令行中，可以通過在終端中輸入腳本路徑並按下「Enter」來運行腳本。但是，在Jenkins中，我們需要使用插件和特定的配置來執行腳本。

一種簡單的方法是在Jenkins的構建配置頁面中添加一個「Execute shell」步驟。這個步驟允許我們在構建完成後執行任意的Shell命令或腳本。

#! /bin/bash
echo "Hello World"

每次構建該項目時，Jenkins會自動運行上面的腳本，每次輸出「Hello World」。

二、使用Jenkins構建後執行腳本插件

如果需要執行的腳本需要在每個構建之後都運行，那麼手動添加「Execute shell」步驟就不太可行了。這時候，我們可以使用Jenkins 「Post-build Script」 插件。

在Jenkins插件管理中搜索「Post-build Script」插件並安裝它。然後，打開構建配置頁面，選擇「Add post-build action」並選擇「Post-build Script」。

在插件的「Script」文本框中輸入需要執行的腳本。例如：

#! /bin/bash
echo "This is a script that runs after the build"

當構建結束時，該腳本將會自動運行。

三、使用Jenkins Pipeline執行腳本

Jenkins Pipeline是一種強大的工具，可用於在Jenkins中定義和管理複雜的構建流程，並允許在Jenkins運行期間編寫和執行腳本。在Jenkins Pipeline中，可以輕鬆地執行構建後的腳本。

首先，創建一個Jenkinsfile並添加以下內容：

pipeline {
    agent any
    stages {
        stage('Build') {
            steps {
                // steps to build the project
            }
        }
    }
    post {
        always {
            sh '''
              echo "This is a script that runs after the build"
            '''
        }
    }
}

在以上示例中，「post」段定義了需要在構建結束之後運行的腳本。「always」段表示無論構建是否成功，都會運行這個腳本。然後，執行一個Shell腳本，輸出文本「這是一個在構建之後運行的腳本」。

四、使用腳本來執行腳本

如果需要前一個構建的輸出作為後一個構建的輸入，那麼可以使用Jenkins的「Copy Artifact」插件。使用它可以下載之前構建的輸出中的某些文件。

然後，將它們拷貝到當前構建的工作區，並執行一些有用的操作，如測試或分析。下面演示一個腳本，它會使用「Copy Artifact」插件下載之前構建的WAR文件，然後將構建後的WAR文件複製到Tomcat的webapps目錄中，最後重啟Tomcat。

#!/bin/bash
# Download previous build's WAR file
JAR_NAME="$(ssh jenkins@build curl http://jenkins/builds/job/My_Job/$BUILD_NUMBER/artifact/*.war)"
wget --no-verbose "${JAR_NAME}" -O app.war

# Stop Tomcat
sudo /etc/init.d/tomcat7 stop

# Deploy the new WAR file
sudo cp app.war /var/lib/tomcat7/webapps/

# Restart Tomcat
sudo /etc/init.d/tomcat7 start

五、用shell腳本和Jenkins API來執行腳本

Jenkins提供了一組API，可以輕鬆地在腳本中與Jenkins進行交互。例如，「build job」API可以用來啟動其他Jenkins作業。這在需要構建依賴於其他作業輸出的複雜項目中非常有用。

例如，下面是一個腳本，它在構建完成後將WAR文件上傳到Amazon S3，然後啟動發佈工作流程。使用Jenkins API，它會下載上一個構建的WAR文件並將其同步到Amazon S3中。

#!/bin/bash
# Download previous build's WAR file
JAR_NAME="$(ssh jenkins@build curl http://jenkins/builds/job/My_Job/$BUILD_NUMBER/artifact/*.war)"
wget --no-verbose "${JAR_NAME}" -O app.war

# Copy WAR file to Amazon S3 bucket
aws s3 cp app.war s3://my-s3-bucket/

# Start a "publish" job
JOB_NAME='publish_job'
BUILD_RESULT="$(curl -X POST -q "http://jenkins/job/${JOB_NAME}/buildWithParameters?Version=${VERSION}")"
echo "Build result: ${BUILD_RESULT}"

六、小結

以上是使用Jenkins進行構建後執行腳本的幾種方法。在實踐中，可以根據特定項目的需要使用適當的方法。不管使用哪種方法，確保腳本可以成功獲取必要的輸入，執行所需的操作並正確地處理錯誤是非常重要的。