###### tags: `III DevOps`, `客戶服務`, `操作手冊`
# 第一次開始使用III DevOps 平台 - 資策會篇
* [使用者介面操作教學影音(請點這裡)](https://www.youtube.com/watch?v=CK04c2cPGh8&list=PLJS2VJenopmdArR3d10PclXtxPdMD8RT-)
## 一、開始建立CI/CD專案吧
1. 請使用<font color="#00f">**公司網路**</font>或<font color="#00f">**會內VPN**</font>,並以AD帳號及密碼登入[DevOps平台](http://devops.iii.org.tw/)。
![](https://i.imgur.com/dBfVdr7.png)
3. 請依序填入專案相關資訊,並選擇適合之開發環境範本,目前平台提供[27種範本](https://github.com/iiidevops-template) (持續新增中),但若純源碼掃描,則可直接選擇「Default」,該範本不進行環境建置,僅進行程式碼安全掃描。
![](https://i.imgur.com/0tRK4ND.png)
\
## 二、專案成員管理 - 將相關專案成員拉入專案
1. PM - 請專案同仁確認登入平台後回報。
2. PM - 方可至專案設置-> 專案成員進行專案成員加入或移除![](https://i.imgur.com/PDF70iz.png)
* 若專案成員未曾登入平台,則無法將該員加入
* 未有AD帳密之專案人力或其他共識同仁,則請提供以下資訊至DevOps窗口,以利開立帳號:
* 部門、名字、eMail、電話
\
## 三、檢查範本專案Pipeline運作
1. 專案開立後,可至 「**開發進度**」-> 「**Pipeline**」檢查目前pipeline 執行之進度
![](https://i.imgur.com/gvXRwGd.png)
2. 或是點入「細節」瞭解更細部的資訊
![](https://i.imgur.com/9xUyLM6.png)
## 四、自己的code自己上 (請放置源碼指定位置)
1. 請先將範本的源碼下載下來
![](https://i.imgur.com/E8tvYSV.png)
**[注意]** 1.1. *****源碼下載後,會看到以下的目錄,但請注意,<font color="#f00">不要覆蓋 「app」 以外之目錄</font>,以避免Pipeline 運行異常**
**[注意]** 1.1.1 若您拉下的源碼目錄內<font color="#f00">未含有app 資料夾</font>, 則請直接<font color="#f00">創建一新的源碼目錄</font>, 並將您的源碼放置該新創之目錄裡即可.
![](https://i.imgur.com/bhWJ5PL.png)
**[注意]** 1.2 *** **也請勿將既有的 git repo 直接用 git push --force 至新建立專案的 gitlab repo**, 這會導致建立專案時選擇範本所產生的定義檔消失。 也就是指該專案將無法在 git push 後觸發自動掃描等 Pipeline 功能。**<font color="#f00">所以請先 git clone 後複製原始碼進 repo 內 app 目錄後, 再透過 git commit / push 方式來處理</font>**
**[注意]** 1.3 *** **clone 專案,通過第三方gitGit客户端修改,**<font color="#f00">**請以https 的方式 clone** 專案</font>
### (1) CI/CD初階應用 - 至少取得到源碼安全掃描報告 (SonarQube、CheckMarx)
1. 請確認該專案使用"Default"範本進行專案建立。
2. 請將源碼 commit 至 app之目錄內,並push上該分支,即可開始執行掃描
> ****注意事項: 若僅掃源碼,請記得只要將app 內的檔案置換成您的源碼即可****
![](https://i.imgur.com/8jiWn23.png =450x350)
3. 檢視SonarQube報告
![](https://i.imgur.com/HAjev0N.png)
3.1 登入後,即可看到SonarQube報告
![](https://i.imgur.com/d439weD.png)
4. 檢視CheckMarx 報告
![](https://i.imgur.com/0A0YzRP.png)
### (2) CI/CD進階應用 - 在DevOps把環境建起來
1. 請使用適合自己之範本建立專案
目前平台提供 27範本
| 語言或框架 & 資料庫 | 無資料庫 | PostgreSQL | MariaDB | SQLite | MongoDB | MS SQL |
| ------------------- | ------------------------------------------------------------------------ | ---------------------------- | --------------------------- | ------------------------ | ------------------- | --------- |
| 一 | [default-dev(僅執行源碼掃描)](https://github.com/iiidevops-templates/default-dev/blob/master/README.md) | [postgres-dev](https://github.com/iiidevops-templates/postgres-dev/blob/master/README.md) | [mariadb-dev](https://github.com/iiidevops-templates/mariadb-dev/blob/master/README.md) | 一 | [mongodb-dev](https://github.com/iiidevops-templates/mongodb-dev/blob/master/README.md) | [mssql-dev](https://github.com/iiidevops-templates/mssql-dev/blob/master/README.md) |
| ASP.NET Core | [asp-dotnet-core-example](https://github.com/iiidevops-templates/asp-dotnet-core-example/blob/master/README.md) | 一 | 一 | 一 | 一 | 一 |
| Java Spring Boot | [spring-boot-gradle-hello](https://github.com/iiidevops-templates/spring-boot-gradle-hello/blob/master/README.md) | [spring-boot-postgres-example](https://github.com/iiidevops-templates/spring-boot-postgres-example/blob/master/README.md) | [spring-boot-mariadb-restapi](https://github.com/iiidevops-templates/spring-boot-mariadb-restapi/blob/master/README.md) | 一 | 一 | 一 |
| jQuery | [bootstrap-jquery-simple-web](https://github.com/iiidevops-templates/bootstrap-jquery-simple-web/blob/master/README.md) | 一 | 一 | 一 | 一 | 一 |
| Node.js | [nodejs-express-hello](https://github.com/iiidevops-templates/nodejs-express-hello/blob/master/README.md) | 一 | 一 | 一 | [nodejs-mongodb-todo](https://github.com/iiidevops-templates/nodejs-mongodb-todo/blob/master/README.md) | 一 |
| PHP CodeIgniter | [php-codelgniter-simple](https://github.com/iiidevops-templates/php-codelgniter-simple/blob/master/README.md) | 一 | 一 | 一 | 一 | 一 |
| PHP Laravel | [laravel-app-template](https://github.com/iiidevops-templates/laravel-app-template/blob/master/README.md) | [laravel-postgres-login](https://github.com/iiidevops-templates/laravel-postgres-login/blob/master/README.md) | [laravel-mariadb-login](https://github.com/iiidevops-templates/laravel-mariadb-login/blob/master/README.md) | [laravel-sqlite-login](https://github.com/iiidevops-templates/laravel-sqlite-login/blob/master/README.md) | 一 | 一 |
| Python Django | [django-testsite](https://github.com/iiidevops-templates/django-testsite/blob/master/README.md) | [django-postgresql-todo](https://github.com/iiidevops-templates/django-postgresql-todo/blob/master/README.md) | [django-mariadb-todo](https://github.com/iiidevops-templates/django-mariadb-todo/blob/master/README.md) | [django-sqlite-todo-test1](https://github.com/iiidevops-templates/django-sqlite-todo-test1/blob/master/README.md) | 一 | 一 |
| Python Flask | [flask-webpage](https://github.com/iiidevops-templates/flask-webpage/blob/master/README.md) | [flask-postgres-todo](https://github.com/iiidevops-templates/flask-postgres-todo/blob/master/README.md) | [flask-mariadb-todo](https://github.com/iiidevops-templates/flask-mariadb-todo/blob/master/README.md) | [flask-sqlite-todo](https://github.com/iiidevops-templates/flask-sqlite-todo/blob/master/README.md) | 一 | 一 |
| Vue.js | [vuejs-app-template2](https://github.com/iiidevops-templates/vuejs-app-template2/blob/master/README.md) | 一 | 一 | | | |
2. 使用範本建立之專案,可至專案列表取得該專案之GitLab 連結。當源碼下載後,再將您的源碼依下面圖示指定位置commit 進去。
![](https://i.imgur.com/bhWJ5PL.png)
2.1 記得調整下載之源碼包內的Dockerfile, 因為docker build 失敗的project 在DevOps也跑不起來哦。
### (3) CI/CD高手應用 - 自己寫測試腳本
1. 平台支援**多檔案 Postman collection** 及 [**Sideex**](https://sideex.io/) 網頁錄制腳本, 請將相關腳本匯出json檔,再commit 至指定位置即可。
* **Postman API** 測試檔案放置位置:iiidevops > postman
* 檔名規則: {prefix_filename}.postman_collection.json (postman UI 匯出規則V2.1)
* **Sideex** 測試檔案放置位置:iiidevops > sideex > sideex.json
![](https://i.imgur.com/yLimsTk.png)
### (4) CI/CD彈性應用 - 誰說每次每個pipeline都要完整跑完
1. 請至選單 個別專案 > 專案設定 內展開「測試工具管理」,預設可直接設定master 分支的 pipeline 測試規劃
![](https://i.imgur.com/7Ppojzj.png)
3. 「進階分支設定」進行各分支的設定管理,例如master 跑完整的,但develop 分支則關掉全部只留源碼掃描的SonarQube或CheckMarx.
![](https://i.imgur.com/gXkCo3V.png)
---
# 開始從頭看一下III DevOps 後台有什麼功能吧
## 系統管理員儀表版
組織管理者登入 III DevOps 系統即呈現所有專案彙整狀況,可點選儀表板內關注的項目呈現明細清單或圖表資訊。
![](https://i.imgur.com/2X39Wsp.png)
## 一、我的工作
1. 可在此切換專案,僅關注特定專案的議題單(工作項目);或者您想跨專案看到所有的議題單,可不選擇專案。
2. 將會列出目前您擁有的議題單(工作項目),點選後可進入議題內容頁面查看詳情。
![](https://i.imgur.com/KC6yn7M.png)
## 二、專案列表
專案經理登入 III DevOps 系統即呈現所負責的專案清單與進度狀況,也可以點選該專案之 Gitlab 知道平台源碼 Repo 位址連結,進行源碼編修。每一專案皆伴隨著三大外掛資源(Gitlab、Redmine、Harbor) 服務連結,提供用戶進階操作的需求與彈性。
![](https://i.imgur.com/UCrg2v1.png)
## 三、專案管理
### 1. 專案總覽
* 進來路徑有二種:
* (1) 於 「專案列表」 點擊您關注的專案後,即可出現其專案總覽
* (2) 直接由 專案管理 > 專案總覽 ,再切換至您關注的專案,亦可顯示該專案之專案總覽
![](https://i.imgur.com/pP85T4V.png)
* 專案總覽區塊分為
* (1) 議題分佈狀態:
列出該專案之議題狀態與其佔量比重, 其圖示標籤都可動態點按切換。
![](https://i.imgur.com/cLO0Eao.png)
* (2) 議題維度統計:
提供 「受分配者」(預設)、「優先權」及「議題種類」等不同維度之分配比重,與上述之「問題追蹤狀態」一樣,其圖示標籤都可動態開啟或關閉關注。
* 受分配者(預設維度):以受分配者為基準統計專案成員於內之工作量
* 優先權:以議題之輕重緩急分析其量化之佔比
* 種類:以議題種類作為分析依據,統計各種類數量及狀態呈現
* 標籤:以標籤作為分析依據,統計數量與狀態呈現
![](https://i.imgur.com/irzQ12j.png)
* (3) 專案成員
羅列出該專案之所有成員清單,若需更改,則請至 專案管理> 專案設定> 專案成員 進行成員管理
![](https://i.imgur.com/LexamTy.png)
* (4) 測試結果
列出各測試工具之最後一次測試結果, 亦可使用右上角之「更新」按鈕進行立即更新報告結果。
![](https://i.imgur.com/F8fyipo.png)
### 2. 工作規劃(WBS)
工作規劃提供預設為需求規格起始之WBS工作項目列表,故若該專案同仁未將契約之最上層需求設定會需求規格(議題類別),則無法正常顯示工作項目列表
* (1). 列表上的小箭頭是可以展開到下一層,預設為全收,僅出現第一層
* (2). Excel 下載-- 目前僅支援到第一層需求規格,未來視需求調整
![](https://i.imgur.com/QWaWtUc.png)
* (3). 顯示欄位可動態調整
* 顯示欄位提供動態調整功能,可透過勾選的方式僅顯示自行指定之重點欄位,預設為全勾全部呈現。
* 此顯示欄位為隨勾隨記憶,故下次再進專案時,已為上次顯示之欄位
![](https://i.imgur.com/sdUBmim.png)
* (4). 進階「篩選條件」
篩選條件,提供更進階之限制範圍,使用者可依需求自定義相關之選擇條件,每個條件皆為單選,且呈現最後各自為交集(and)之篩選結果。其選擇示意如下:
![](https://i.imgur.com/UUfSvuy.png)
* (5). WBS 報表匯出
WBS工作規劃清單支援第一層工作項目之Excel匯出
![](https://i.imgur.com/AHQThgi.png)
* (6). 甘特圖
甘特圖提供另一種WBS的圖形呈現,你可透過甘特瞭解各追蹤項目之期程
![](https://i.imgur.com/ErQMXUK.png)
* (7). 重新刷新頁面、重新取資料
最上方之迴轉圖示,提供該頁面重取資料服務。若需要即時更新,即可點按重拉所有之追蹤議題
![](https://i.imgur.com/YbkjkBn.png)
### 3. 需求追溯
談論需求追溯前,須先讓您瞭解平台支援之議題類別與可使用方式,如此您在使用需求追溯表時,較容易理解其流向之作法與設定。
#### (1) III DevOps 議題類別
III DevOps議題類別支援達9 種左右,使用者可依需求選擇適合自己專案之項目,其類別如下:
![](https://i.imgur.com/BEhPxFe.png)
#### (2) 預設之需求追溯條件
為符合大部分標案之需求,其預設之追蹤條件為<font color=blue>需求規格」->「功能設計」->(功能開發)->「測試計畫」</font>再自動連結至<font color=blue>測試檔案(Sideex/Postman)與測試結果</font>,若欲修改需求追溯之檢核方式可參考[(4)追溯檢核](#4-追溯檢核)進行檢核條件新增或修改
。
![](https://i.imgur.com/QQAzoz8.png)
#### (3) 開始繪製需求追溯圖
![](https://i.imgur.com/ydXXCwT.png)
#### (4) 追溯檢核
* 追溯檢核提供簡易的方式,讓使用者輕易瞭解議題斷鏈,進而執行相關措施。
* 預設為軟體開發週期之 需求 -》設計 -》開發 -》測試(標準檢核模組),當然III DevOps更提供自定義之檢核條件(同時也會繪圖之基礎)設定,讓使用者可依不同專案屬性進行議題追溯與追蹤![](https://i.imgur.com/WBCiL7O.png)
* 操作方式如下:
* 標準(預設條件)檢核
A. Step 1. 確認「檢核模組」(此檢核條件與需求追溯共用同一個條件). 也可透過下拉的方式更改為其他的檢核模組
B. Step 2. 按下「執行需求檢核」,即可立即檢核
![](https://i.imgur.com/R4qD6L3.png)
--
* 設定條件清單
點下「設定條件清單」後,可看到下面圖示,您可透過此介面新增、修改檢核條件,或變更欲用之條件,一次只能一組。<font color=red>注意: 標準檢核模組為系統預設無法提供編輯或刪除</font>。
![](https://i.imgur.com/BniysXU.png)
* 呈上述設定,按下新增檢核模組
下方會出現「檢核模組」與「檢核條件」等輸入框,請您輸入逐一輸入:
A. 檢核模組: 請輸入一組您可識別之名稱。
B. 檢核條件: 此為下拉選項,請依序點出即可。至多僅供應五個條件順序設定。
C. 新增: 按下新增,即可生效。若欲改為其他檢核模組,則可透過最左邊之操作項,「啟用」 是與否進行變更。
![](https://i.imgur.com/N7n2emb.png)
### 4. 專案設定
專案設定三大功能以下逐一說明:
1.專案版本管理:可在此新增專案版本,可編輯專案版本開始日期/到期日期,亦能修改狀態等,在此可看到所有專案版本狀態。
2.測試工具管理:可針對分支勾選需要自動化測試的工具,在跑自動化測試時將會根據分支設定的測試工具進行檢測。
3.專案成員管理:新增專案成員、移除專案成員,並可以使用後面的操作按鈕「議題」來查看該成員是否還有被指派的議題單,如有議題單,是否關閉或轉移給其他同仁,確認無任何議題單後,即可移除該成員。
![](https://i.imgur.com/46zi8Ld.png)
* 查看「專案版本管理」設定細節
* 顯示專案版本名稱、建立時間、到期日、狀態,並可在操作區進行編輯/移除
![](https://i.imgur.com/oLytEFG.png)
* 新增版本
輸入版本名稱/到期日/狀態/描述
![](https://i.imgur.com/3n1e9Ct.png)
* 查看「測試工具管理」設定細節
* 測試工具管理可根據分支設定,並可點選「進階分支設定」進行配置
![](https://i.imgur.com/B3E0Ll1.png)
* 進階分支設定
若有多個分支,可在此勾選進行設定
![](https://i.imgur.com/9FkPlGo.png)
* 查看「專案成員管理」設定細節
* 新增專案成員
點開「新增專員」按鈕,可用姓名、部門、職稱及帳號等資訊搜尋該成員,一次可勾選多筆再一次新增加入。
![](https://i.imgur.com/XPBfB4b.png)
* 操作/議題
若有成員需離退,可在離退前檢查是否還有議題單。
點擊「議題」按鈕,進入議題清單。
![](https://i.imgur.com/sdsPmnX.png)
![](https://i.imgur.com/i7uvr8t.png)
* * 議題清單
![](https://i.imgur.com/zbAB3Vi.png)
* 操作/移除
點擊「移除」按鈕,將移除專案成員。
![](https://i.imgur.com/OMV7GtR.png)
![](https://i.imgur.com/nRg4Mvg.png)
若該成員還有議題尚未關閉,則會彈窗提示,點擊「進行議題處理」,即可轉跳至議題清單進行操作。
![](https://i.imgur.com/UQGlwEQ.png)
* 確認無資料後,即可再次點擊「移除」按鈕,將會彈窗提示您是否確認要移除該成員,確認請點擊「移除」。
![](https://i.imgur.com/1ym5yjY.png)
。
## 四、工作執行
/
### 1. 議題看板
專案經理在專案會議中可透過這專案議題活動功能來引導議題的討論,當了解議題實際的狀態,就可透過拖拉方式進行視覺化的快速變更狀態,讓團隊成員在會議討論過程中就能對議題狀態達成一致的認知。
![](https://i.imgur.com/mlsTXMv.png)
/
* (1) 提供多樣化的欄位篩選,讓看板操作更貼近你想呈現的畫面
![](https://i.imgur.com/0DXcdHj.png)
* (2) 也提供"議題狀態"(預設)、”議題類別”、”專案成員”、”專案版本” 等主要維度切換。但各維度仍可再進行進階篩選(可多選)例如:
* <font color="#00f">**議題狀態**</font> 維度可再進階篩選 其狀態,如 **已開立**、**已分派**、**進行中**、**已解決**、**已確認**、**已關閉**。
* <font color="#00f">**議題類別**</font> --> 研究、功能、臭蟲、文件
* <font color="#00f">**專案成員**</font> --> 則可選擇專案內之所有成員或特定哪些成員
* <font color="#00f">**專案版本**</font> --> 可指定您已設定之版本
![](https://i.imgur.com/TxnRN1s.jpg)
* (3) **快捷項目區**: 不用另外跳出視窗,直接帶出議題內可以設定的項目提供修改
![](https://i.imgur.com/7YkhSBJ.png)
* (4) **右鍵快取選單**: 可右鍵直接更換議題狀態、查看議題關聯圖
![](https://i.imgur.com/CqUPpj3.png)
* (5) **議題關聯圖**: 系統自動將需求追溯心智表繪製完成,可清楚追溯每一個議題
![](https://i.imgur.com/UAZphBQ.png)
### 2. 議題列表
專案議題清單可讓專案經理快速查看專案的重點議題,也可以快速建立主議題與子議題,讓專案的工作項目清楚列管,此功能與 Redmine 雙向同步,讓習慣 Redmine 介面的團隊成員可繼續使用 Redmine 作業。
![](https://i.imgur.com/PSpDRZB.png)
本頁面提供快速開立議題與進階篩選等功能,以下將逐一說明:
* (1) 議題快速開立
點擊 1 新增議題,即會出現 2 及 3 的輸入視窗,您僅需指定議題類別及議題,即可馬上建立一張新議題。待後續需求,還可再進該議題單進行編修。
![](https://i.imgur.com/3glldpV.png)
* [使用者介面操作教學影音(請點這裡)](https://www.youtube.com/watch?v=CK04c2cPGh8&list=PLJS2VJenopmdArR3d10PclXtxPdMD8RT-)
{%youtube CK04c2cPGh8 %}
* (2) **右鍵快取選單**: 可右鍵直接更換議題狀態、查看議題關聯圖
![](https://i.imgur.com/VolEWY1.png)
![](https://i.imgur.com/UAZphBQ.png)
### 3. 備忘記事
* #### 備忘記事入口
左側選單 > 工作執行 > 備忘記事
* #### 如何使用 "備忘記事" 快速建立團隊的知識庫呢?
核心概念:可協助團隊收集及擷取知識、集結來自**所有人都能編輯**的內容,以及分享計劃與創意想法。 例如:可建立團隊需要的技術筆記、小組成員資訊、教育訓練手冊、需求分析與操作手冊等。
* #### 來建立屬於團隊的備忘記事吧!
進入備忘記事頁面
![](https://i.imgur.com/EjKWx8U.png)
新增記事,點擊「新增記事」按鈕
![](https://i.imgur.com/aYMQDeC.png)
出現編輯頁面
![](https://i.imgur.com/7Mspwg8.png)
* 1.WYSIWYG 編輯器模式,所見及所得
![](https://i.imgur.com/VJYQScU.png)
* 2.Markdown模式
![](https://i.imgur.com/1ZzMxiY.png)
* 建立完成一則團隊筆記,回到列表查看
![](https://i.imgur.com/RBWBBqb.png)
* 操作區按鈕
![](https://i.imgur.com/pDqMQyp.png)
* 操作/內容 (Read only)
本頁面僅供閱讀,不可編輯
![](https://i.imgur.com/A2fh0Wu.png)
* 操作/編輯
所有成員皆能編輯同一則筆記
![](https://i.imgur.com/z6QcW7e.png)
* 操作/刪除
點選「刪除」按鈕,會出現提示框,請再次確認是否要刪除
![](https://i.imgur.com/N3xRMDK.png)
### 4. 檔案列表
專案管理中時常需要的文件等檔案,都可運用此功能上傳後做統整。團隊的所有成員都可自由運用此功能將相關文件、需求文件、研究文件等上傳。
本節介紹檔案列表的操作入口及功能。
* 檔案列表入口
左側選單 > 個別專案 > 檔案列表
![](https://i.imgur.com/1vI3HP3.png)
* 建立檔案
溫馨提醒:一次只能選擇一個檔案
![](https://i.imgur.com/UTgJtH6.png)
![](https://i.imgur.com/hfeoM3O.png)
* 上傳完成
一起維護檔案列表,查看最新團隊文件吧!
* 1.檔案編號:全部專案的檔案都有一個編號,編號是唯一值。
2.名稱:自定義名稱+上傳檔案的格式
3.建立者:顯示建立者名稱
4.建立時間
5.操作:下載/刪除
![](https://i.imgur.com/PvhdMrx.png)
### 5. 版本歷程
版本歷程是針對專案內的所有工作項目進行圖形化顯示,可一目瞭然人力配置、議題數量、進度呈現,在規劃新需求或功能時會根據不同專案版本新增議題及規劃管理。
* 版本歷程入口
左側選單 > 工作執行 > 版本歷程
![](https://i.imgur.com/FaarEwl.png)
* 頁面說明
* 本頁面將會列出所有專案版本,顯示進度條、議題數量,並可展開單一專案版本進行工作項目清單查看、議題狀態查看。
![](https://i.imgur.com/g4MoxrM.png)
* 可點選單一版本,展開圖形化總覽
![](https://i.imgur.com/3Jugv4L.png)
### 6. 釋出版本
釋出版本提供打包專案原始碼紀錄版本,可匹配正式發布時間點打包專案版本,紀錄發布時間與版本,打包前需「檢查議題」來檢視版本內是否還有議題尚未關閉,若未關閉的議題可以批量關閉或批量搬移,確認議題都關閉的狀態下才能開始進行打包作業。打包完成後,您選取的專案版本會關閉,如需繼續使用專案版本,可至「專案設定」>「專案版本」> 「開啟」您需要的專案版本。
常見操作說明:
* 釋出版本入口
左側選單 > 工作執行 > 釋出版本
![](https://i.imgur.com/oaeWuT3.png)
* 開始打包專案,可以跨版本打包喔!
1. 點選按鈕「包版作業」
![](https://i.imgur.com/9OZU5b6.png)
2. 出現下拉選單可選擇專案版本,在點選按鈕「檢查議題」
![](https://i.imgur.com/5FfCznc.png)
3. 檢查議題後,若有未關閉的議題將會提醒您,並可在頁面操作批量關閉或搬移
![](https://i.imgur.com/C8GwZ4q.png)
![](https://i.imgur.com/JPGE4r6.png)
4. 議題關閉或搬移完畢後,就可以進行包版囉!
![](https://i.imgur.com/YFvXSzZ.png)
確認分支、映像檔、輸入版本說明,即可點選「開始包版」按鈕進行包版
![](https://i.imgur.com/hOccGX6.png)
5. 包版完成! 查看包版紀錄
![](https://i.imgur.com/wkzJ1AY.png)
## 五、開發進度
本章節提供所有程式提交、Pipeline執行狀況與資源監控等訊息。
### 1. 開發分支
開發分支列出本專案之所有分支,提供每一分支目前之更新狀態與最後一次提交之程式目的與更新時間
![](https://i.imgur.com/sezkfFv.png)
### 2. Pipeline
III DevOps Pipeline 之運作監控頁面,提供使用者一直覺與互動之操作介面
(1) 列表名稱狀態說明
* 狀態/測試項目
狀態有 Queuing(佇列等待中)、Waiting(等待中)、Building(建置中)、Failed(執行失敗)與Finished(執行完成)等狀態,以下針對需要注意的狀態分別說明:
![](https://i.imgur.com/TC0KfJ1.png)
* <font color=blue>Queuing </font>: 在佇列等待時,表示Pipeline 正忙碌中,請稍後再觀看是否已經開始進行,若等待超過一個小時,請通知系統管理者。
* <font color=blue>Failed</font>: 執行失敗時,
A. 請確認是否為Docker Build失敗,若是,請確認是否能在本機執行,再上傳至平台。
B. (商用版)若為CheckMarx失敗,請確認您是否上傳一種以上主要的程式開發語言,若是,請麻煩單純化您的專案,以確認運作正常。
C. 若顯示為其他異常(如網路)時,請再重新執行Pipelin,有時是因為Pipeline忙碌而造成異常。
* <font color=blue>Finished</font> : Pipeline 執行完成,僅代表工作完成,並不代表所有工作已執行成功,尤其測試工具的執行結果,需要至測試紀錄進行確認。
* 操作
* 細節:
可看到Pipeline 所有執行工作之狀態與LOG,若有異常也可至這裡確認其錯誤訊息
![](https://i.imgur.com/ZP6wFzE.png)
* 重行運行: 可再次重新執行該Commit之Pipeline工作
* Pipeline 設定
提供使用者更改Pipeline設定,並可直接執行或儲存腳本草稿
Step 1 : 選擇分支 (例如: master / develop ..etc)
Step 2 : 可選擇 「儲存」草稿 或 「直接執行」
![](https://i.imgur.com/PtJrd91.png)
* 報告
本報告彙整此Pipeline執行時所產生之測試報告,並提供Excel、PDF等報表格式下載
![](https://i.imgur.com/hpG27Va.png)
### 3. 實證環境
實證環境,提供有WebServer環境之專案,一直接連入的可能,如網頁,其將直接另開一網頁供檢視; 而資料庫,則會顯示其連線之IP/Domain name , 與Port供複製使用
(1) POD 命令列視窗
提供使用者一網頁式的K8S資源操作與LOG檢視
![](https://i.imgur.com/jZwGSjx.png)
* 互動式命令列
![](https://i.imgur.com/b9UkPWW.png)
* LOG
![](https://i.imgur.com/ZH4HmQP.png)
(2) 網頁
![](https://i.imgur.com/20EjSYB.png)
![](https://i.imgur.com/HUneV9e.png)
(3) 資料庫
![](https://i.imgur.com/aRVRvja.png)
### 4. Kubernetes資源
* 此頁面列出所有本專案使用之資源監控,同時亦提供POD(pipeline 運行之工作項目)之資源狀態。
![](https://i.imgur.com/VecNt6w.png)
* 點入POD之詳細資料後,可顯示最後一次Pipeline運行之工作項狀態與LOG
* Terminate : 指該項工作已完成,且無異常
* Running: 其工作項運行中,且可觀視即時LOG與支援命令列操作。
* 後面的 ... 操作項提供同實證環境之K8S 的LOG與命令列視窗
![](https://i.imgur.com/B9GjeNw.png)
## 六、測試管理
測試管理模組提供您直接在UI頁面上傳腳本後可以新建"測試計畫"議題單唷!
直接在UI頁面操作新增/刪除/編輯,還有關聯議題單與新建測試計畫,<u>**這樣做能讓您達到需求追溯的完整性,保存每一次的測試紀錄與議題關聯**</u>,在使用需求追溯表產生圖形化顯示時,直接呈現從需求規劃到測試結果的每個歷程點。
![](https://i.imgur.com/ZxChqb1.png)
### 1. 測試檔案
### 讓我們來建立第一個測試腳本與測試計畫吧!
* 點選進入「測試檔案」頁面
可以看見有範本預設寫入Gitlab files的兩個腳本json檔,在此你可以按「上傳測試集」
![](https://i.imgur.com/Q9EJ40W.png)
![](https://i.imgur.com/yOj2v0H.png)
* 上傳腳本
![](https://i.imgur.com/GNQe9zX.png)
![](https://i.imgur.com/216GmJo.png)
* 操作區介紹
![](https://i.imgur.com/HPGvnwX.png)
* 操作/編輯
讓您可以直接關聯已開立的議題單!
![](https://i.imgur.com/NJ1pPLz.png)
![](https://i.imgur.com/cSFIxQo.png)
![](https://i.imgur.com/Cb817gA.png)
* 操作/新增計畫
還沒有"測試計畫"議題單沒關係,直接新增一個,請點選「新增計畫」。
![](https://i.imgur.com/JgEg3vW.png)
輸入議題內容後,按「儲存」,會立即顯示您的議題單內容。
![](https://i.imgur.com/CTFnl1P.png)
![](https://i.imgur.com/9ua9Ltr.png)
* 操作/刪除
彈框提示您是否確認要刪除。
![](https://i.imgur.com/wPMObKW.png)
### 2. 測試計畫
### 統整您所有的"測試計畫"議題單,一目瞭然
可透過勾選區,選取您想匯出的測試計畫,可下載CSV檔供您統整數據或追蹤使用。
![](https://i.imgur.com/RZWa93c.png)
### 測試管理頁面加值功能看這邊! 需求追溯表幫您顯示完整歷程
1. 右側選單選取"需求追溯表"功能頁
2. 種類選取"測試計畫"
3. 按 開始繪圖 按鈕
4. 繪製完成測試計畫需求追溯圖表
5. 可下載不同類型檔案(Excel, pdf)呈現您的需求追溯
![](https://i.imgur.com/5cnLU4w.png)
/
# 常見問題
## Gitlab 密碼問題
#### 1. AD 密碼到期重設後,Gitlab介面驚見重設密碼畫面
![](https://i.imgur.com/RpPdFOP.png)
[回答]: 因密碼為DevOps 代為更改密碼,故GitLab UI 會因安全機制跳出重設密碼視窗。但本機端的 commit 不受該機制影響。
<font color='red'>[很重要] 在重設密碼視窗,如上圖所示,請輸入AD新密碼三次即可(GitLab默許設定一致)。</font>
#### 2. 忘記密碼,請直接與DevOps客服窗口聯繫,或直接Teams corilin , 請不要按重設密碼。
![](https://i.imgur.com/taNcvm4.png)
#### 3. Java spring gradle 注意事項
1. 確認您專案的 gradle 版本,並將它改至專案的 Dockerfile
![](https://i.imgur.com/8eYIsyE.png)
![](https://i.imgur.com/u9BKMUi.png)
2. 若欲使用SonarQube,則請將下列文字新增至 build.gradle 的檔案裡。
```
plugins {
id 'org.springframework.boot' version '2.3.3.RELEASE'
id 'io.spring.dependency-management' version '1.0.8.RELEASE'
id 'java'
id "org.sonarqube" version "3.1.1"
}
```
2.1 填入位置可參考下列圖示所示
![](https://i.imgur.com/FZL7uD3.png =120%x)
# 聯絡方式
* 服務窗口: devops@iii.org.tw
* [III DevOps YouTube 介面操作教學影音頻道](https://www.youtube.com/watch?v=CK04c2cPGh8&list=PLJS2VJenopmdArR3d10PclXtxPdMD8RT-)
{%youtube CK04c2cPGh8 %}