jenkins 內置變量

Jenkins 有一些內置的變量能夠使用。主要是：

• 郵件的配置變量，能夠在發送郵件的時候使用。
• 環境變量

1. 郵件的配置變量

• ${GIT_BRANCH} - build 的 Git 分支
• ${FILE,path="xxx"} - xxx 爲指定的文件，文件內容能夠在郵件中顯示。注意：xxx 是工做區目錄的相對路徑，不是絕對路徑。
• ${JOB_DESCRIPTION} - 顯示項目描述。
• ${BUILD_NUMBER} - 顯示當前構建的編號。
• ${SVN_REVISION} - 顯示 svn 版本號。還支持 Subversion 插件出口的 SVN_REVISION_n 版本。
• ${CAUSE} - 顯示誰、經過什麼渠道觸發此次構建。
• ${CHANGES } - 顯示上一次構建以後的變化。 
• ${BUILD_ID} - 顯示當前構建生成的ID。
• ${PROJECT_NAME} - 顯示項目的全名。
• ${PROJECT_DISPLAY_NAME} - 顯示項目的顯示名稱。
• $ {SCRIPT} - 從一個腳本生成自定義消息內容。自定義腳本應該放在 "$JENKINS_HOME/email-templates"。當使用自定義腳本時會默認搜索 $JENKINS_HOME/email-templatesdirectory 目錄。其餘的目錄將不會被搜索。 
• ${JENKINS_URL} - 顯示 Jenkins 服務器的 url 地址（能夠在系統配置頁更改）。
• ${BUILD_LOG_MULTILINE_REGEX} - 按正則表達式匹配並顯示構建日誌。
• ${BUILD_LOG} - 顯示最終構建日誌。
• ${PROJECT_URL} - 顯示項目的URL地址。
• ${BUILD_STATUS} - 顯示當前構建的狀態(失敗、成功等等)。
• ${BUILD_URL} - 顯示當前構建的URL地址。
• ${CHANGES_SINCE_LAST_SUCCESS} - 顯示上一次成功構建以後的變化。
• ${CHANGES_SINCE_LAST_UNSTABLE} - 顯示顯示上一次不穩固或者成功的構建以後的變化。
• ${ENV} - 顯示一個環境變量。
• ${FAILED_TESTS} - 若是有失敗的測試，顯示這些失敗的單元測試信息。
• ${PROJECT_URL} - 顯示項目的 URL。
• $ {JELLY_SCRIPT} - 從一個Jelly腳本模板中自定義消息內容。有兩種模板可供配置：HTML和TEXT。你能夠在 $JENKINS_HOME/email-templates 下自定義替換它。當使用自動義模板時，」template」參數的名稱不包含「.jelly」。
• ${TEST_COUNTS} - 顯示測試的數量。

2. 環境變量

BRANCH_NAME

對於多分支項目，這將被設置爲正在構建的分支的名稱，例如，若是您但願從而master不是從特徵分支部署到生產。

CHANGE_ID

對於與某種更改請求相對應的多分支項目，這將被設置爲更改ID，例如拉取請求號。

CHANGE_URL

對於與某種更改請求相對應的多分支項目，這將被設置爲更改URL。

CHANGE_TITLE

對於對應於某種變動請求的多分支項目，這將被設置爲更改的標題。

CHANGE_AUTHOR

對於對應於某種變動請求的多分支項目，這將被設置爲擬議更改的做者的用戶名。

CHANGE_AUTHOR_DISPLAY_NAME

對於對應於某種變動請求的多分支項目，這將被設置爲做者的人名。

CHANGE_AUTHOR_EMAIL

對於對應於某種變動請求的多分支項目，這將被設置爲做者的電子郵件地址。

CHANGE_TARGET

對於對應於某種變動請求的多分支項目，這將被設置爲能夠合併更改的目標或基本分支。

BUILD_NUMBER

目前的編號，如「153」

BUILD_ID

當前版本ID，與BUILD_NUMBER相同，用於在1.597+中創​​建的構建，但較舊版本的YYYY-MM-DD_hh-mm-ss時間戳記

BUILD_DISPLAY_NAME

當前版本的顯示名稱，默認爲「＃153」。

JOB_NAME

此構建項目的名稱，如「foo」或「foo / bar」。

JOB_BASE_NAME

此創建項目的名稱將剝離文件夾路徑，例如「bar / foo」的「foo」。

BUILD_TAG

「jenkins- $ {JOB_NAME} - $ {BUILD_NUMBER} 」的字符串。JOB_NAME中的全部正斜槓（/）都會用破折號（ - ）替換。方便放入資源文件，jar文件等，以方便識別。

EXECUTOR_NUMBER

識別執行此構建的當前執行程序（在同一臺計算機的執行程序中）的惟一編號。這是您在「構建執行者狀態」中看到的數字，但數字從0開始，而不是1。

NODE_NAME

代理的名稱，若是構建是代理，或者「主」，若是在主機上運行

NODE_LABELS

空格分隔的節點分配的標籤列表。

WORKSPACE

分配給構建做爲工做區的目錄的絕對路徑。

JENKINS_HOME

Jenkins主節點上分配的目錄絕對路徑存儲數據。

JENKINS_URL

完整的Jenkins網址，例如http：// server：port / jenkins /（注意：只有在系統配置中設置了Jenkins URL）

BUILD_URL

此構建的完整URL，如http：// server：port / jenkins / job / foo / 15 /（Jenkins URL必須設置）

JOB_URL

此做業的完整URL，如http：// server：port / jenkins / job / foo /（必須設置Jenkins URL）

SVN_REVISION

Subversion版本號，當前已被檢出到工做區，如「12345」

SVN_URL

當前已經檢出到工做空間的Subversion URL。