範例總覽
這些範例出自框架的驗證矩陣:11 個各自獨立的情境,每個證明一個具體行為。情境腳本沒有隨框架發佈,所以下面的子分頁列出每個情境的重點檢查與可複製的片段,讓你在自己的專案重現同樣的性質。
- 測試 token:打過 auth 的情境都需要 JWT。用專案自帶的
auth簽一顆,見取得開發用 token。 - port:片段打的是
:18080(以GORTEXA_SERVER__ADDR=:18080啟動伺服器,或自行改片段裡的 port);啟動後輪詢/readyz才開始探測。 - 清理:自己啟動的 server 都要收掉(
trap cleanup EXIT,NATS 則用docker compose stop),每項檢查才能重複執行。 - 依賴:只有兩個 NATS 系情境(core 與 JetStream)需要 docker,其餘純本機二進位。
- 開發流程:scaffold 全程、同一實體跨三協定。
- 安全與邊界:auth 拒絕不洩漏、secret 啟動安全、header allowlist、reflection 閘。
- 契約與韌性:buf breaking gate、SIGTERM 優雅排空。
- AI 與訊息:export tool schema、NATS/JetStream 整合。
- 完整範例:
go get後把公開元件接成一支服務,附完整、逐段註解的main.go。