余小章 @ 大內殿堂

在 Windows 的環境，要使用 Docker 除了 Docker Desktop  之外，也可以使用  WSL + Docker 來完成環境的搭建

Docusaurus (Document（文件）+ saurus（恐龍）)，是由 Facebook 推出的開源靜態網站生成工具，以 React 技術構建，提供快速建置以文檔內容為核心的網站。我在 Survey 有哪些框架可以快速的把一堆 OpenAPI 文檔，轉成靜態頁面並且搜尋頁面內容，Claude 推薦我使用 Docusaurus

Sonatype Nexus Repository 是一款支援多種協定的 Artifacts Management 成品管理工具，

下圖出自：Sonatype Platform Integrations | Sonatype 

Docker Image 現在已經應用程式產出的標準配備，想要利用 Nexus 建立 Private Docker Image Registry，當我要 Push Docker Image 時碰到了一些小亂流特此記錄下操作步驟。

我只是想要內嵌 Markdown 到 OpenAPI.yaml 裡，並且用 Redoc 產生出靜態檔案，就卡了一個下午，這沒有筆記一下接下來一定會忘記的，參考連結在這裡 Embed Markdown in Redocly API reference docs

在測試時，TestContainers 它可以簡化我們產生 Container 的步驟，配置 Container 的方式也相當的簡單、明確；從同事得知 TestContainers，周末則來研究一下使用方式。

我使用預設的 System.Text.Json 反序列化時 JsonSerializer.Deserialize<Dictionary<string, object>>(json)，得到 JsonElement，再透過 JsonElement.Get 系列的方法才能取得正確的資料，這樣有點繁瑣，為此我找到了解方，自行實作 JsonConverter，緊接著，來看看我怎麼處理的

Allure TestOp 是一套可以將測試結果產生成漂亮的測試報表，支援很多測試框架和 Cucumber/Gherkin 語言，我將專注在 .NET，接著，就來動手實作吧。

sqlpad 是 Web Base 的 SQL 編輯器，可用於編寫和運行SQL查詢並可視化結果，通過 ODBC 支持 Postgres、MySQL、SQL Server、ClickHouse、Crate、Vertica、Trino、Presto、SAP HANA、Cassandra、Snowflake、Google BigQuery、SQLite 等。

以往都是使用 localdb 來進行開發和自動化測試，但它只能支援 Windows 平台，若是要跨平台，SQL Server 容器是選項之一，接下來我們就來看看要怎麼使用。

跟資料庫有關的測試可以稱操作資料庫的動作是倉儲(Repository)物件的單元測試，或者是，商業邏輯物件和倉儲物件的集成測試，不管怎麼叫，基本上對於資料庫的操作案例也應該會涵蓋到；原則上，案例不會多，至少會有一個，再重要性來決定要不要增加。

由於 .NET Core 跨平台，除了可以部署在 VM 的 IIS 之外，Docker 也是選項之一，它的使用體驗甚至比 VM 還要來的好，部署速度也比 VM 快很多