Duran 的技術冶煉廠

本篇文章記錄舊版本 Team Foundation Server (現稱 Azure DevOps Server) 升級至新版本 Azure DevOps Server 其中一種方式：透過 Team Foundation Server Tools 備份還原功能進行升級。Team Foundation Server Tools 大致上可以分成兩種：

1. Team Foundation Server Power Tools (需另外安裝，適用於 TFS 2010 使用) 
2. TFS Database Backup/Restore Tool (不須另外安裝，適用於 TFS 2012 以上版本)

因為微軟官方已經將連結移除，這裡提供之前我使用的版本，下載前請先看過最下方免責聲明，若有疑慮請勿下載：

https://distudio.blob.core.windows.net/duran/LPSV2.D1.zip

免責聲明:

本網站對於任何使用或引用本網站網頁資料引致之損失或損害，概不負責。本網站亦有權隨時刪除、暫停或編輯本網站所登載之各項資料，以維護本網站之權益。除法律有強制規定外，在任何情況下，本網站對於 (1) 使用或無法使用本網站之各項服務；(2) 經由本網站取得訊息或進行交易；(3) 第三人在本網站上之陳述或作為；以及 (4) 其他與本網站服務有關之事項所致生之任何直接、間接、附帶、特別、懲罰性或衍生性損害，一概不負賠償責任。

 前言

這是 Azure DevOps Server 2020 安裝筆記，安裝過程中有許多選項，若有些內容用不到則不需要勉強安裝，越多的安裝選項會需要設定更多內容 (如：防火牆、連接埠...等)。一般來說如果您需要安裝離線版，多數是資訊安全限制且有網路限制的環境，若是無法對外連線至特定服務 (如：下載 JRE)，則有較多事前準備工作，要有心理準備。請先確認注意事項，滿足條件後再開始進行安裝。

建立 Application Insights 服務有下列方法：

1. 在 Azure Portal 建立 Application Insights 服務
2. 在 Visual Studio 新增 Application Insights 服務
3. 在 App Service 啟用 Application Insights 服務
4. 在 虛擬機器 啟用 Application Insights 服務
5. PowerShell 或 Azure CLI  以指令方式新增 Application Insights 服務

 前言

最近因為工作關係，想要在 Azure 上啟用一台 Windows 10 並安裝 Docker Desktop for Windows 進行開發與測試。沒有想太多直接開虛擬機器直接進行，沒想到失敗好幾次，簡單紀錄一下哪一個規格的 Windows 10 VM 可以成功，提供給有興趣的朋友參考。本篇文章若有錯誤或任何建議，請各位前輩不吝提出，謝謝。

Application Insight 也適用於地端伺服器 (on-premises servers)，若您有內部伺服器使用 IIS 部署 ASP.NET 程式，則可以安裝 Application Insights Agent 進行監控。使用 Agent 最大的好處就是不需要修改程式碼並且重新部署，只需要透過 PowerShell 進行 線上 或 下載檔案 方式安裝。本篇文章將簡單介紹如何部署 Application Insights Agent 於地端伺服器，若有錯誤或任何建議，請各為前輩不吝提出，謝謝。

ASP.NET MVC 網頁應用程式 (含 ASP.NET Core MVC) 與過去 Web Form 專案架構有所不同，所以在使用 IIS IP 位址與網域限制功能時並沒有這麼的直覺。過去在 ASP 或 Web Form 應用程式，只需要 內容檢視 > 選取該 asp 或 .aspx 檔案 > 切換功能檢視 > IP 位址與網域限制，即可限制該網頁存取。

但 ASP.NET MVC 應用程式 (包含 ASP.NET Core MVC) 呢? 似乎沒有辦法透過 IIS 介面方式進行設定 ?   實際上是可以的，本篇文章皆簡單介紹如何透過 IIS IP 位址與網域限制功能 對 ASP.NET MVC 應用程式中特定網頁限制存取，若有錯誤或任何建議，請各位先進不吝提出。

對於開發人員而言，如何在 Production 發生問題找到 root cause 是一門學問，有別於在開發環境可以透過 Debug 工具找出問題，Production 需要在不影響維運與資訊安全情況線發現問題所在。舉三個例子：

1. 在開發與測試環境，你可以隨意輸入測試資料以檢測問題所在，但在 Production 環境，你不應該也不被允許進行測試，因為可能會影響正常營運。
2. 測試環境出錯時，你可以將詳細錯誤訊息顯示在畫面上，但在 Production 環境，詳細的程式訊息很可能變成有心人攻擊的目標。
3. 開發過程中，程式邏輯錯誤發生在你撰寫程式、執行程式時，但在 Production 環境，錯誤可能發生在下班時間。 

不知道如何在 Production 發現效能問題?  那你一定不知道 APM

 因為 Markdown 容易撰寫的特性，除了部落格，越來越多文件透過 markdown 撰寫 (副檔名 .md)，但仍有許多客戶因為不熟悉 Markdown，手邊一時之間也沒有工具可以瀏覽，希望能使用既有的 word 、pdf 格式觀看文件，這時候就遇到格式轉換問題。 今天要介紹這一套萬用文件轉換工具 Pandoc，除了能達到 Markdown 轉換成 docx，也支援相當多輸出、輸入格式，相當方便。

 因為工作關係，遇到有個 App Services 需要從 Azure Key Vault 上取得連線字串與秘密 (Secrets) 需求。實作的方式相當多種，這次是以角色為基礎的存取控制 (Role-Based-Access-Control) 方式來存取 Azure Key Vault，達到可以不需要儲存任何 秘密資訊 在 web.config 、 appsetting.json 或 寫死程式裡，只有該授權的角色可以取得秘密資訊的效果。本篇文章若有錯誤或任何建議，請各位前輩不吝提出。

 因為工作的關係常常需要搭乘高鐵，累積了不少的點數，這些點數可以用來兌換 車票 與 商品 (詳細兌換內容可以參考 高鐵會員TGO、高鐵會員TGO點數 365)。在累積紅利點數前，記得先申請會員，在購買車票、回數票 與 月票時輸入會員編號即可累積。 整體算起來回饋雖然不多 (約等同票價 9 折)，但常常出差的朋友，可以考慮累積點數來兌換車票、商品過過癮。

想要累積點數，記得先加入會員

 終於到 如何為 ASP.NET Core 與相依服務建立執行狀態檢查 系列文章最後一篇：自訂 Health Checks 監控 Shared folder 狀態。 若讀者有閱讀原始碼： AspNetCore.Diagnostics.HealthChecks(GitHub) 或微軟文件：ASP.NET Core 中的健康狀態檢查，應該會發現 HealthChecks 提供非常多的套件讓你監控多種服務運作狀態。但偶有些想要監控的服務沒有套件支援，那該怎麼辦呢 ? 在這一篇文章我們會給簡單的範例，說明如何自訂方法來監控分享資料夾 (Shared folder) 是否可用。

本篇文章範例位置：HealthCheckDemo ，若覺得講解內容過於陌生，建議從第一篇開始閱讀

透過 HealthChecks在監控各種服務時，您能為每個服務加上標籤 (Tags)，後續自訂 Health Check Response 時即可透過這些標籤進行過濾動作，只取得/排除特定標籤服務運作資料。當您遇到下列者幾種情境，HealthChecks 的 Tags 可能會幫上不少忙：

1. 管理人員/監控軟體 會將服務做分類，會比較方便進行監控與釐清問題，像是以網站/資料庫/儲存體分類
2. 依據權限分類，DBA 只能看見目前 資料庫 運作情況，而維運人員可以看見所有服務運作情況

 經過前面三篇文章的介紹，我們已經知道如何安裝設定 HealthChecks、監控多個相依服務 與 自訂 HealthChecks 呈現結果(呈現每個相依服務)。在這一篇，我們將簡單介紹如何透過相關套件，讓相依服務運作狀態以圖形化介面呈現。

本系列實作的範例程式：HealthCheckDemo

透前一篇： Health Checks 監控 SQL Server, WebAPI 與 Redis 健康狀態， 你大概已經知道如何監控不同的服務，但總會懷疑為什麼只能取的整體的狀態態，我們能不能看到每一個服務的狀態呢？ 答案是肯定的，本篇文章將簡單介紹如何自訂 Health Checks Response，讓所有的服務運作情況一目了然！

那有美美的圖形介面給老闆看? 答案是有的，在下一篇：ASP.NET Core Health Checks UI 圖形化介面呈現服務健康狀態 會詳細說明。

 最近在 Facebook 時常常發現自己舊樣板的 Blogger 無法正常顯示圖片，但在 編輯貼文 或 貼在塗鴉牆時卻可以正常顯示。在透過 Facebook debug tool 處理後，在預覽時可以正常呈現，告知錯誤訊息：

缺少以下必要資訊 og:image
缺少以下必要資訊 og:site_name
缺少以下必要資訊 og:title
缺少以下必要資訊 og:url

 上一篇文章 ASP.NET Core Health Checks 安裝與設定 中我們簡單說明如何設定並回覆目前網站運作狀態。但 HealthChecks 套件不僅僅如此而已，還能監視 SQL Server(資料庫), Redis(快取服務) 與其他 WebAPI 營運狀態。本篇文章將分別介紹如何設定這三項服務監控，若有錯誤或任何建議，請各位先進不吝提出，謝謝。

本系列實作的範例程式：HealthCheckDemo

監控在重要系統維運是非常重要的一環，隨時注意 網站、服務、伺服器 與 資料庫 運作是否正常。 在ASP.NET Core 2.2 - 3.1 有個相當好用套件 - HealthChecks，讓開發人員可以透過撰寫簡單設定語法建立健康檢查機制，確認目前服務營運是否正常。他支援的服務相當的廣，除了簡單的 WebAPI、SQL Server，還支援 RabbitMQ、Redis、Azure Service Hub、Kafka、MongoDB、Kubernetes、SignalR...等多項服務 (可以參考 AspNetCore.Diagnostics.HealthChecks - GitHub)

前陣子協助客戶啟用 SQL Server 保存工作階段 (SessionState) 狀態資料過程中，客戶提到 正式環境(Production) 有啟用 AlwaysOn 可用性群組。 而在 啟用 SQL Server 保存工作階段 所建立的資料庫，會建立 SQL Agent Job，定期刪除過期資料 (DeleteExpiredSessions)。 因為 Secondary replica database 為 ReadOnly，故會得到錯誤訊息：

Failed to update database "ASPState" because the database is read-only

透過 SSMS 展開該資料庫 (預設名稱為 ASPState，若建立過程中，有自訂名稱則請選擇正確的資料)。在 SQL Server Agent > 作業 (Job) >看見 ASPState_Job_DeleteExpiredSessions 作業。

 最近常常遇到運行一段時間的 Windows 虛擬機器 無法遠端連線的情況發生，這裡提供一些常見的情境(忘記密碼 與 內部發生錯誤) 與 解決方法給有興趣的朋友參考。 

注意：本篇所提供方法僅供參考，並不為管理上與使用之資訊安全性背書，對於任何使用或引用資料引致之損失或損害，概不負責。用遠端連線有風險，建議若非必要，請使用 Azure 堡壘 (Azure Bastion) 或其他更安全方式進行管理

因為工作關係，需要驗證 Azure DevOps Server 與 GitLab 之間，能不能互相整合 repositories，開啟這一篇安裝 GitLab 之旅，並簡單紀錄一下如何快速在 Azure 環境安裝 GitLab 流程，提供習慣使用 GitLab，但又沒有伺服器 (或不想花時間安裝 linux) 的團隊參考。本篇文章若有錯誤或建議，請各位前輩不吝提出。

 近年來， Markdown 語法越來越熱門，他的易讀、快速撰寫的特性深受許多人喜愛，是一種網路內容的寫作、上稿用語言。久而久之，支援 Markdown 的編輯器也越來越多。你知道嗎 ? Notepad++ 除了比對功能，也可以支援 Markdown 檢視 與 HTML 轉換唷 !

 因為工作關係，偶爾需要協助客戶解決關於 IIS 中、高風險資安問題。這邊簡單記錄一下如何解決這次弱點掃描發現的問題：HTTP Options Method Enabled ，並提供給有相同問題的朋友參考

前言

Azure DevOps Agent On Linux 與其他 CI/CD 一樣，安裝相當簡單，且可以安裝在 Windwos/macOS/Linux 作業系統上。有很多朋友問到 Linux Agent 與 Windows Agent 有什麼不同，這裡簡單條列一些特性，讓大家理解要哪一種比較適合自己

1. Linux Agent 一般情況下，執行速度較快，且 Azure Linux VM 較便宜
2. Windows Agent 一般來說較為安全 (對於資安完全沒經驗的朋友，使用 Windows 會輕鬆一點)
3. 若您的程式是 .NET Solution (非.NET Core)，只能在 Windows 作業系統進行 Build，請選擇 Windows
4. Java ...等具跨平台特性 Solution，可以在 Linux 與 Windows Agent 執行
5. 找一個您熟悉的平台，安裝套件時比較不會這麼辛苦

本篇文章將一步步說明如何安裝與設定，給有興趣的朋友參考。若有任何錯誤或建議，請各位前輩不吝提出，謝謝。

若您想要知道如何安裝 Agent  在 Windows 上，請參考這篇：
Azure DevOps Agent 安裝流程說明 (Install Windows Agent)

過去在開發 ASP.NET 網站應用程式時，若想要使用者強制透過 HTTPS 瀏覽網站，我們會使用 IIS Rewrite Module 來進行轉址。通常會在首頁、註冊/登入、付款...等，網頁進行 Rewrite 進而確保安全性。 在 ASP.NET Core 專案中，開發人員透過現成的 Middleware ，可以更輕鬆的控制路由。本篇文章將簡單介紹如何設定自動將使用者從 HTTP 轉向 HTTPS，若有任何錯誤或建議，請各位前輩不吝指教，謝謝。 

註：本文章環境為 .NET Core 3.1