iT邦幫忙

2023 iThome 鐵人賽

DAY 11
0
DevOps

Azure DevOps Troubleshooting and best practices 系列 第 11

Azure DevOps migration - 如何搬移 Wiki 至不同 Project

  • 分享至 

  • xImage
  •  

前言

Wiki Page 是 Azure DevOps 重要功能之一,舉凡產品相關、新人 onboard 注意事項、平台公告、團隊大小事與標準作業流程... 等,是很重要的存在。身為千人使用的平台服務管理人員,每天會面對的使用者詢問是一般 IT 人員難以想像,尤其遇到剛上任的新人,教訓訓練與標準流程文件是非常重要的,可以降低管理人員很大的負擔。

https://ithelp.ithome.com.tw/upload/images/20230926/20091494XKo4lsb3SK.jpg

 

Wiki Page 本身即是一個 Repository,除了可以透過 Azure DevOps Portal 直接編輯外,遇到大量文件與結構需要調整的時候,使用者可以透過 Git 將 Markdown 文件下載至本地端,編輯後再一口氣推送上去,完成工作。

https://ithelp.ithome.com.tw/upload/images/20230926/20091494FR5sW9vi3N.png

 
 


如何搬移 Wiki Page

於專案內點選左邊 Wiki 功能,點選 Wiki 旁邊 ... 按鈕,選擇 Clone Wiki
https://ithelp.ithome.com.tw/upload/images/20230926/20091494JgZiz8x8mO.png

 

複製 Git URL
https://ithelp.ithome.com.tw/upload/images/20230926/20091494N4TWXqewYW.png

 

Git 使用方式很多,本篇文章我們透過 Visual Studio Code 來 Clone Wiki Repo。Visual Studio Code 是非常好的 Markdown 編輯器,你可以一邊編輯一邊預覽畫面。於歡迎畫面點選複製 Git 儲存庫,貼上上一個步驟取的 Git URL。
https://ithelp.ithome.com.tw/upload/images/20230926/20091494ZYi7PExAWe.png

 

選擇要存放的資料夾,點選選擇資料夾
https://ithelp.ithome.com.tw/upload/images/20230926/20091494M1IhBvQDKk.png

 

接下來可以在 Visual Studio Code 內看到 Wiki Repo 所有檔案,你現在可以開始編輯哩! 完成後只需要透過 Git Commit 與 Push 即可。當使用者有大量 Wiki Page 需要整理時,這是一個非常棒的方法
https://ithelp.ithome.com.tw/upload/images/20230926/20091494gyk1V4U3tG.png

 
 

Wiki 最佳實踐:相同專案內不同 Wiki,並設定權限限制存取

相同專案內,有些 Wiki Page 可能公開給組織內所有人檢視、有些可能是內部團隊檢視。難道一個 Project 只能有一個 Wiki Repo 嗎? 其實不然,你可以先從 Azure Repo 內建立新的 Repository,如下面兩張圖所示,建立你要放 wiki 的儲存庫。
https://ithelp.ithome.com.tw/upload/images/20230926/20091494d1epiYDgKw.png

https://ithelp.ithome.com.tw/upload/images/20230926/20091494Rcnlc9aUFo.png

 
接下來回到 Wiki,點選上方下拉選單,選擇 Publish Code as Wiki,輸入選擇儲存庫、分支、資料夾名稱與 Wiki 名稱,點選 Publish 按鈕即可建立新的 Wiki。
https://ithelp.ithome.com.tw/upload/images/20230926/20091494bKJk0SNh35.png

https://ithelp.ithome.com.tw/upload/images/20230927/20091494Js6cv4vdZi.png

https://ithelp.ithome.com.tw/upload/images/20230927/20091494nqaGeNooAZ.png

 

透過這種方式建立的 Wiki,可以在 Project Setting > Repositories > [你的 Wiki Repos] > Security 即可設定全縣
https://ithelp.ithome.com.tw/upload/images/20230927/20091494pdPXOYCgRp.png

 

Project 預設的 Wiki Security 則在右邊 ... 按鈕,選擇 Wiki security 即可設定權限
https://ithelp.ithome.com.tw/upload/images/20230927/20091494RE0vBgNLui.png


上一篇
Azure DevOps - Project 架構與搬移說明
下一篇
Azure DevOps migration - Azure Board 介紹與搬移 (上)
系列文
Azure DevOps Troubleshooting and best practices 30
圖片
  直播研討會
圖片
{{ item.channelVendor }} {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言