平臺概述

平臺定位

軟件產(chǎn)品交付過程中IT工具鏈的打通侵佃，開發(fā)運維一體化驹饺，使得各個團(tuán)隊減少時間損耗秫舌，更加高效地協(xié)同工作币叹。

客戶價值

• 代碼快速提交和反饋
• 開發(fā)可控生產(chǎn)環(huán)境
• 全自動高效自動化

系統(tǒng)配置

角色管理

• 菜單層次：全局層姨拥。
• 菜單路徑：管理 > 角色绅喉。

當(dāng)API發(fā)送請求時，通過授予用戶角色來授予適當(dāng)?shù)臋?quán)限來使用資源叫乌，該篇介紹如何進(jìn)行角色的創(chuàng)建與權(quán)限配置柴罐。

新建角色

1. 點擊 創(chuàng)建 。

2. 輸入 “角色名” 憨奸， “角色編碼” 革屠，設(shè)置是否可編輯以及是否啟用，點擊 添加權(quán)限膀藐。

   注：API權(quán)限列表

3. 選擇所需相應(yīng)權(quán)限屠阻，點擊 確定 ，進(jìn)行創(chuàng)建额各。

編輯角色權(quán)限配置

1. 針對已存在的角色国觉，點擊 編輯 ，或者從詳情界面點擊 編輯 虾啦。

2. 對角色相關(guān)信息進(jìn)行修改麻诀，以及權(quán)限進(jìn)行修改痕寓，點擊 添加權(quán)限 。

3. 添加或刪除一個或多個權(quán)限蝇闭，點擊 確定 呻率。

停用角色

• 點擊 停用 ，該角色將不可分配給用戶呻引。

啟用角色

點擊 啟用 礼仗，該角色正常使用，可以分配給相應(yīng)用戶逻悠。
注：現(xiàn)有角色需手動配置權(quán)限列表

角色權(quán)限說明

用戶管理

• 菜單層次：組織層愉豺。
• 菜單路徑：IAM > 用戶管理。

面向平臺管理員提供用戶管理功能趋距，可以新建用戶粒氧，進(jìn)行用戶信息維護(hù)等。
注：用戶可由其他系統(tǒng)批量導(dǎo)入节腐。

新建用戶

1. 點擊創(chuàng)建按鈕外盯。

2. 輸入用戶相關(guān)信息，點擊創(chuàng)建按鈕翼雀，完成創(chuàng)建饱苟。

3. 新建的用戶“張三”已在用戶列表中，gitlab自動生成用戶“張三”狼渊。箱熬。

查看用戶詳情

1. 點擊詳情，進(jìn)入用戶詳情界面。

2. 查看所需信息。

編輯用戶信息

1. 點擊編輯律姨，進(jìn)入用戶編輯界面。

   或從用戶詳情界面點擊編輯按鈕糕伐，進(jìn)入用戶編輯界面。

2. 對用戶信息進(jìn)行修改蘸嘶，點擊保存按鈕良瞧，用戶信息修改完成陪汽。

刪除用戶

1. 點擊刪除。

2. 再次點擊刪除按鈕褥蚯，用戶刪除成功挚冤。

角色分配

• 菜單層次：組織層/項目層
• 菜單路徑：IAM > 角色分配。

面向平臺管理員赞庶、項目所有者提供的權(quán)限管理训挡，可以在組織或項目內(nèi)添加成員，為其分配適當(dāng)?shù)慕巧局矗部梢哉{(diào)整現(xiàn)有成員的角色舍哄，可以有適當(dāng)?shù)臋?quán)限使用資源宴凉。

添加角色

1. 若需要分配的用戶不在該組織/項目中誊锭，點擊 添加 按鈕進(jìn)行角色添加。

   例如：當(dāng)用戶“25777”不屬于“演示項目0131”項目時弥锄，點擊添加丧靡，輸入用戶名，為該用戶分配角色權(quán)限籽暇。

2. 若用戶存在于成員角色管理列表中温治，無需點擊 添加 ，點擊 ▼ 戒悠，選擇一個或多個角色進(jìn)行分配熬荆。

   例如，創(chuàng)建用戶完成后绸狐，平臺會自動分配 “組織查看者” 的角色卤恳，該用戶存在于成員角色管理列表中，直接進(jìn)行角色分配寒矿，點擊 保存 按鈕突琳，完成角色修改。

小tips：找不到用戶怎么辦符相？
直接在搜索框內(nèi)輸入用戶名或昵稱拆融，回車一下就搞定啦~

注：角色權(quán)限列表

刪除角色

1. 點擊 刪除 。

2. 點擊 刪除 禀倔，用戶從該組織/項目移除成功榄融。

項目管理

• 菜單層次：組織層
• 菜單路徑：IAM > 項目。

根據(jù)企業(yè)產(chǎn)品研發(fā)情況拆分團(tuán)隊蹋艺，建議采用敏捷項目管理團(tuán)隊為一個項目單位剃袍，項目管理可以提供項目創(chuàng)建、項目查詢捎谨、項目編輯等功能民效。

新建項目

1. 點擊 創(chuàng)建 按鈕。

2. 輸入 “項目編碼” 和 “項目名稱” 涛救，點擊 創(chuàng)建 按鈕畏邢。

3. 新建項目 “演示0131” 已在項目管理列表中， gitlab自動對應(yīng)生成group “演示0131” 检吆。

編輯項目信息

1. 點擊 編輯 舒萎，進(jìn)入項目編輯界面。

2. 對 “項目名稱” 進(jìn)行修改蹭沛，點擊 保存 按鈕臂寝。

禁用/啟用項目

點擊 禁用 章鲤，項目禁用后，該項目下的其他操作將無法進(jìn)行咆贬。败徊。

啟用項目

點擊啟用，啟用后掏缎，該項目恢復(fù)正常使用皱蹦。

環(huán)境管理

• 菜單層次：組織層/項目層
• 菜單路徑：開發(fā)管理 > 環(huán)境。

面向平臺管理員和項目創(chuàng)建者眷蜈，根據(jù)用途的不同配置相對應(yīng)的環(huán)境信息沪哺。可以創(chuàng)建環(huán)境酌儒，刪除環(huán)境辜妓，及對環(huán)境詳情信息進(jìn)行編輯修改。
常見環(huán)境包含：測試環(huán)境今豆，UAT環(huán)境及正式環(huán)境等嫌拣。

創(chuàng)建環(huán)境

1. 點擊 創(chuàng)建 按鈕。

2. 輸入 “環(huán)境名稱” 呆躲、 “環(huán)境地址” 以及 “環(huán)境密鑰” ，點擊 測試連接 捶索，若環(huán)境地址插掂、秘鑰配置正確，會提示“連接成功”腥例；若看到提示信息為“連接失敗”辅甥，請修改為正確的環(huán)境地址或秘鑰，點擊 創(chuàng)建 按鈕燎竖。

編輯環(huán)境信息

1. 點擊 編輯 璃弄，進(jìn)入環(huán)境編輯界面。

2. 對環(huán)境信息進(jìn)行修改构回，如環(huán)境名稱夏块，點擊 保存 按鈕，修改完成纤掸。

3. “環(huán)境名稱” 修改完成脐供。

停用環(huán)境

1. 點擊 停用 。

2. 環(huán)境 “Charlietest” 已停用借跪，停用后政己，該環(huán)境將不可使用。

環(huán)境啟用

1. 點擊 啟用 掏愁。

2. 環(huán)境 “Charlietest” 已啟用歇由，啟用后卵牍，該環(huán)境可正常使用。

環(huán)境刪除

1. 點擊 刪除 沦泌。

2. 再次確認(rèn)辽慕，點擊 刪除 。

用戶組管理

• 菜單層次：組織層
• 菜單路徑：用戶管理 > 用戶組赦肃。

創(chuàng)建用戶組

點擊 創(chuàng)建 溅蛉，輸入 “用戶組編碼” ， “用戶組名” 他宛，“用戶組描述” 船侧，點擊 創(chuàng)建 ，用戶組創(chuàng)建完成厅各。

編輯用戶組

1. 點擊 編輯 镜撩。

2. 修改用戶組信息，點擊 編輯 队塘。

添加用戶組用戶

1. 點擊 添加用戶 袁梗。

2. 點擊 添加 ，勾選需要添加到該用戶組的用戶憔古。

刪除用戶組

點擊 刪除 遮怜，刪除當(dāng)前用戶組。

1. 敏捷管理

1.1. 故事地圖

• 菜單層次：組織層鸿市。
• 菜單路徑：項目>敏捷管理>用戶故事>故事地圖锯梁。

在開規(guī)劃會議之前,用戶可以按照角色,活動,任務(wù)分類來規(guī)劃roadmap,整理用戶故事,記錄的用戶故事將會被同步到gitlab的issue上,項目干系人可以在issue下放進(jìn)行評論,對用戶故事展開討論。

1.1.1. 使用故事地圖

1. 添加角色

   角色:提出用戶需求的人或者用戶需求是基于哪類用戶考慮的焰情。例如敏捷開發(fā)有三種角色陌凳，po，master和項目開發(fā)人員内舟。

   點擊<創(chuàng)建角色>鼠標(biāo)光標(biāo)會變?yōu)?加號",當(dāng)出現(xiàn)"加號"圖標(biāo)時,用戶在角色這一行任意位置單擊,即可添加角色合敦。

   添加角色

2. 添加活動

   活動:基于某一個角色下，具體的用戶場景验游。
   點擊<創(chuàng)建活動>鼠標(biāo)光標(biāo)會變?yōu)?加號",當(dāng)出現(xiàn)"加號"圖標(biāo)時,用戶在活動這一行任意位置單擊,即可添加活動充岛。

3. 添加任務(wù)

   任務(wù):用戶場景的細(xì)化。

   點擊<創(chuàng)建任務(wù)>鼠標(biāo)光標(biāo)會變?yōu)?加號",當(dāng)出現(xiàn)"加號"圖標(biāo)時,用戶在任務(wù)這一行任意位置單擊,即可添加任務(wù)批狱。

1. 創(chuàng)建發(fā)布計劃

   點擊<創(chuàng)建發(fā)布計劃>,即可在用戶故事地圖上面生成對應(yīng)的發(fā)布計劃,依次默認(rèn)命名為發(fā)布計劃1,發(fā)布計劃2.....,如果想修改發(fā)布計劃名稱或者刪除發(fā)布計劃,點擊發(fā)布計劃名稱旁邊的三點符號,可進(jìn)行修改或者刪除裸准。處于安全考慮,已經(jīng)有用戶故事的發(fā)布計劃,需要先刪除里面的用戶故事,才能刪除整個發(fā)布計劃

![修改或刪除發(fā)布計劃](http://upload-images.jianshu.io/upload_images/10538228-61c32369ecdc68d9.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

1. 創(chuàng)建卡片

   在故事地圖界面移動鼠標(biāo),見到卡片創(chuàng)建的提示時,點擊提示卡中間的文字部分,也可以創(chuàng)建相應(yīng)的卡片,比如角色，活動赔硫，任務(wù)炒俱，用戶故事。

   用戶故事:具體的需求。

   創(chuàng)建活動
   創(chuàng)建任務(wù)
   創(chuàng)建用戶故事

1.1.2. 故事地圖工具欄介紹

1. 未規(guī)劃區(qū)的使用

   點擊<未規(guī)劃區(qū)>,會出現(xiàn)一個側(cè)邊欄,如下圖所示,在側(cè)邊欄中會放入您在其他界面創(chuàng)建的未選擇發(fā)布計劃的故事,比如您在用戶故事界面創(chuàng)建了一個未選擇發(fā)布計劃的用戶故事,就會以一張故事卡的形式出現(xiàn)在此處,頂部的搜索和過濾可以進(jìn)行高級搜索,找到您想要的卡片,您考慮好此故事放在哪個發(fā)布計劃下比較合適時,也可以拖動到具體的發(fā)布計劃下权悟。

   未規(guī)劃區(qū)入口
   未規(guī)劃區(qū)展開界面

1. 數(shù)據(jù)統(tǒng)計

   此項目下的數(shù)據(jù)進(jìn)度的分析砸王，可一鍵從此入口進(jìn)入，也可去數(shù)據(jù)洞察界面選擇具體項目查看峦阁。

   數(shù)據(jù)統(tǒng)計
   數(shù)據(jù)分析結(jié)果展示

1. 導(dǎo)出為圖片

   點擊<導(dǎo)出為圖片>,即可把當(dāng)前的地圖以圖片形式保存下來谦铃，導(dǎo)出格式為png。

   導(dǎo)出為圖片

1. 放大縮小

   點擊放大搜索標(biāo)志榔昔，或者拖動放大縮小的滾動條驹闰，都可完成整個地圖的放大縮小。

![放大縮小](http://upload-images.jianshu.io/upload_images/10538228-91d4a5b333033006.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

1.2. 用戶故事

• 菜單層次：組織層撒会。
• 菜單路徑：項目>敏捷管理>用戶故事>用戶故事嘹朗。

用戶故事界面是用戶故事界面的列表展現(xiàn)形式,在這里可以集中查看您創(chuàng)建的所有的用戶故事,以及其下的任務(wù)缺陷等,方便快捷。

1.2.1. 用戶故事界面功能詳解

1. 創(chuàng)建故事

   點擊<創(chuàng)建故事>,出現(xiàn)詳情信息編輯的窗口,在窗口中進(jìn)行編輯,編輯完成之后點擊保存诵肛。

   創(chuàng)建故事

1. 高級搜索

   點擊<過濾>可以進(jìn)行高級搜索

   過濾

1. 操作

• 刪除

  未進(jìn)入沖刺的用戶故事可以刪除屹培。

• 快捷創(chuàng)建任務(wù)

  可以快捷創(chuàng)建用戶故事下面的任務(wù)。

• 快捷創(chuàng)建缺陷

  可以快捷創(chuàng)建用戶故事下面的缺陷怔檩。

  操作

1.3. 沖刺

• 菜單層次：組織層褪秀。
• 菜單路徑：項目>敏捷管理>沖刺和看板>沖刺。

在沖刺中薛训，可方便為您管理一個迭代周期內(nèi)要完成的故事媒吗，并為您進(jìn)行后臺數(shù)據(jù)監(jiān)測，可視化故事完成的情況许蓖，沖刺作為用戶故事地圖和看板的銜接環(huán)節(jié)蝴猪，開啟沖刺之后才能使用看板的全部功能。

1.3.1. 沖刺界面功能詳解

1. 創(chuàng)建沖刺

   點擊<創(chuàng)建沖刺>,選擇發(fā)布計劃和預(yù)計的沖刺起止時間,即可創(chuàng)建一個新的沖刺膊爪。

   image.png

1. 搜索

   可以在工具欄進(jìn)行搜索。

   搜索

2. 操作

   • 刪除

     可以刪除這個沖刺嚎莉。

   • 狀態(tài)切換

     可以快捷開啟或者關(guān)閉沖刺米酬，完成狀態(tài)切換。

   • 編輯

     可以修改沖刺的具體信息趋箩。

   操作

1. 進(jìn)入沖刺詳情

   點擊沖刺的名稱赃额，即可進(jìn)入沖刺詳情。

   • 開啟/關(guān)閉沖刺

     點擊<開啟沖刺>可開啟當(dāng)前沖刺,開啟之后,數(shù)據(jù)洞察就開始記錄當(dāng)前沖刺的數(shù)據(jù)叫确。沖刺內(nèi)添加的故事也會自動導(dǎo)入看板中,并放在第一列跳芳。
     點擊<關(guān)閉沖刺>可關(guān)閉當(dāng)前沖刺，關(guān)閉之后不能再開啟竹勉。

   • 添加故事

     選擇故事來源,從故事地圖,或者未規(guī)劃的故事中,勾選需要導(dǎo)入的故事,點擊確定,添加到?jīng)_刺中,添加進(jìn)沖刺的故事,在故事地圖界面的顏色會與沒有導(dǎo)入沖刺的顏色有一個變化飞盆。

   • 創(chuàng)建任務(wù)

     可以創(chuàng)建進(jìn)入到?jīng)_刺中的用戶故事下的具體任務(wù)。

   • 創(chuàng)建缺陷

     可以創(chuàng)建用戶故事下或者任務(wù)下測試出現(xiàn)的bug。

   沖刺詳情

   • 篩選

     可以對故事吓歇，任務(wù)和缺陷進(jìn)行分類篩選孽水。

     
     
     篩選

   • 操作

     可以把導(dǎo)入沖刺的故事移除，移除后不會在故事地圖里面刪除城看，只是故事地圖中的卡片顏色會變?yōu)槲磳?dǎo)入狀態(tài)女气。也可以導(dǎo)入到其他沖刺中空免。

   操作

1.4. 看板

• 菜單層次：組織層淌铐。
• 菜單路徑：項目>敏捷管理>沖刺和看板>看板设联。

開啟沖刺之后才能使用看板的全部功能敦第⊙硪看板可以取代物理看板阴颖，也可以可視化您的工作流峦甩，同時后臺會記錄所以操作的時間數(shù)據(jù)嘱朽，幫您完成數(shù)據(jù)分析和記錄工作软吐。

1.4.1. 看板管理界面功能詳解

1. 選擇模板

   進(jìn)入看板之后瘩将，先根據(jù)您的需要，選擇一個看板模板凹耙，單擊某個模板姿现，可查看詳情，雙擊就會為您選擇當(dāng)前模板并打開肖抱，看板界面沒有卡片時备典，您也可以更換模板。

   看板模板
   模板詳情

2. 使用看板

   進(jìn)入看板之后意述，您在當(dāng)前開啟的沖刺中添加的故事提佣，會自動為您導(dǎo)入到當(dāng)前看板，并放在SprintBacklog里面（第一列）

   • 創(chuàng)建卡片

   點擊<創(chuàng)建卡片>,出現(xiàn)卡片詳情編輯的窗口,選擇卡片類型,故事,任務(wù),缺陷,可創(chuàng)建對應(yīng)類型的卡片,創(chuàng)建的卡片會同步到故事地圖界面,放在當(dāng)前發(fā)布計劃的第一個角色的第一個任務(wù)列里荤崇。

   創(chuàng)建卡片
   卡片詳情編輯界面
   • 看板繪制

  點擊<看板繪制>進(jìn)入看板編輯界面
  
  1)增加列
  
  2)繪制泳道
  
  3)增加/減少列高
  
  4)撤銷/恢復(fù)
  
  5)保存
  
  6)在制品和起始列設(shè)置

![看板繪制 ](http://upload-images.jianshu.io/upload_images/10538228-65b8ce2c5b32e016.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)  

- 拖動故事卡
- 故事卡的子卡(任務(wù)卡/bug卡)的操作

1.5. 任務(wù)

• 菜單層次：組織層拌屏。
• 菜單路徑：項目>敏捷管理>任務(wù)和漏洞>任務(wù)。

可以查看您創(chuàng)建的所有任務(wù)术荤，可視化您的任務(wù)流倚喂，同時后臺會記錄所以操作的時間數(shù)據(jù)，幫您完成數(shù)據(jù)分析和記錄工作瓣戚。

1.5.1. 任務(wù)管理界面功能詳解

• 查看任務(wù)

  在任務(wù)界面,您可以查看您所有創(chuàng)建的任務(wù),并且可以高級搜索您要找的任務(wù)端圈。

• 操作

  可以在<操作>中完成刪除,快捷創(chuàng)建缺陷的快捷操作

  任務(wù)

1.6. 漏洞

• 菜單層次：組織層。
• 菜單路徑：項目>敏捷管理>任務(wù)和漏洞>漏洞子库。

可以查看您創(chuàng)建的所有漏洞舱权。

1.6.1. 漏洞管理界面功能詳解

• 查看缺陷

  在任務(wù)界面,您可以查看您所有創(chuàng)建的缺陷,并且可以高級搜索您要找的缺陷。

• 操作

  可以在<操作>中完成刪除缺陷仑嗅。

漏洞

持續(xù)集成

3.1服務(wù)創(chuàng)建

• 菜單層次：項目層
• 菜單路徑：開發(fā)管理 > 服務(wù)

每一個微服務(wù)都可以獨立部署宴倍，每一個微服務(wù)僅關(guān)注于完成一件任務(wù)张症，每個任務(wù)代表一個小的業(yè)務(wù)模塊，各微服務(wù)之間關(guān)系是松耦合的啊楚。
（備注：每創(chuàng)建一個服務(wù)吠冤，會自動在gitlab創(chuàng)建好對應(yīng)服務(wù)類型的代碼庫。）

服務(wù)類型

微服務(wù)：微服務(wù)后端恭理，可以定義依賴的資源和服務(wù)拯辙，部署時需配置網(wǎng)關(guān)。

Web前端：微服務(wù)前端颜价，部署時需配置域名涯保。

移動：移動端應(yīng)用開發(fā)使用，部署流程與其他類型不同周伦。

普通應(yīng)用：非微服務(wù)架構(gòu)的服務(wù)類型夕春，如HAP、HBI等专挪，一個系統(tǒng)一個服務(wù)及志。

Java庫：管理Java工具包。

服務(wù)組

區(qū)分服務(wù)的開發(fā)來源寨腔，創(chuàng)建服務(wù)時需做標(biāo)識速侈。

暫按如下設(shè)置。

新建服務(wù)

1. 點擊 創(chuàng)建 按鈕迫卢。

2. 輸入 “服務(wù)編碼” 倚搬、 “服務(wù)名稱” 、以及 “服務(wù)組” 乾蛤，并選擇相應(yīng)服務(wù)類型每界，點擊 創(chuàng)建 按鈕。

3. 新建服務(wù) “微服務(wù)0201” 已在服務(wù)管理列表中家卖。

4. gitlab已自動創(chuàng)建好對應(yīng)服務(wù)類型的代碼庫 “webservice” 眨层。點擊 倉庫地址 ，可以查看該服務(wù)在gitlab的代碼倉庫上荡。

服務(wù)停用

點擊 停用谐岁，如： “微服務(wù)0201” 已停用，服務(wù)詳情不可查看榛臼。

服務(wù)啟用

點擊 啟用 ，如： “微服務(wù)0201” 已啟用窜司，可對該服務(wù)進(jìn)行相關(guān)操作沛善。

分支管理

• 菜單層次： 項目層
• 菜單路徑： 開發(fā)管理 > 服務(wù)詳情

git flow 工作流模式，自動創(chuàng)建 Git Flow 模式所特有的流水線分支塞祈。
在持續(xù)交付過程中對 feature金刁、release、hotfix 等分支進(jìn)行管理。

分支類型

1. Feature：
   適用于日常開發(fā)尤蛮、bug 修復(fù)媳友，基于開發(fā)分支生成，完成時合并至開發(fā)分支产捞。
2. Release：
   適用于產(chǎn)品發(fā)布醇锚、產(chǎn)品迭代，基于開發(fā)分支生成坯临，完成時合并至主分支和開發(fā)分支焊唬，并打上標(biāo)簽。
3. Hotfix：
   適用于產(chǎn)品發(fā)布后修復(fù)bug看靠，基于主分支生成赶促，完成時先合并至主分支和開發(fā)分支，并打上標(biāo)簽挟炬。

默認(rèn)分支

Develop： 日常開發(fā)分支鸥滨。
Master： 版本發(fā)布分支。

使用流程

GitFlow 使用流程

新建分支

新建 Feature 分支

1. 點擊創(chuàng)建Feature按鈕谤祖。

   創(chuàng)建 Feature 示意

2. 輸入 Issue 編碼婿滓。

   輸入 issue 編碼示意圖

3. 點擊保存按鈕。

   點擊保存示意

新建 Release/Hotfix 分支

1. 點擊 創(chuàng)建Release 按鈕（或 創(chuàng)建Hotfix 按鈕）創(chuàng)建對應(yīng)分支泊脐。

   創(chuàng)建 Release/Hotfix 分支按鈕示意

2. 輸入分支名稱空幻。

   Release 分支創(chuàng)建時會自動生成下一個版本號，也可以手動輸入需要的版本號容客。（版本號由三個數(shù)字組成秕铛，中間以小數(shù)點間隔。如：1.1.0缩挑。
   Release 版本號默認(rèn)為末位清零但两，中間一位進(jìn)一）。

   Hotfix 分支建議填寫 Issue 編號作為分支名供置，也可以手動輸入需要的版本號谨湘。填寫 Issue 編號在結(jié)束分支時會提示以最新 release 小版本加一作為版本號。

   Release 分支版本號示意

3. 點擊確定按鈕芥丧。

   創(chuàng)建 Release/Hotfix 分支確定示意

   注： 無提交時點擊結(jié)束分支紧阔，將不創(chuàng)建合并請求，直接刪除续担。新建分支及結(jié)束分支只能在平臺界面進(jìn)行操作擅耽，請勿隨意在gitlab界面創(chuàng)建合并請求和刪除分支。

分支管理步驟

1. 克隆代碼到本地

   # 在存放代碼的文件夾下執(zhí)行以下命令
   git clone http://git.saas.hand-china.com/devops/hap-devops-service.git
   # 拉取遠(yuǎn)程倉庫成功后進(jìn)入倉庫
   cd hap-devops-service
   

2. 拉取最新代碼和新建的分支

   git pull
   

3. 切換到分支

   # 切換到新建分支物遇，以 feature-2 為例
   git checkout feature-2
   

4. 開發(fā)

   根據(jù)分支對應(yīng)的 Issue 需求修改代碼乖仇。
   完成后詳細(xì)檢查本地代碼改動憾儒。

5. 提交代碼

   # 將本地代碼變動提交到暫存區(qū)
   git add .
   # 提交代碼并且為本次提交添加 commit 信息
   # 注：[FIX]修改bug  [ADD]新增  [IMP]完善  [DEL]刪除
   $ git commit –m “[ADD]readme: 新增代碼示例”
   # 將本地提交推送至遠(yuǎn)程倉庫對應(yīng)分支
   $ git push origin feature-2:feature-2
   

6. 界面操作結(jié)束分支

3.2.6 解決分支沖突

3.2.6.1 Feature 分支沖突

常見兩種解決沖突的方式如下

• 本地修改代碼解決：

  # 確保當(dāng)前正在 Feature 分支上，以 feature-2 為例
  git checkout feature-2
  # 拉取最新遠(yuǎn)程倉庫 develop 分支代碼
  git fetch origin develop:develop
  # 將 Feature 分支重新設(shè)立起點于最新的 develop 代碼
  git rebase develop
  

  執(zhí)行完 rebase 操作后乃沙，會產(chǎn)生對應(yīng)的沖突起趾，解決沖突后執(zhí)行如下代碼。

  git add .
  git rebase --continue
  

  根據(jù)本次 Feature 分支上提交次數(shù)的不同警儒，解決沖突可能會重復(fù)多次训裆，只需要重復(fù)執(zhí)行上述解決沖突操作。
  完成后強制提交至遠(yuǎn)程倉庫冷蚂。

  git push -f origin feature-2:feature-2
  

• 界面解決沖突（不建議）：

  在 GitLab 對應(yīng)的合并請求界面點擊 Solve conficts 按鈕缭保。

Release&Hotfix 分支沖突

當(dāng)分支對于 develop 和 master 分支中任意一個或以上存在沖突時，會提示當(dāng)前存在沖突蝙茶，以及建議做法艺骂。

若此時繼續(xù)點擊確定按鈕，并且沒有解決沖突隆夯，那么會提示分支沖突钳恕，無法繼續(xù)操作。解決沖突具體步驟可查看界面提示蹄衷，說明如下：

1. 只有對應(yīng) develop 的合并請求存在沖突忧额，按界面提示解決沖突會導(dǎo)致分支對應(yīng) develop 分支的合并請求被合并。此時再進(jìn)行結(jié)束分支操作愧口，會處理分支對 master 的合并請求睦番，然后生成對應(yīng)版本號的 Tag 并刪除分支。

2. 只有對應(yīng) master 的合并請求存在沖突耍属，按界面提示解決沖突會導(dǎo)致分支對應(yīng) master 分支的合并請求被合并托嚣。此時再進(jìn)行結(jié)束分支操作，會處理分支對 develop 的合并請求厚骗，然后生成對應(yīng)版本號的 Tag 并刪除分支示启。

3. 若分支對應(yīng) develop 和 master 分支的合并請求都存在沖突，按界面提示解決沖突會導(dǎo)致分支對應(yīng) develop 和 master 分支的合并請求依次都被合并领舰。此時再進(jìn)行結(jié)束分支操作夫嗓，會生成對應(yīng)版本號的 Tag 并刪除分支。

服務(wù)版本

• 菜單層次：項目層
• 菜單路徑：開發(fā)管理 > 服務(wù)詳情

代碼提交的歷史記錄冲秽，每提交一次修改后的代碼舍咖，對應(yīng)生成一個新的版本。

查看服務(wù)版本信息

1. 進(jìn)入服務(wù)詳情后锉桑，點擊 服務(wù)版本 頁簽谎仲。

2. 查看服務(wù)版本信息。

查看流水線信息

1. 進(jìn)入服務(wù)詳情后刨仑，點擊 流水線 頁簽郑诺。

2. 查看服務(wù)CI pipeline的完成情況。

   注：版本命名方式：合并至develop：develop. + 年月日時分秒杉武。

   Tag生成：版本號（三位號碼辙诞，如：1.1.0。release修改前兩位轻抱，hotfix修改第三位）飞涂。
   提交：每次提交代碼的操作，自動生成Commit ID祈搜，由于字?jǐn)?shù)多较店，平時多取前八位。

查看代碼質(zhì)量情況

可在服務(wù)詳情-代碼質(zhì)量查看容燕。面向團(tuán)隊成員梁呈，反饋代碼質(zhì)量信息，按照相應(yīng)的代碼規(guī)范及標(biāo)準(zhǔn)在線進(jìn)行代碼靜態(tài)檢查蘸秘、代碼安全檢查官卡、質(zhì)量評分、代碼缺陷改進(jìn)趨勢分析醋虏，輔助管控代碼質(zhì)量寻咒。

服務(wù)詳情-代碼質(zhì)量：只看該服務(wù)下經(jīng)單元測試后的代碼質(zhì)量情況。

注：可從開發(fā)監(jiān)控了解項目整體及DevOps全鏈路各個環(huán)節(jié)進(jìn)展情況颈嚼。

服務(wù)發(fā)布

服務(wù)發(fā)布

• 菜單層次：項目層
• 菜單路徑：開發(fā)管理 > 發(fā)布

面向發(fā)布管理員毛秘，提供服務(wù)發(fā)布至不同環(huán)境的功能，向目標(biāo)環(huán)境傳輸部署文件阻课，同時附帶服務(wù)版本信息以便追蹤叫挟。

1. 點擊 發(fā)布 。

2. 關(guān)鍵字搜索或直接從從下拉列表中選擇部署文件發(fā)布的環(huán)境柑肴。

3. 點擊 保存 霞揉。

4. 該服務(wù)部署文件已成功發(fā)布在開發(fā)或正式環(huán)境。

自動發(fā)布

• 菜單層次：項目層
• 菜單路徑：開發(fā)管理 > 服務(wù)

1. 項目所有者可以設(shè)置服務(wù) “自動發(fā)布” 晰骑。

2. 可以選擇一個或多個環(huán)境适秩。

3. 點擊 保存 ，版本生成會自動發(fā)布部署文件至所選環(huán)境硕舆。

   注：自動發(fā)布僅針對于開發(fā)環(huán)境秽荞，正式環(huán)境需手動發(fā)布。

持續(xù)部署

資源管理

• 菜單層次：組織層
• 菜單路徑：部署服務(wù) > 資源管理

定義部署時需要使用的資源抚官。
目前支持五種：mysql扬跋、redis、rebbitmq凌节、kafka钦听、url洒试。

新建資源

1. 點擊 創(chuàng)建 ，輸入 “名稱” 朴上、 “描述” 以及選擇資源類型垒棋，例如mysql。

2. 輸入資源相關(guān)信息痪宰，點擊 創(chuàng)建 叼架。

3. 新建資源 “hap-devops-test” 已在資源管理列表中。

資源編輯

1. 點擊 編輯 衣撬，修改資源信息乖订，點擊 保存 。

2. 點擊 “資源名稱” 具练，查看資源詳情乍构。

資源刪除

1. 點擊 刪除 。

2. 再次確認(rèn)靠粪，點擊 刪除 蜡吧。

網(wǎng)關(guān)管理

• 菜單層次：組織層
• 菜單路徑：部署服務(wù) > 資源管理

為所選的微服務(wù)將網(wǎng)關(guān)信息注冊至微服務(wù)管理服務(wù)，支持刪除其對應(yīng)網(wǎng)關(guān)占键。
注：服務(wù)可以訪問的兩個必要條件：網(wǎng)關(guān)注冊昔善、服務(wù)部署。

新建網(wǎng)關(guān)

1. 點擊 創(chuàng)建 畔乙，選擇需要配置網(wǎng)關(guān)的服務(wù)君仆，如 “webservice0131” ，點擊 創(chuàng)建 牲距。

2. 服務(wù) “webservice0131” 的網(wǎng)關(guān)已在網(wǎng)關(guān)管理列表中返咱。

網(wǎng)關(guān)刪除

1. 點擊 刪除 。

2. 再次確認(rèn)牍鞠，點擊 刪除 咖摹。

域名管理

• 菜單層次：組織層
• 菜單路徑：部署服務(wù) > 資源管理

為相應(yīng)的服務(wù)創(chuàng)建可訪問域名并可對其進(jìn)行修改，域名后綴為運行區(qū)域名后綴难述，如運行區(qū)域名
注：目前Web前端及普通應(yīng)用需配置域名萤晴，若不配置域名，不能進(jìn)行外網(wǎng)訪問該前端胁后，只能查看系統(tǒng)提供的pod ip店读。

新建域名

1. 點擊 創(chuàng)建 ，選擇需要配置域名的服務(wù)攀芯，并輸入 “域名” 屯断，點擊 創(chuàng)建 。

2. 服務(wù) “webfront0131” 的域名已在域名管理列表中。

編輯域名信息

1. 點擊 編輯 殖演。

2. 修改域名信息氧秘，點擊保存 ，域名修改完成剃氧。敏储。

刪除域名

1. 點擊刪除。

2. 再次確認(rèn)朋鞍，點擊刪除。

服務(wù)部署

• 菜單層次：組織層
• 菜單路徑：部署管理 > 服務(wù)

提供可視化妥箕、一鍵式部署服務(wù)滥酥，支持并行部署和流水線無縫集成，實現(xiàn)部署環(huán)境標(biāo)準(zhǔn)化和部署過程自動化畦幢。

查看服務(wù)列表

點擊 部署管理 坎吻，點擊 服務(wù) ，查看服務(wù)列表宇葱。

查看服務(wù)版本列表

1. 點擊詳情瘦真。

2. 查看該服務(wù)歷史版本信息。

查看部署文件

點擊查看部署文件黍瞧，查看部署文件信息。

服務(wù)部署

1. 在服務(wù)列表中找到要部署的服務(wù)，點擊詳情敦锌，例如webservice0131订歪。

2. 選擇要發(fā)布的版本，點擊部署服務(wù)年局。

3. 進(jìn)行資源選擇和變量填寫际看，點擊部署。

查看運行中的服務(wù)

1. 點擊詳情矢否。

2. 可在運行中查看正在部署/運行的版本仲闽，以及對容器數(shù)量進(jìn)行調(diào)整。

3. 點擊詳情僵朗，查看服務(wù)部署階段和詳情信息赖欣。

   注：不同服務(wù)類型，部署階段不同衣迷。

查看容器組列表

點擊容器組頁簽畏鼓，查看容器組列表。

查看容器組日志

點擊容器組日志進(jìn)行相關(guān)日志查看壶谒。

灰度部署

用于保障系統(tǒng)穩(wěn)定云矫，驗證某服務(wù)版本是否正常使用，驗證正常后再轉(zhuǎn)為正式部署汗菜。

支持Web前端让禀、普通應(yīng)用類型的服務(wù)使用自動生成域名的方式進(jìn)行灰度部署挑社；支持微服務(wù)類型的服務(wù)使用選擇不同用戶組的方式進(jìn)行灰度部署。

1. 在服務(wù)列表中找到要部署的服務(wù)巡揍，點擊 詳情 痛阻，例如webservice0131。

2. 選擇要灰度部署的版本腮敌，點擊 部署服務(wù) 阱当。

3. 進(jìn)行資源選擇和變量填寫，勾選灰度發(fā)布糜工，選擇用戶組弊添，如devops，點擊 部署 捌木。

4. 可在運行中查看該版本正在進(jìn)行灰度部署油坝。

自動部署

1. 部署管理員可以設(shè)置“自動部署”。

2. 版本發(fā)布到運行區(qū)將會自動部署刨裆。

   注：自動部署僅針對于正式部署澈圈。

查看服務(wù)運行歷史

點擊 運行歷史 ，查看部署失敗或部署停止的服務(wù)版本帆啃。

洞察監(jiān)控

開發(fā)監(jiān)控

綜述

1. 計劃完成率：已完成狀態(tài)的用戶故事除以總的用戶故事瞬女。

2. 變更時長：類型為變更的用戶故事完成的平均時長。

3. 變更為完成率：類型為變更的用戶故事的完成率链瓦。

4. 問題平均處理時長：類型為BUG的用戶故事平均處理時長拆魏。

概況

1. DevOps流程狀態(tài)：顯示項目從計劃、編程慈俯、構(gòu)建渤刃、質(zhì)量、發(fā)布整個流程的狀態(tài)贴膘。

2. 服務(wù)列表：項目下所有服務(wù)列表包含名字和git地址卖子。

3. 項目成員列表：項目下所有成員列表包含提交頻率、構(gòu)建頻率刑峡、角色等洋闽。

4. 最新動態(tài)：項目下最新的成員的操作動態(tài)。

計劃

1. 發(fā)布信息：用戶故事突梦、已經(jīng)計劃用戶故事诫舅、正在進(jìn)行用戶故事、已經(jīng)完成用戶故事宫患、總發(fā)布數(shù)刊懈。

2. 沖刺信息：已開啟沖刺進(jìn)度、已開啟沖刺下的任務(wù)完成進(jìn)度、用戶故事：已開啟沖刺的用戶故事總數(shù)虚汛、任務(wù)總數(shù)缺陷總數(shù)匾浪。

3. 平均用戶故事點：沖刺的平均用戶故事點。

4. 平均工時：沖刺的平均工時卷哩。

5. 用戶故事來源分布圖：用戶故事來源分布餅圖蛋辈。

6. 用戶故事狀態(tài)分布圖：用戶故事完成和未完成狀態(tài)的分布圖。

7. 缺陷堆疊圖：缺陷按照沖刺分類型的堆疊圖将谊。

8. 缺陷累計分布圖：缺陷類型分布餅圖冷溶。

9. 燃盡圖：沖刺的工時燃盡圖。

10. 累計流圖：沖刺的用戶故事的累計流圖尊浓。

編程

1. 合并總數(shù)：統(tǒng)計merge request的請求總數(shù)挂洛。

2. 提交總數(shù)：push的總數(shù)。

3. 提交總頻率：push的總數(shù)除以天數(shù)不含周末眠砾。

4. 提交頻率：最近14天的提交數(shù)除以天數(shù)不含周末。

5. 活躍開發(fā)人員：每周提交三次以上托酸。

6. 本周提交數(shù)

7. 提交次數(shù)圖

8. 人員提交次數(shù)圖

9. 提交歷史

構(gòu)建

1. 構(gòu)建總數(shù)：pipeline的總數(shù)褒颈。

2. 總構(gòu)建頻率：構(gòu)建總數(shù)除以天數(shù)不包含周末。

3. 構(gòu)建頻率：最近14天的構(gòu)建數(shù)除以天數(shù)不包含周末励堡。

4. 構(gòu)建平均時長： pipeline的平均時長谷丸。

5. 構(gòu)建成功率： pipeline的成功率。

6. 本周構(gòu)建成功率(近7天構(gòu)建成功率应结。

7. 構(gòu)建次數(shù)圖

8. 人員構(gòu)建次數(shù)圖

9. 構(gòu)建歷史

質(zhì)量

Sonar的數(shù)據(jù)

發(fā)布

1. 發(fā)布計劃名

2. 發(fā)布計劃完成進(jìn)度條

3. 本發(fā)布計劃已完成故事數(shù)

4. 本發(fā)布計劃故事總數(shù)

5. 用戶故事列表：編號刨疼、標(biāo)題、狀態(tài)鹅龄、創(chuàng)建時間等

運營監(jiān)控