Central Dogma REST API 完全參考讓配置管理實現自動化【免費下載鏈接】centraldogmaHighly-available version-controlled service configuration repository based on Git, ZooKeeper and HTTP/2項目地址: https://gitcode.com/gh_mirrors/ce/centraldogmaCentral Dogma 是一個基于 Git、ZooKeeper 和 HTTP/2 構建的高可用、版本化服務配置管理倉庫專為存放 JSON、YAML、XML 等配置而設計。它提供了完整的Central Dogma REST API讓團隊可以用curl、腳本或任何編程語言輕松讀取配置、提交變更、回滾歷史真正實現配置管理的自動化。本文是一份面向新手和普通用戶的Central Dogma REST API 完全參考從端點概覽到實戰示例一次講透。Central Dogma REST API 基礎端點、版本與認證所有 REST 接口統一掛在/api/v1前綴下服務端默認監聽36462端口。核心實現位于服務端的 ProjectServiceV1.java、ContentServiceV1.java 等文件中。調用前你只需記住三個概念路徑語法采用 Unix 風格/projFoo是項目/projFoo/repoA是倉庫/projFoo/repoA/samples/a.json是文件。Revision修訂號-1表示最新版本1、2等正整數表示歷史版本幾乎所有讀接口都支持revision參數。認證啟用安全模式后通過Authorization: Bearer token請求頭攜帶令牌。# 快速自檢列出所有項目 curl http://localhost:36462/api/v1/projects項目管理 API一鍵創建與刪除項目是配置的頂層隔離單元。常用端點如下方法端點用途GET/api/v1/projects列出全部項目POST/api/v1/projects創建項目GET/api/v1/projects/{name}查看單個項目DELETE/api/v1/projects/{name}刪除項目可恢復curl -X POST http://localhost:36462/api/v1/projects \ -H Content-Type: application/json \ -d {name: projFoo}前端 apiSlice.ts 中對項目增刪查的封裝與上述端點一一對應可作為接入參考。倉庫管理 API在項目內組織配置倉庫類似于 Git 倉庫一個項目可包含多個倉庫分別存放不同環境的配置。方法端點用途GET/api/v1/projects/{proj}/repos列出項目下所有倉庫POST/api/v1/projects/{proj}/repos創建倉庫DELETE/api/v1/projects/{proj}/repos/{repo}刪除倉庫curl -X POST http://localhost:36462/api/v1/projects/projFoo/repos \ -H Content-Type: application/json \ -d {name: repoA}文件內容 API讀取、寫入與 JSONPath 查詢這是 Central Dogma REST API 中最高頻的一組接口對應服務端 ContentServiceV1.java。列出目錄GET /api/v1/projects/{proj}/repos/{repo}/list{/path}讀取文件GET /api/v1/projects/{proj}/repos/{repo}/contents{/path}?revision-1提交更改POST /api/v1/projects/{proj}/repos/{repo}/contents預覽模板POST /api/v1/projects/{proj}/repos/{repo}/preview讀取文件時還支持jsonpath參數直接從 JSON 配置中提取字段無需下載全文curl http://localhost:36462/api/v1/projects/projFoo/repos/repoA/contents/samples/a.json?jsonpath$.a寫入文件必須攜帶commitMessage每次變更都會生成一條帶版本號的提交記錄curl -X POST http://localhost:36462/api/v1/projects/projFoo/repos/repoA/contents \ -H Content-Type: application/json \ -d {commitMessage: 更新數據庫連接串, changes: [{path: /samples/a.json, type: UPSERT, content: {\a\:\b\}}]}提交歷史與回滾 API讓配置變更可追溯配置管理自動化的核心價值在于可審計、可回滾。相關端點包括方法端點用途GET/api/v1/projects/{proj}/repos/{repo}/commits查看提交歷史GET/api/v1/projects/{proj}/repos/{repo}/compare對比兩個版本差異POST/api/v1/projects/{proj}/repos/{repo}/revert回滾到指定版本# 將倉庫回滾到 revision 3 curl -X POST http://localhost:36462/api/v1/projects/projFoo/repos/repoA/revert \ -H Content-Type: application/json \ -d {revision: 3, commitMessage: 回滾配置}結合watch監聽機制服務端還可以在配置變更時實時通知客戶端實現配置熱更新無需重啟服務。模板與變量 API動態生成環境配置Central Dogma 支持${vars.varName}模板語法可將環境差異抽取為變量文件用同一份模板渲染出 dev、prod 等多套配置。官方文檔 templates-variables.rst 中有詳細說明Web 管理界面也提供了可視化編輯。權限與元數據 API精細的訪問控制多團隊協作時權限管理必不可少。/api/v1/metadata/...系列接口由 MetadataApiService.java 提供服務成員管理POST /api/v1/metadata/{proj}/members倉庫角色POST /api/v1/metadata/{proj}/repos/{repo}/roles/users應用身份POST /api/v1/metadata/{proj}/appIdentities支持項目級與倉庫級的細粒度角色Owner、Write、Read并能管理用戶、應用身份與令牌三類主體兼顧人工與自動化場景。鏡像管理 API從外部 Git 同步配置如果你的團隊習慣在 GitLab/GitHub 上通過 Pull Request 評審配置Central Dogma 的鏡像Mirror功能可以把外部倉庫自動同步進來。相關接口位于 MirroringServiceV1.java方法端點用途GET/api/v1/projects/{proj}/repos/{repo}/mirrors查看鏡像配置POST/api/v1/projects/{proj}/repos/{repo}/mirrors創建鏡像POST/api/v1/projects/{proj}/repos/{repo}/mirrors/{id}/run手動觸發一次同步鏡像成功后配置即具備高可用、可查詢、可監聽、可鑒權四大能力且全程通過 REST API 驅動天然適合接入 CI/CD 流水線。實戰用 curl 實現配置自動化閉環把上面的接口串起來只需幾條命令就能完成更新配置 → 驗證 → 監聽變更的自動化閉環# 1. 寫入新配置 curl -X POST .../api/v1/projects/projFoo/repos/repoA/contents \ -d {commitMessage: 調整限流閾值, changes: [{path: /config/rate-limit.json, type: UPSERT, content: {\qps\: 500}}]} # 2. 讀取最新配置并校驗 curl .../api/v1/projects/projFoo/repos/repoA/contents/config/rate-limit.json # 3. 發現異常立即回滾 curl -X POST .../api/v1/projects/projFoo/repos/repoA/revert \ -d {revision: -2, commitMessage: 回滾限流配置}如果想要本地復現與二次開發可克隆倉庫獲取完整源碼https://gitcode.com/gh_mirrors/ce/centraldogma。命令行工具dogma的用法ls、cat、put、watch等可參考 client-cli.rst它與 REST API 的能力一一對應非常適合快速聯調?？偨YCentral Dogma REST API 覆蓋了配置管理全生命周期項目與倉庫的組織、文件讀寫與查詢、歷史審計與回滾、模板渲染、權限控制、鏡像同步。掌握這份參考你就能用腳本把分散在各處的配置文件統一收攏到高可用的版本化倉庫中讓配置變更變得可評審、可追蹤、可回滾——這就是配置管理自動化的正確打開方式。【免費下載鏈接】centraldogmaHighly-available version-controlled service configuration repository based on Git, ZooKeeper and HTTP/2項目地址: https://gitcode.com/gh_mirrors/ce/centraldogma創作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考 Central Dogma REST API 完全參考：讓配置管理實現自動化
Central Dogma REST API 完全參考讓配置管理實現自動化【免費下載鏈接】centraldogmaHighly-available version-controlled service configuration repository based on Git, ZooKeeper and HTTP/2項目地址: https://gitcode.com/gh_mirrors/ce/centraldogmaCentral Dogma 是一個基于 Git、ZooKeeper 和 HTTP/2 構建的高可用、版本化服務配置管理倉庫專為存放 JSON、YAML、XML 等配置而設計。它提供了完整的Central Dogma REST API讓團隊可以用curl、腳本或任何編程語言輕松讀取配置、提交變更、回滾歷史真正實現配置管理的自動化。本文是一份面向新手和普通用戶的Central Dogma REST API 完全參考從端點概覽到實戰示例一次講透。Central Dogma REST API 基礎端點、版本與認證所有 REST 接口統一掛在/api/v1前綴下服務端默認監聽36462端口。核心實現位于服務端的 ProjectServiceV1.java、ContentServiceV1.java 等文件中。調用前你只需記住三個概念路徑語法采用 Unix 風格/projFoo是項目/projFoo/repoA是倉庫/projFoo/repoA/samples/a.json是文件。Revision修訂號-1表示最新版本1、2等正整數表示歷史版本幾乎所有讀接口都支持revision參數。認證啟用安全模式后通過Authorization: Bearer token請求頭攜帶令牌。# 快速自檢列出所有項目 curl http://localhost:36462/api/v1/projects項目管理 API一鍵創建與刪除項目是配置的頂層隔離單元。常用端點如下方法端點用途GET/api/v1/projects列出全部項目POST/api/v1/projects創建項目GET/api/v1/projects/{name}查看單個項目DELETE/api/v1/projects/{name}刪除項目可恢復curl -X POST http://localhost:36462/api/v1/projects \ -H Content-Type: application/json \ -d {name: projFoo}前端 apiSlice.ts 中對項目增刪查的封裝與上述端點一一對應可作為接入參考。倉庫管理 API在項目內組織配置倉庫類似于 Git 倉庫一個項目可包含多個倉庫分別存放不同環境的配置。方法端點用途GET/api/v1/projects/{proj}/repos列出項目下所有倉庫POST/api/v1/projects/{proj}/repos創建倉庫DELETE/api/v1/projects/{proj}/repos/{repo}刪除倉庫curl -X POST http://localhost:36462/api/v1/projects/projFoo/repos \ -H Content-Type: application/json \ -d {name: repoA}文件內容 API讀取、寫入與 JSONPath 查詢這是 Central Dogma REST API 中最高頻的一組接口對應服務端 ContentServiceV1.java。列出目錄GET /api/v1/projects/{proj}/repos/{repo}/list{/path}讀取文件GET /api/v1/projects/{proj}/repos/{repo}/contents{/path}?revision-1提交更改POST /api/v1/projects/{proj}/repos/{repo}/contents預覽模板POST /api/v1/projects/{proj}/repos/{repo}/preview讀取文件時還支持jsonpath參數直接從 JSON 配置中提取字段無需下載全文curl http://localhost:36462/api/v1/projects/projFoo/repos/repoA/contents/samples/a.json?jsonpath$.a寫入文件必須攜帶commitMessage每次變更都會生成一條帶版本號的提交記錄curl -X POST http://localhost:36462/api/v1/projects/projFoo/repos/repoA/contents \ -H Content-Type: application/json \ -d {commitMessage: 更新數據庫連接串, changes: [{path: /samples/a.json, type: UPSERT, content: {\a\:\b\}}]}提交歷史與回滾 API讓配置變更可追溯配置管理自動化的核心價值在于可審計、可回滾。相關端點包括方法端點用途GET/api/v1/projects/{proj}/repos/{repo}/commits查看提交歷史GET/api/v1/projects/{proj}/repos/{repo}/compare對比兩個版本差異POST/api/v1/projects/{proj}/repos/{repo}/revert回滾到指定版本# 將倉庫回滾到 revision 3 curl -X POST http://localhost:36462/api/v1/projects/projFoo/repos/repoA/revert \ -H Content-Type: application/json \ -d {revision: 3, commitMessage: 回滾配置}結合watch監聽機制服務端還可以在配置變更時實時通知客戶端實現配置熱更新無需重啟服務。模板與變量 API動態生成環境配置Central Dogma 支持${vars.varName}模板語法可將環境差異抽取為變量文件用同一份模板渲染出 dev、prod 等多套配置。官方文檔 templates-variables.rst 中有詳細說明Web 管理界面也提供了可視化編輯。權限與元數據 API精細的訪問控制多團隊協作時權限管理必不可少。/api/v1/metadata/...系列接口由 MetadataApiService.java 提供服務成員管理POST /api/v1/metadata/{proj}/members倉庫角色POST /api/v1/metadata/{proj}/repos/{repo}/roles/users應用身份POST /api/v1/metadata/{proj}/appIdentities支持項目級與倉庫級的細粒度角色Owner、Write、Read并能管理用戶、應用身份與令牌三類主體兼顧人工與自動化場景。鏡像管理 API從外部 Git 同步配置如果你的團隊習慣在 GitLab/GitHub 上通過 Pull Request 評審配置Central Dogma 的鏡像Mirror功能可以把外部倉庫自動同步進來。相關接口位于 MirroringServiceV1.java方法端點用途GET/api/v1/projects/{proj}/repos/{repo}/mirrors查看鏡像配置POST/api/v1/projects/{proj}/repos/{repo}/mirrors創建鏡像POST/api/v1/projects/{proj}/repos/{repo}/mirrors/{id}/run手動觸發一次同步鏡像成功后配置即具備高可用、可查詢、可監聽、可鑒權四大能力且全程通過 REST API 驅動天然適合接入 CI/CD 流水線。實戰用 curl 實現配置自動化閉環把上面的接口串起來只需幾條命令就能完成更新配置 → 驗證 → 監聽變更的自動化閉環# 1. 寫入新配置 curl -X POST .../api/v1/projects/projFoo/repos/repoA/contents \ -d {commitMessage: 調整限流閾值, changes: [{path: /config/rate-limit.json, type: UPSERT, content: {\qps\: 500}}]} # 2. 讀取最新配置并校驗 curl .../api/v1/projects/projFoo/repos/repoA/contents/config/rate-limit.json # 3. 發現異常立即回滾 curl -X POST .../api/v1/projects/projFoo/repos/repoA/revert \ -d {revision: -2, commitMessage: 回滾限流配置}如果想要本地復現與二次開發可克隆倉庫獲取完整源碼https://gitcode.com/gh_mirrors/ce/centraldogma。命令行工具dogma的用法ls、cat、put、watch等可參考 client-cli.rst它與 REST API 的能力一一對應非常適合快速聯調?？偨YCentral Dogma REST API 覆蓋了配置管理全生命周期項目與倉庫的組織、文件讀寫與查詢、歷史審計與回滾、模板渲染、權限控制、鏡像同步。掌握這份參考你就能用腳本把分散在各處的配置文件統一收攏到高可用的版本化倉庫中讓配置變更變得可評審、可追蹤、可回滾——這就是配置管理自動化的正確打開方式。【免費下載鏈接】centraldogmaHighly-available version-controlled service configuration repository based on Git, ZooKeeper and HTTP/2項目地址: https://gitcode.com/gh_mirrors/ce/centraldogma創作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考