布并按客戶端 IP 命中灰度版本？)
Nacos 如何對同一配置做 beta 灰度發(fā)布并按客戶端 IP 命中灰度版本【免費(fèi)下載鏈接】nacosan easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/na/nacos本文解決的問題是同一個(gè)namespaceId groupName dataId的配置如何額外發(fā)布一份只對被指定客戶端 IP 可見的 beta 版本并驗(yàn)證命中與退出灰度的完整流程。Nacos 中灰度版本是同一 Config 身份下的從屬發(fā)布狀態(tài)namespaceId - groupName - dataId - grayName不是新的一條頂層配置。beta 內(nèi)置規(guī)則按grayNamebeta存儲(chǔ)匹配條件是請求標(biāo)簽ClientIp在逗號(hào)分隔的 beta IP 列表中優(yōu)先級(jí)為Integer.MAX_VALUE內(nèi)置規(guī)則中最高。以下內(nèi)容基于 Nacos 3.x 的灰度模型config_info_gray表 GrayRule相關(guān)語義定義見 Config 灰度發(fā)布規(guī)范。操作前的兩個(gè)前提有一個(gè)可通過 HTTP 訪問的 Nacos 服務(wù)端。下文所有接口路徑都帶有/nacos前綴例如/nacos/v3/admin/cs/config命令中的http://Nacos 服務(wù)地址需要你替換為實(shí)際可訪問的協(xié)議、主機(jī)和端口。從 3.3 版本線開始運(yùn)行時(shí)不再支持從舊表config_info_beta、config_info_tag向config_info_gray的兼容遷移。如果你的部署來自 3.0 之前版本且使用過 beta 灰度發(fā)布必須先完成相關(guān)數(shù)據(jù)遷移再升級(jí)否則本文流程不適用于舊表中的數(shù)據(jù)。第一步發(fā)布正式配置beta 版本依附于正式配置先確保正式版本存在。向POST /nacos/v3/admin/cs/config提交 form 表單發(fā)布字段與 集成測試的表單構(gòu)造 一致curl -X POST http://Nacos 服務(wù)地址/nacos/v3/admin/cs/config \ -d dataIdgray.example.com \ -d groupNameDEFAULT_GROUP \ -d contentformal-content \ -d tag \ -d appName \ -d src_user \ -d configTags \ -d desc \ -d use \ -d effect \ -d typetext \ -d schema成功時(shí)響應(yīng)為{data: true}測試中對該布爾值做了斷言。不傳namespaceId時(shí)默認(rèn)使用publicnamespace。第二步用 betaIps 請求頭發(fā)布 beta 版本關(guān)鍵點(diǎn)同一個(gè)發(fā)布接口只需額外攜帶betaIps請求頭攜帶betaIps的發(fā)布會(huì)寫入 beta 灰度版本而不是覆蓋正式配置不帶灰度選擇字段的發(fā)布才寫正式配置。curl -X POST http://Nacos 服務(wù)地址/nacos/v3/admin/cs/config \ -H betaIps: 10.0.0.2 \ -d dataIdgray.example.com \ -d groupNameDEFAULT_GROUP \ -d contentbeta-content \ -d tag \ -d appName \ -d src_user \ -d configTags \ -d desc \ -d use \ -d effect \ -d typetext \ -d schemabetaIps的取值是要命中的客戶端 IP逗號(hào)分隔可寫多個(gè) IP。示例中的10.0.0.2、gray.example.com、DEFAULT_GROUP等均為示例值替換為你自己的 dataId、group 和客戶端 IP。成功后同樣返回{data: true}此后該配置同時(shí)擁有正式版本和grayNamebeta的灰度版本兩者共享namespaceId groupName dataId但內(nèi)容、md5、最后修改時(shí)間和灰度規(guī)則各自獨(dú)立。第三步通過 Admin beta 查詢接口驗(yàn)證 beta 版本已生效驗(yàn)證用專門的 beta 查詢端點(diǎn)而不是正式配置查詢。注意Admin 正式查詢不會(huì)靜默返回灰度內(nèi)容要檢查 beta 版本必須走 beta 端點(diǎn)curl http://Nacos 服務(wù)地址/nacos/v3/admin/cs/config/beta?dataIdgray.example.comgroupNameDEFAULT_GROUPnamespaceId可省略省略時(shí)為public。命中時(shí)data中包含該配置的身份、beta 內(nèi)容和規(guī)則示例結(jié)果字段來自 beta Admin API 集成測試 的斷言{ data: { dataId: gray.example.com, groupName: DEFAULT_GROUP, namespaceId: public, content: beta-content, grayName: beta, grayRule: 包含 betaIps 的序列化灰度規(guī)則 } }其中g(shù)rayRule為序列化后的灰度規(guī)則測試斷言其內(nèi)容包含發(fā)布時(shí)傳入的betaIps值。如果該配置當(dāng)前沒有 beta 版本接口返回 HTTP 404錯(cuò)誤碼為RESOURCE_NOT_FOUND錯(cuò)誤消息為Config is not in beta。第四步按客戶端 IP 驗(yàn)證運(yùn)行時(shí)灰度命中運(yùn)行時(shí)查詢端點(diǎn)是GET /nacos/v3/client/cs/config供客戶端獲取實(shí)際生效的配置curl http://Nacos 服務(wù)地址/nacos/v3/client/cs/config?dataIdgray.example.comgroupNameDEFAULT_GROUP命中邏輯由 Config 發(fā)布與查詢規(guī)范 定義運(yùn)行時(shí)查詢先從客戶端 IP、顯式 tag 和連接標(biāo)簽構(gòu)建請求標(biāo)簽再遍歷已排序的灰度版本返回第一個(gè)命中的灰度版本未命中才回退正式配置。因此從betaIps列表中的機(jī)器本例中源 IP 為10.0.0.2的客戶端發(fā)起該請求返回的是 beta 內(nèi)容響應(yīng)還包含命中的灰度版本的 md5、encryptedDataKey、最后修改時(shí)間、配置類型和灰度元數(shù)據(jù)從列表外的機(jī)器發(fā)起同一請求返回的是正式配置內(nèi)容。當(dāng)存在多個(gè)灰度版本時(shí)按優(yōu)先級(jí)降序匹配優(yōu)先級(jí)相同再按grayName排序beta 規(guī)則優(yōu)先級(jí)為Integer.MAX_VALUE是內(nèi)置規(guī)則中最先被匹配的。響應(yīng)中是否包含 beta/tag 元數(shù)據(jù)字段的驗(yàn)證可參考 Client API 測試場景說明 中ConfigOpenApiITCase對GET /v3/client/cs/config的描述。第五步停止灰度刪除 beta 版本確認(rèn)灰度完成后刪除 beta 版本即可退出灰度curl -X DELETE http://Nacos 服務(wù)地址/nacos/v3/admin/cs/config/beta?dataIdgray.example.comgroupNameDEFAULT_GROUP刪除灰度版本只移除該版本不刪除正式配置。刪除后再執(zhí)行第三步的 beta 查詢會(huì)返回 404Config is not in beta此時(shí)所有客戶端都拿回正式配置這一查詢結(jié)果就是灰度已停止的判定依據(jù)?？蛇x分支Console 側(cè)存在等價(jià)的/nacos/v3/console/cs/config/beta查詢與刪除端點(diǎn)見 Console API 測試場景說明行為差異是 beta 不存在時(shí)返回 HTTP 200 且datanull而不是 404Console 發(fā)布走 Console 請求頭體系。限制與邊界單個(gè)配置的最大灰度版本數(shù)受nacos.config.gray.version.max.count限制默認(rèn)值為10beta 與 tag 灰度版本都計(jì)入該限制。內(nèi)置灰度規(guī)則只有兩類betaClientIp命中逗號(hào)分隔的 beta IP 列表和taggrayName為tag_{tag}按請求 tag 匹配。如果請求顯式指定 tag 但未命中 tag 灰度會(huì)返回 tag-specific not-found而不是回退正式配置?；叶葍?nèi)容持久化在config_info_gray表中灰度發(fā)布或刪除都會(huì)記錄歷史變更并觸發(fā)攜帶對應(yīng)grayName的 Config 變更事件beta/tag 變更在 3.3 版本線之后不得再通過 legacyisBeta/tag字段做舊表遷移。除 HTTP 接口外Maintainer SDK 通過BetaConfigMaintainerService提供 beta 和灰度發(fā)布的編程能力適合把上述流程放進(jìn)運(yùn)維腳本見 SDK Java 實(shí)現(xiàn)規(guī)范。進(jìn)一步閱讀Config 灰度發(fā)布規(guī)范、Config 發(fā)布與查詢規(guī)范、Admin API 測試場景說明?！久赓M(fèi)下載鏈接】nacosan easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/na/nacos創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 Nacos 如何對同一配置做 beta 灰度發(fā)布并按客戶端 IP 命中灰度版本？
Nacos 如何對同一配置做 beta 灰度發(fā)布并按客戶端 IP 命中灰度版本【免費(fèi)下載鏈接】nacosan easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/na/nacos本文解決的問題是同一個(gè)namespaceId groupName dataId的配置如何額外發(fā)布一份只對被指定客戶端 IP 可見的 beta 版本并驗(yàn)證命中與退出灰度的完整流程。Nacos 中灰度版本是同一 Config 身份下的從屬發(fā)布狀態(tài)namespaceId - groupName - dataId - grayName不是新的一條頂層配置。beta 內(nèi)置規(guī)則按grayNamebeta存儲(chǔ)匹配條件是請求標(biāo)簽ClientIp在逗號(hào)分隔的 beta IP 列表中優(yōu)先級(jí)為Integer.MAX_VALUE內(nèi)置規(guī)則中最高。以下內(nèi)容基于 Nacos 3.x 的灰度模型config_info_gray表 GrayRule相關(guān)語義定義見 Config 灰度發(fā)布規(guī)范。操作前的兩個(gè)前提有一個(gè)可通過 HTTP 訪問的 Nacos 服務(wù)端。下文所有接口路徑都帶有/nacos前綴例如/nacos/v3/admin/cs/config命令中的http://Nacos 服務(wù)地址需要你替換為實(shí)際可訪問的協(xié)議、主機(jī)和端口。從 3.3 版本線開始運(yùn)行時(shí)不再支持從舊表config_info_beta、config_info_tag向config_info_gray的兼容遷移。如果你的部署來自 3.0 之前版本且使用過 beta 灰度發(fā)布必須先完成相關(guān)數(shù)據(jù)遷移再升級(jí)否則本文流程不適用于舊表中的數(shù)據(jù)。第一步發(fā)布正式配置beta 版本依附于正式配置先確保正式版本存在。向POST /nacos/v3/admin/cs/config提交 form 表單發(fā)布字段與 集成測試的表單構(gòu)造 一致curl -X POST http://Nacos 服務(wù)地址/nacos/v3/admin/cs/config \ -d dataIdgray.example.com \ -d groupNameDEFAULT_GROUP \ -d contentformal-content \ -d tag \ -d appName \ -d src_user \ -d configTags \ -d desc \ -d use \ -d effect \ -d typetext \ -d schema成功時(shí)響應(yīng)為{data: true}測試中對該布爾值做了斷言。不傳namespaceId時(shí)默認(rèn)使用publicnamespace。第二步用 betaIps 請求頭發(fā)布 beta 版本關(guān)鍵點(diǎn)同一個(gè)發(fā)布接口只需額外攜帶betaIps請求頭攜帶betaIps的發(fā)布會(huì)寫入 beta 灰度版本而不是覆蓋正式配置不帶灰度選擇字段的發(fā)布才寫正式配置。curl -X POST http://Nacos 服務(wù)地址/nacos/v3/admin/cs/config \ -H betaIps: 10.0.0.2 \ -d dataIdgray.example.com \ -d groupNameDEFAULT_GROUP \ -d contentbeta-content \ -d tag \ -d appName \ -d src_user \ -d configTags \ -d desc \ -d use \ -d effect \ -d typetext \ -d schemabetaIps的取值是要命中的客戶端 IP逗號(hào)分隔可寫多個(gè) IP。示例中的10.0.0.2、gray.example.com、DEFAULT_GROUP等均為示例值替換為你自己的 dataId、group 和客戶端 IP。成功后同樣返回{data: true}此后該配置同時(shí)擁有正式版本和grayNamebeta的灰度版本兩者共享namespaceId groupName dataId但內(nèi)容、md5、最后修改時(shí)間和灰度規(guī)則各自獨(dú)立。第三步通過 Admin beta 查詢接口驗(yàn)證 beta 版本已生效驗(yàn)證用專門的 beta 查詢端點(diǎn)而不是正式配置查詢。注意Admin 正式查詢不會(huì)靜默返回灰度內(nèi)容要檢查 beta 版本必須走 beta 端點(diǎn)curl http://Nacos 服務(wù)地址/nacos/v3/admin/cs/config/beta?dataIdgray.example.comgroupNameDEFAULT_GROUPnamespaceId可省略省略時(shí)為public。命中時(shí)data中包含該配置的身份、beta 內(nèi)容和規(guī)則示例結(jié)果字段來自 beta Admin API 集成測試 的斷言{ data: { dataId: gray.example.com, groupName: DEFAULT_GROUP, namespaceId: public, content: beta-content, grayName: beta, grayRule: 包含 betaIps 的序列化灰度規(guī)則 } }其中g(shù)rayRule為序列化后的灰度規(guī)則測試斷言其內(nèi)容包含發(fā)布時(shí)傳入的betaIps值。如果該配置當(dāng)前沒有 beta 版本接口返回 HTTP 404錯(cuò)誤碼為RESOURCE_NOT_FOUND錯(cuò)誤消息為Config is not in beta。第四步按客戶端 IP 驗(yàn)證運(yùn)行時(shí)灰度命中運(yùn)行時(shí)查詢端點(diǎn)是GET /nacos/v3/client/cs/config供客戶端獲取實(shí)際生效的配置curl http://Nacos 服務(wù)地址/nacos/v3/client/cs/config?dataIdgray.example.comgroupNameDEFAULT_GROUP命中邏輯由 Config 發(fā)布與查詢規(guī)范 定義運(yùn)行時(shí)查詢先從客戶端 IP、顯式 tag 和連接標(biāo)簽構(gòu)建請求標(biāo)簽再遍歷已排序的灰度版本返回第一個(gè)命中的灰度版本未命中才回退正式配置。因此從betaIps列表中的機(jī)器本例中源 IP 為10.0.0.2的客戶端發(fā)起該請求返回的是 beta 內(nèi)容響應(yīng)還包含命中的灰度版本的 md5、encryptedDataKey、最后修改時(shí)間、配置類型和灰度元數(shù)據(jù)從列表外的機(jī)器發(fā)起同一請求返回的是正式配置內(nèi)容。當(dāng)存在多個(gè)灰度版本時(shí)按優(yōu)先級(jí)降序匹配優(yōu)先級(jí)相同再按grayName排序beta 規(guī)則優(yōu)先級(jí)為Integer.MAX_VALUE是內(nèi)置規(guī)則中最先被匹配的。響應(yīng)中是否包含 beta/tag 元數(shù)據(jù)字段的驗(yàn)證可參考 Client API 測試場景說明 中ConfigOpenApiITCase對GET /v3/client/cs/config的描述。第五步停止灰度刪除 beta 版本確認(rèn)灰度完成后刪除 beta 版本即可退出灰度curl -X DELETE http://Nacos 服務(wù)地址/nacos/v3/admin/cs/config/beta?dataIdgray.example.comgroupNameDEFAULT_GROUP刪除灰度版本只移除該版本不刪除正式配置。刪除后再執(zhí)行第三步的 beta 查詢會(huì)返回 404Config is not in beta此時(shí)所有客戶端都拿回正式配置這一查詢結(jié)果就是灰度已停止的判定依據(jù)?？蛇x分支Console 側(cè)存在等價(jià)的/nacos/v3/console/cs/config/beta查詢與刪除端點(diǎn)見 Console API 測試場景說明行為差異是 beta 不存在時(shí)返回 HTTP 200 且datanull而不是 404Console 發(fā)布走 Console 請求頭體系。限制與邊界單個(gè)配置的最大灰度版本數(shù)受nacos.config.gray.version.max.count限制默認(rèn)值為10beta 與 tag 灰度版本都計(jì)入該限制。內(nèi)置灰度規(guī)則只有兩類betaClientIp命中逗號(hào)分隔的 beta IP 列表和taggrayName為tag_{tag}按請求 tag 匹配。如果請求顯式指定 tag 但未命中 tag 灰度會(huì)返回 tag-specific not-found而不是回退正式配置?；叶葍?nèi)容持久化在config_info_gray表中灰度發(fā)布或刪除都會(huì)記錄歷史變更并觸發(fā)攜帶對應(yīng)grayName的 Config 變更事件beta/tag 變更在 3.3 版本線之后不得再通過 legacyisBeta/tag字段做舊表遷移。除 HTTP 接口外Maintainer SDK 通過BetaConfigMaintainerService提供 beta 和灰度發(fā)布的編程能力適合把上述流程放進(jìn)運(yùn)維腳本見 SDK Java 實(shí)現(xiàn)規(guī)范。進(jìn)一步閱讀Config 灰度發(fā)布規(guī)范、Config 發(fā)布與查詢規(guī)范、Admin API 測試場景說明?！久赓M(fèi)下載鏈接】nacosan easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/na/nacos創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考