Jenkins建立項目各參數記錄

時間 2019-11-09

標籤 jenkins 建立項目參數記錄欄目自動化構建简体版

原文原文鏈接

視圖

進入視圖下面建立job

Jenkins權限控制插件Role-based Authorization Strategy

#Jenkins自帶的Jenkins權限控制不夠靈活。Role-based Authorization Strategy使用基於角色的策略啓用用戶受權。能夠全局定義角色，也能夠爲正則表達式選擇的特定做業或節點定義角色。html

#插件安裝完畢後以下圖選擇新的受權策略。
java

#開啓受權策略後，能夠在系統管理看到Manage and Assign Roles菜單。
git

Manage Roles設置：

Global roles設置：

Project roles設置：
github

Assign Roles設置：

Global roles設置：

Item roles設置：
web

測試：

查看test用戶有權限的job：

查看java01用戶有權限的job

#這樣能夠把一些項目區別開來，開發人員互不干涉正則表達式

job上面的信息介紹

General：

描述：shell

GitHub project：

#git代碼的地址不在這裏添加就在下面源碼管理的地方，固然這個就是藉助jenkins去下拉代碼而後進行maven構建等操做。#這個須要插件：GitHub（固然關聯的那個git插件都會一併安裝若是用jenkins插件安裝的話）服務器

Throttle builds

通常不勾選也就是不限制Build次數maven

Number of builds 構建數   #在指定時間段內容許的最大構建數。
Time period  #容許用戶觸發的構建跳過速率限制，單位有時、天、周、月、年。

丟棄舊的構建：

參數化構建過程：

關閉構建：

#這個就至關於禁用這個build，由於一些其餘依賴緣由不能發佈可是你又不能刪因此就能夠在這裏點擊關閉構建，可是通常再也不這裏關閉構件.ide

源碼管理:

#若是是用Jenkins拉取代碼的方式的

構建觸發器

觸發遠程構建

#若是要經過訪問特殊的預約義URL（方便腳本）來觸發新構建，請啓用此選項。此功能的一個典型示例是從源控件系統的鉤子腳本觸發新構建，當某人剛剛將更改提交到存儲庫時，或者從解析源控件電子郵件通知的腳本中觸發。
須要以字符串的形式提供受權令牌，以便只有知道它的人才能遠程觸發此項目的構建。

Build when a change is pushed to GitLab. GitLab webhook URL:

配置GitLab以向Jenkins實例（如GitLab CI）發送POST請求。

#Enabled GitLab triggers(啓用GitLab觸發器)
Push Events   #推送事件默認是勾選的
Opened Merge Request Events   #打開合併請求事件
Accepted Merge Request Events  #接受合併請求事件
Closed Merge Request Events    #關閉合並請求事件
Rebuild open Merge Requests   #重建打開的合併請求（Never,On push to source branch在推送源分支，On push to source or target branch在推送到源或目標分支）
Approved Merge Requests (EE-only)  #批准的合併請求（僅限EE）
Comments      #註釋
Comment (regex) for triggering a build   #用於觸發構建的註釋（正則表達式）填充後，與該正則表達式匹配的合併請求中的註釋將觸發構建。

GitHub hook trigger for GITScm polling（用於GITScm輪詢的GitHub鉤子觸發器）：

#若是Jenkins將從Git SCM部分中定義的repo接收PUSH GitHub掛鉤，它將觸發Git SCM輪詢邏輯。所以，輪詢邏輯實際上屬於Git SCM。

其餘工程構建後觸發：

#設置觸發器，以便在其餘一些項目完成構建時，爲該項目安排新的構建。例如，這對於在構建完成後運行大量測試很方便。
#此配置補充了上游項目的「構建後操做」中的「構建其餘項目」部分，但在要配置下游項目時更可取。

關注的項目：  #在輸入框輸入依賴於哪一個項目就行
只有構建穩定時觸發、即便構建不穩定時也會觸發、即便構建失敗時也會觸發

定時構建

#提供相似cron的功能以按期執行此項目。此功能主要用於將Jenkins用做cron替換，而且它不是連續構建軟件項目的理想選擇。當人們第一次開始持續集成時，他們經常習慣於按期安排的構建，例如每晚/每週使用此功能。可是，持續集成的目的是在更改後當即開始構建，以便爲更改提供快速反饋。爲此，您須要將SCM更改通知鏈接到Jenkins。所以，在使用此功能以前，請停下來問本身這是否真的是您想要的。

日程表：
該字段遵循cron的語法（略有不一樣）。具體來講，每行包含由TAB或空格分隔的5個字段：
MINUTE HOUR DOM MONTH DOW
MINUTE  Minutes within the hour (0–59)
HOUR    The hour of the day (0–23)
DOM The day of the month (1–31)
MONTH   The month (1–12)
DOW The day of the week (0–7) where 0 and 7 are Sunday.
以＃開頭的空行和行將被忽略爲註釋。
此外，還支持@yearly，@ annually，@ monthly，@ weekly，@ daily，@ midnight和@hourly做爲方便的別名。這些使用哈希系統進行自動平衡。例如，@ hourly與H * * * *相同，可能意味着在一小時內的任什麼時候間。 
@midnight實際上意味着在凌晨12:00到凌晨2:59之間的某個時間。
例子：
H/15 * * * *     ＃每十五分鐘一次（也許在：07：，22，：37，：52）
H(0-29)/10 * * * *   ＃每小時上半場每十分鐘一次（三次，也許在:04，:14，:24）
45 9-16 / 2 * * 1-5   ＃每小時一次，每小時45分鐘，從上午9:45開始，每一個工做日的下午3:45結束。
H H（9-16）/ 2 * * 1-5  ＃每一個工做日上午9點到下午5點每兩個小時一次（多是上午10點38分，下午12點38分，下午2點38分，下午4點38分）
H H 1,15 1-11 *   #每個月1日和15日天天一次，12月除外

構建環境：

Delete workspace before build starts（構建開始前刪除工做區）：

字面意思很清楚了每次構建以前會把這個job所在的工做區目錄裏面的東西清空掉再進行構建 #須要插件：Workspace Cleanup

Use secret text(s) or file(s)：

容許獲取各類類型的憑據，並從shell構建步驟等中使用它們。每一個綁定都將定義一個環境變量。 #須要插件：Credentials Binding

Abort the build if it's stuck（若是它被卡住，則停止構建）

#須要插件：Build-timeout

Time-out strategy （選擇如下策略之一：）：
    Absolute  #根據固定的超時停止構建。
    Deadline  #根據HH：MM：SS或HH：MM（24小時時間格式）中指定的截止時間停止構建
    Elastic   #定義在殺死構建以前等待的時間，做爲最後n次成功構建的持續時間的平均值的百分比。
    Likely stuck  #看成業比之前的運行時間長許屢次時，停止構建。
    No Activity   #自上第二天志輸出以來指定的秒數超時。
Time-out variable（超時變量）：設置構建超時環境變量
Time-out actions：超時發生時執行的操做。 若是沒有指定，將使用「停止構建」。

Add timestamps to the Console Output（將時間戳添加到控制檯輸出）

#須要插件：timestamps

Color ANSI Console Output（顏色ANSI控制檯輸出）：

ANSI color map：存在多個選項，默認狀況下，選擇xterm便可。#須要插件：AnsiColor

Set Build Name（設置構建名稱）：

Build Name：一般，構建以其序列號命名，但您能夠經過設置新構建的名稱來更改它。該字段能夠包含如下宏： #須要插件：Build Name and Description Setter

${FAILED_TESTS}  #若是任何測試失敗，則顯示失敗的單元測試信息。
    showStack   #在失敗的測試輸出中顯示堆棧跟蹤。默認爲true。
    showMessage  #在測試輸出失敗時顯示錯誤消息。默認爲true。
    maxTests    #最多顯示這麼多測試。默認狀況下不設置限制。
    onlyRegressions  #僅顯示與先前構建不一樣的失敗測試。默認爲false。
${TEST_COUNTS,var="TYPE"}   #根據傳入的類型（var）顯示測試數（總計，經過，失敗，跳過）。默認爲總計。
${GIT_BRANCH}   #擴展爲已構建的分支的名稱。

Parameters
all   #若是指定，則列出指向給定提交的全部分支。默認狀況下，令牌會擴展爲其中一個。
fullName  #若是指定，則此標記將擴展爲完整的分支名稱，例如「origin / master」。不然，它只會擴展爲短名稱，例如「master」。
${GIT_REVISION}  #擴展爲指向已構建的提交的Git SHA1提交ID。

Parameters
length=N (optional, default to 40)  #指定提交ID長度。完整的SHA1提交ID長度爲40個字符，但一般會將其剪切爲8或12，由於它一般提供足夠的惟一性而且更加清晰。
${ADMIN_EMAIL}   #顯示Jenkins管理員的電子郵件地址
${BUILD_CAUSE} ${CAUSE}  #顯示構建的緣由。
${BUILD_LOG_EXCERPT}   #顯示構建日誌的摘錄。
     start  #正則表達式匹配摘錄起始行（排除匹配行）。
     end   #正則表達式匹配摘錄結束行（排除匹配行）。
${BUILD_LOG}      #顯示構建日誌結尾。
     maxLines   #最多顯示這麼多行的日誌。默認爲250。
     escapeHtml  #若是爲true，則HTML將被轉義。默認爲false。
${BUILD_LOG_MULTILINE_REGEX}       #顯示與正則表達式匹配的構建日誌段。
     regex   #java.util.regex.Pattern包含與此正則表達式匹配的構建日誌的段。另請參見null。沒有默認值。必需參數
     maxMatches  #要包含的最大匹配數。若是爲0，則將包括全部匹配。默認爲0。
     showTruncatedLines  #若是爲true，則包括[...截斷的### lines ...]行。默認爲true。
     substText   #若是爲非null，請將此文本插入電子郵件而不是整個段。默認爲null。
     escapeHtml  #若是爲true，則轉義HTML。默認爲false。
     matchedSegmentHtmlStyle  #若是爲非null，則輸出HTML。匹配的行將變爲<b style =「your-style-value」> html轉義匹配行</ b>。默認爲null。
${BUILD_LOG_REGEX}        #顯示構建日誌中與正則表達式匹配的行。
     regex   #包含與此正則表達式匹配的行。另請參見java.util.regex.Pattern.Defaults to「（？i）\\ b（error | exception | fatal | fail（ed | ure）| un（defined | resolved））\\ b」
     linesBefore  #匹配行以前要包含的行數。與另外一個匹配或linesAfter重疊的行僅包含一次。默認爲0。
     linesAfter  #匹配行後要包含的行數。與另外一個匹配或linesBefore重疊的行只包含一次。默認爲0。
     maxMatches   #要包含的最大匹配數。若是爲0，則將包括全部匹配。默認爲0。
     showTruncatedLines   #若是爲true，則包括[...截斷的### lines ...]行。默認爲true。
     substText   #若是爲非null，請將此文本插入電子郵件而不是整行。默認爲null。
     escapeHtml   #若是爲true，則轉義HTML。違約是假的。
     matchedLineHtmlStyle   #若是爲非null，則輸出HTML。匹配的行將變爲<b style =「your-style-value」> html轉義匹配行</ b>。默認爲null。
     addNewline    #若是爲true，則在subsText以後添加換行符。默認爲true。
     defaultValue   #若是沒有替換任何內容，將使用此值。
${BUILD_NUMBER}        #擴展爲當前內部版本號，這是一個標識構建的順序自動遞增惟一編號，例如「125」
${BUILD_STATUS}   #顯示當前構建的狀態。（failing, success等......）
${BUILD_URL}   #顯示當前構建的URL
${CHANGES_SINCE_LAST_BUILD} ${CHANGES}   #顯示自上次構建以來的更改。並不是全部修訂系統都支持％d和％r。若是指定showPaths參數被忽略。默認爲「[％a]％m \\ n」
     showDependencies   #若是爲true，則顯示此構建所依賴的項目的更改。默認爲false
     showPaths   #若是爲true，則顯示由提交修改的路徑。默認爲false
     format    #對於列出的每一個提交，包含％X的字符串，其中％x是如下之一：%a（做者）、%d(日期）、%m(信息)、%p(路徑)、%r(版本)
     pathFormat      #包含％p的字符串，指示如何打印路徑。Defaults to "\\t%p\\n"
     regex   #正則表達式。
     replace  #替換與給定正則表達式匹配的更改消息的全部子字符串。
     default  #未檢測到更改時使用的消息。默認爲「無更改\ n」
${CHANGES_SINCE_LAST_SUCCESS}       #顯示自上次成功構建以來的更改。默認爲#%n\n%c\n
     reverse  #若是爲true，則將最新版本顯示在頂部而不是底部。默認爲false。
     format   #對於列出的每一個構建，包含％X的字符串，其中％X是其中之一
         %c       #變化
         %n       #編號
     changesFormat     #對於構建中的每一個更改。
${CHANGES_SINCE_LAST_UNSTABLE}   #擴展到自上次不穩定或成功構建以來的更改。參數跟上面同樣
${ENV,var="VARIABLENAME"}   #從構建環境擴展到環境變量（此處指定爲VARIABLENAME）。請注意，這不包括構建腳本自己設置的任何變量，只包括由Jenkins和其餘插件設置的變量。
${JENKINS_URL}   #顯示Jenkins服務器的URL。 （您能夠在系統配置頁面上更改此設置。）
${JOB_DESCRIPTION}  #顯示做業的說明。
${LOG_REGEX}   #使用正則表達式查找單個日誌條目，並使用其中的捕獲組生成新輸出。這部分基於description-setter插件（https://github.com/jenkinsci/description-setter-plugin）。
${PROJECT_NAME}  #顯示項目的全名。 （參見AbstractProject.getFullDisplayName）
${PROJECT_DISPLAY_NAME}  #顯示項目的顯示名稱。 （參見AbstractProject.getDisplayName）
${PROJECT_URL}   #顯示項目頁面的URL。
${PROPFILE,file="FILENAME",property="PROPERTYNAME"}   #擴展爲屬性文件中的屬性值。文件名相對於構建工做區根目錄。
${FILE,path="PATH"}   #擴展爲文件的內容。文件路徑相對於構建工做空間根目錄。
${XML,file="FILE",xpath="XPATH"}  #擴展到針對給定XML文件運行的XPath表達式的結果。若是XPath求值爲多個值，則返回以分號分隔的字符串。文件路徑相對於構建工做空間根目錄。