index.html

<!doctype html>
<html lang="zh-Hans" dir="ltr" class="docs-wrapper docs-doc-page docs-version-current plugin-docs plugin-id-default docs-doc-id-advanced-guide/配置中心">
<head>
<meta charset="UTF-8">
<meta name="generator" content="Docusaurus v2.2.0">
<title data-rh="true">盘古开发框架 | Nacos | 配置动态化 | 配置中心化 | 配置外部化</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:url" content="https://pangu.pulanit.com/pangu-framework/docs/advanced-guide/nacos-config-center"><meta data-rh="true" name="docusaurus_locale" content="zh-Hans"><meta data-rh="true" name="docsearch:language" content="zh-Hans"><meta data-rh="true" name="author" content="码农大熊"><meta data-rh="true" name="baidu-site-verification" content="code-FsdXztrzOo"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="配置中心 | 盘古开发框架官网:行业数字化赋能开发基座"><meta data-rh="true" name="description" content="盘古开发框架 | Nacos | 配置动态化 | 配置中心化 | 配置外部化"><meta data-rh="true" property="og:description" content="盘古开发框架 | Nacos | 配置动态化 | 配置中心化 | 配置外部化"><meta data-rh="true" name="keywords" content="盘古开发框架 | Nacos | 配置动态化 | 配置中心化 | 配置外部化"><link data-rh="true" rel="icon" href="/pangu-framework/img/favicon.ico"><link data-rh="true" rel="canonical" href="https://pangu.pulanit.com/pangu-framework/docs/advanced-guide/nacos-config-center"><link data-rh="true" rel="alternate" href="https://pangu.pulanit.com/pangu-framework/docs/advanced-guide/nacos-config-center" hreflang="zh-Hans"><link data-rh="true" rel="alternate" href="https://pangu.pulanit.com/pangu-framework/docs/advanced-guide/nacos-config-center" hreflang="x-default"><script src="https://hm.baidu.com/hm.js?8a2c2aae78c4983e3cf661fea34e6353" async></script><link rel="stylesheet" href="/pangu-framework/assets/css/styles.f1578d2e.css">
<link rel="preload" href="/pangu-framework/assets/js/runtime~main.3d26c6de.js" as="script">
<link rel="preload" href="/pangu-framework/assets/js/main.7db6da70.js" as="script">
</head>
<body class="navigation-with-keyboard">
<script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}var e=function(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}();t(null!==e?e:"light")}()</script><div id="__docusaurus">
<div role="region" aria-label="跳到主要内容"><a class="skipToContent_fXgn" href="#docusaurus_skipToContent_fallback">跳到主要内容</a></div><nav class="navbar navbar--fixed-top navbarHideable_m1mJ"><div class="navbar__inner"><div class="navbar__items"><button aria-label="Toggle navigation bar" aria-expanded="false" class="navbar__toggle clean-btn" type="button"><svg width="30" height="30" viewBox="0 0 30 30" aria-hidden="true"><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><a class="navbar__brand" href="/pangu-framework/"><div class="navbar__logo"><img src="/pangu-framework/img/logo.svg" alt="盘古开发框架" class="themedImage_ToTc themedImage--light_HNdA"><img src="/pangu-framework/img/logo.svg" alt="盘古开发框架" class="themedImage_ToTc themedImage--dark_i4oU"></div><b class="navbar__title text--truncate">盘古开发框架®</b></a><a class="navbar__item navbar__link" href="/pangu-framework/intro">简介</a><a aria-current="page" class="navbar__item navbar__link navbar__link--active" href="/pangu-framework/docs/intro">微服务开发</a><a class="navbar__item navbar__link" href="/pangu-framework/admin/intro">Admin 开发</a><a class="navbar__item navbar__link" href="/pangu-framework/app/intro">APP 开发</a><div class="navbar__item dropdown dropdown--hoverable"><a href="#" aria-haspopup="true" aria-expanded="false" role="button" class="navbar__link">在线体验</a><ul class="dropdown__menu"><li><a class="dropdown__link" href="/pangu-framework/online-demo">「盘古 Admin」中后台业务系统二次开发脚手架</a></li><li><a class="dropdown__link" href="/pangu-framework/online-demo-app">「盘古 APP」移动端多平台快速开发脚手架</a></li></ul></div><a class="navbar__item navbar__link" href="/pangu-framework/thanks">致敬</a><a class="navbar__item navbar__link" href="/pangu-framework/community">社区</a><a href="https://xiongchun.pulanit.com/blog/tags/%E7%9B%98%E5%8F%A4%E5%BC%80%E5%8F%91%E6%A1%86%E6%9E%B6" target="_blank" rel="noopener noreferrer" class="navbar__item navbar__link">博客</a></div><div class="navbar__items navbar__items--right"><a href="https://gitee.com/pulanos/pangu-framework" target="_blank" rel="noopener noreferrer" class="navbar__item navbar__link header-gitee-link"></a><a href="https://github.com/xiongchun/pangu-framework" target="_blank" rel="noopener noreferrer" class="navbar__item navbar__link header-github-link"></a><div class="toggle_vylO colorModeToggle_DEke"><button class="clean-btn toggleButton_gllP toggleButtonDisabled_aARS" type="button" disabled="" title="切换浅色/暗黑模式（当前为浅色模式）" aria-label="切换浅色/暗黑模式（当前为浅色模式）" aria-live="polite"><svg viewBox="0 0 24 24" width="24" height="24" class="lightToggleIcon_pyhR"><path fill="currentColor" d="M12,9c1.65,0,3,1.35,3,3s-1.35,3-3,3s-3-1.35-3-3S10.35,9,12,9 M12,7c-2.76,0-5,2.24-5,5s2.24,5,5,5s5-2.24,5-5 S14.76,7,12,7L12,7z M2,13l2,0c0.55,0,1-0.45,1-1s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S1.45,13,2,13z M20,13l2,0c0.55,0,1-0.45,1-1 s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S19.45,13,20,13z M11,2v2c0,0.55,0.45,1,1,1s1-0.45,1-1V2c0-0.55-0.45-1-1-1S11,1.45,11,2z M11,20v2c0,0.55,0.45,1,1,1s1-0.45,1-1v-2c0-0.55-0.45-1-1-1C11.45,19,11,19.45,11,20z M5.99,4.58c-0.39-0.39-1.03-0.39-1.41,0 c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0s0.39-1.03,0-1.41L5.99,4.58z M18.36,16.95 c-0.39-0.39-1.03-0.39-1.41,0c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0c0.39-0.39,0.39-1.03,0-1.41 L18.36,16.95z M19.42,5.99c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06c-0.39,0.39-0.39,1.03,0,1.41 s1.03,0.39,1.41,0L19.42,5.99z M7.05,18.36c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06 c-0.39,0.39-0.39,1.03,0,1.41s1.03,0.39,1.41,0L7.05,18.36z"></path></svg><svg viewBox="0 0 24 24" width="24" height="24" class="darkToggleIcon_wfgR"><path fill="currentColor" d="M9.37,5.51C9.19,6.15,9.1,6.82,9.1,7.5c0,4.08,3.32,7.4,7.4,7.4c0.68,0,1.35-0.09,1.99-0.27C17.45,17.19,14.93,19,12,19 c-3.86,0-7-3.14-7-7C5,9.07,6.81,6.55,9.37,5.51z M12,3c-4.97,0-9,4.03-9,9s4.03,9,9,9s9-4.03,9-9c0-0.46-0.04-0.92-0.1-1.36 c-0.98,1.37-2.58,2.26-4.4,2.26c-2.98,0-5.4-2.42-5.4-5.4c0-1.81,0.89-3.42,2.26-4.4C12.92,3.04,12.46,3,12,3L12,3z"></path></svg></button></div><div class="searchBox_ZlJk"><div class="navbar__search searchBarContainer_NW3z"><input placeholder="搜索" aria-label="Search" class="navbar__search-input"><div class="loadingRing_RJI3 searchBarLoadingRing_YnHq"><div></div><div></div><div></div><div></div></div></div></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div></nav><div id="docusaurus_skipToContent_fallback" class="main-wrapper mainWrapper_z2l0 docsWrapper_BCFX"><button aria-label="回到顶部" class="clean-btn theme-back-to-top-button backToTopButton_sjWU" type="button"></button><div class="docPage__5DB"><aside class="theme-doc-sidebar-container docSidebarContainer_b6E3"><div class="sidebar_njMd sidebarWithHideableNavbar_wUlq"><a tabindex="-1" class="sidebarLogo_isFc" href="/pangu-framework/"><img src="/pangu-framework/img/logo.svg" alt="盘古开发框架" class="themedImage_ToTc themedImage--light_HNdA"><img src="/pangu-framework/img/logo.svg" alt="盘古开发框架" class="themedImage_ToTc themedImage--dark_i4oU"><b>盘古开发框架®</b></a><nav class="menu thin-scrollbar menu_SIkG"><ul class="theme-doc-sidebar-menu menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/pangu-framework/docs/intro">简介</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/pangu-framework/docs/install">安装</a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" aria-expanded="true" href="/pangu-framework/docs/quick-start/how-to-make-architecture">快速开始</a></div><ul style="display:block;overflow:visible;height:auto" class="menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/pangu-framework/docs/quick-start/how-to-make-architecture">开发架构模式对比</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/pangu-framework/docs/quick-start/how-to-make-monomer-architecture-app">如何开发单体应用</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/pangu-framework/docs/quick-start/how-to-make-microservice-architecture-app">如何开发微服务应用</a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" aria-expanded="true" tabindex="0" href="/pangu-framework/docs/quick-start/gateway/intro">如何开发微服务网关</a></div><ul style="display:block;overflow:visible;height:auto" class="menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/pangu-framework/docs/quick-start/gateway/intro">微服务网关简介</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/pangu-framework/docs/quick-start/gateway/webmvc">基于 WebMVC 接口调用模式</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/pangu-framework/docs/quick-start/gateway/shenyu">基于 ShenYu 泛化调用模式</a></li></ul></li></ul></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret menu__link--active" aria-expanded="true" href="/pangu-framework/docs/advanced-guide/nacos-config-center">开发指南</a></div><ul style="display:block;overflow:visible;height:auto" class="menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link menu__link--active" aria-current="page" tabindex="0" href="/pangu-framework/docs/advanced-guide/nacos-config-center">配置中心</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/pangu-framework/docs/advanced-guide/nacos-regist-center">注册中心</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/pangu-framework/docs/advanced-guide/data-persistance">数据持久化</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/pangu-framework/docs/advanced-guide/layering-cache">分布式多级缓存</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/pangu-framework/docs/advanced-guide/distributed-lock">分布式锁</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/pangu-framework/docs/advanced-guide/distributed-transaction">分布式事务</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/pangu-framework/docs/advanced-guide/mq">消息队列</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/pangu-framework/docs/advanced-guide/readwrite-splitting">数据治理之读写分离</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/pangu-framework/docs/advanced-guide/data-sharding">数据治理之数据分片</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/pangu-framework/docs/code-generator">代码生成器插件</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/pangu-framework/docs/examples-list">范例模版工程</a></li></ul></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" aria-expanded="false" href="/pangu-framework/docs/deploy-guide/basic">部署运维参考</a></div></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/pangu-framework/docs/faq-service">日常开发常见问答</a></li></ul></nav><button type="button" title="收起侧边栏" aria-label="收起侧边栏" class="button button--secondary button--outline collapseSidebarButton_PEFL"><svg width="20" height="20" aria-hidden="true" class="collapseSidebarButtonIcon_kv0_"><g fill="#7a7a7a"><path d="M9.992 10.023c0 .2-.062.399-.172.547l-4.996 7.492a.982.982 0 01-.828.454H1c-.55 0-1-.453-1-1 0-.2.059-.403.168-.551l4.629-6.942L.168 3.078A.939.939 0 010 2.528c0-.548.45-.997 1-.997h2.996c.352 0 .649.18.828.45L9.82 9.472c.11.148.172.347.172.55zm0 0"></path><path d="M19.98 10.023c0 .2-.058.399-.168.547l-4.996 7.492a.987.987 0 01-.828.454h-3c-.547 0-.996-.453-.996-1 0-.2.059-.403.168-.551l4.625-6.942-4.625-6.945a.939.939 0 01-.168-.55 1 1 0 01.996-.997h3c.348 0 .649.18.828.45l4.996 7.492c.11.148.168.347.168.55zm0 0"></path></g></svg></button></div></aside><main class="docMainContainer_gTbr"><div class="container padding-top--md padding-bottom--lg"><div class="row"><div class="col docItemCol_VOVn"><div class="docItemContainer_Djhp"><article><nav class="theme-doc-breadcrumbs breadcrumbsContainer_Z_bl" aria-label="页面路径"><ul class="breadcrumbs" itemscope="" itemtype="https://schema.org/BreadcrumbList"><li class="breadcrumbs__item"><a aria-label="主页面" class="breadcrumbs__link" href="/pangu-framework/"><svg viewBox="0 0 24 24" class="breadcrumbHomeIcon_OVgt"><path d="M10 19v-5h4v5c0 .55.45 1 1 1h3c.55 0 1-.45 1-1v-7h1.7c.46 0 .68-.57.33-.87L12.67 3.6c-.38-.34-.96-.34-1.34 0l-8.36 7.53c-.34.3-.13.87.33.87H5v7c0 .55.45 1 1 1h3c.55 0 1-.45 1-1z" fill="currentColor"></path></svg></a></li><li class="breadcrumbs__item"><span class="breadcrumbs__link">开发指南</span><meta itemprop="position" content="1"></li><li itemscope="" itemprop="itemListElement" itemtype="https://schema.org/ListItem" class="breadcrumbs__item breadcrumbs__item--active"><span class="breadcrumbs__link" itemprop="name">配置中心</span><meta itemprop="position" content="2"></li></ul></nav><div class="tocCollapsible_ETCw theme-doc-toc-mobile tocMobile_ITEo"><button type="button" class="clean-btn tocCollapsibleButton_TO0P">本页总览</button></div><div class="theme-doc-markdown markdown"><header><h1>配置中心</h1></header><p>配置中心作为分布式微服务开发的标配组件，业界已有很多成功的典型应用，如：携程 Apollo 分布式配置中心、百度 Disconf 分布式配置中心等。盘古配置中心基于阿里的 <a href="/pangu-framework/thanks">Nacos</a> 提供动态配置服务。</p><div class="theme-admonition theme-admonition-caution alert alert--warning admonition_LlT9"><div class="admonitionHeading_tbUL"><span class="admonitionIcon_kALy"><svg viewBox="0 0 16 16"><path fill-rule="evenodd" d="M8.893 1.5c-.183-.31-.52-.5-.887-.5s-.703.19-.886.5L.138 13.499a.98.98 0 0 0 0 1.001c.193.31.53.501.886.501h13.964c.367 0 .704-.19.877-.5a1.03 1.03 0 0 0 .01-1.002L8.893 1.5zm.133 11.497H6.987v-2.003h2.039v2.003zm0-3.004H6.987V5.987h2.039v4.006z"></path></svg></span>警告</div><div class="admonitionContent_S0QG"><p>鉴于文档可读性，盘古教程和参考范例都使用的本地配置的方式。本文将介绍如何基于配置中心让盘古应用获得动态配置服务的能力。在实际应用中，如无特殊需求我们一般都建议采用配置中心的方式来开发。</p></div></div><h2 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="配置中心介绍">配置中心介绍<a class="hash-link" href="#配置中心介绍" title="标题的直接链接"></a></h2><p>Nacos 动态配置服务可以让你以中心化、外部化和动态化的方式管理所有环境的应用配置和服务配置。动态配置消除了配置变更时重新部署应用和服务的需要，让配置管理变得更加高效和敏捷。配置中心化管理让实现无状态服务变得更简单，让服务按需弹性扩展变得更容易。它还提供了一个简洁易用的 UI 帮助你管理所有的服务和应用的配置，包括配置版本跟踪、金丝雀发布、一键回滚配置等一系列开箱即用的配置管理特性，帮助你更安全地在生产环境中管理配置变更和降低配置变更带来的风险。</p><details class="details_lb9f alert alert--info details_b_Ee" data-collapsed="true"><summary><b>快速 QA：</b>前文中 Nacos 用于服务注册，为什么配置中心也是它？</summary><div><div class="collapsibleContent_i85q"><div>Nacos 是构建以“服务”为中心的现代应用架构 (例如微服务范式、云原生范式) 的服务基础设施。致力于发现、配置和管理微服务，完美的整合了配置中心和服务注册中心。因此，Nacos 不仅是服务注册中心也是功能完善的分布式配置中心。</div></div></div></details><details class="details_lb9f alert alert--info details_b_Ee" data-collapsed="true"><summary><b>快速 QA：</b>单体分层架构的开发模式也可以使用配置中心进行配置吗？</summary><div><div class="collapsibleContent_i85q"><div>配置中心是分布式微服务架构开发环境下强烈建议的必选标配组件。但如果你是基于单体分层架构开发，配置中心也是一样可以使用的。对于这些基础能力，无论是微服务还是单体，盘古框架都做了完美适配，只需要依赖 `pangu-spring-boot-starter` 就可以实现开箱即用。</div></div></div></details><h3 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="相关名词解释">相关名词解释<a class="hash-link" href="#相关名词解释" title="标题的直接链接"></a></h3><h4 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="命名空间">命名空间<a class="hash-link" href="#命名空间" title="标题的直接链接"></a></h4><p>用于进行租户粒度的配置隔离。不同的命名空间下，可以存在相同的 Group 或 Data ID 的配置。Namespace 的常用场景之一是不同环境的配置的区分隔离，例如开发测试环境和生产环境的资源（如配置、服务）隔离等。</p><h4 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="配置管理">配置管理<a class="hash-link" href="#配置管理" title="标题的直接链接"></a></h4><p>系统配置的编辑、存储、分发、变更管理、历史版本管理、变更审计等所有与配置相关的活动。</p><h4 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="配置项">配置项<a class="hash-link" href="#配置项" title="标题的直接链接"></a></h4><p>一个具体的可配置的参数与其值域，通常以 param-key=param-value 的形式存在。例如我们常配置系统的日志输出级别（ logLevel=INFO|WARN|ERROR ）就是一个配置项。</p><h4 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="配置集">配置集<a class="hash-link" href="#配置集" title="标题的直接链接"></a></h4><p>一组相关或者不相关的配置项的集合称为配置集。在系统中，一个配置文件通常就是一个配置集，包含了系统各个方面的配置。例如，一个配置集可能包含了数据源、线程池、日志级别等配置项。</p><h4 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="配置集id">配置集ID<a class="hash-link" href="#配置集id" title="标题的直接链接"></a></h4><p>Nacos 中的某个配置集的 ID。配置集 ID 是组织划分配置的维度之一。一个系统或者应用可以包含多个配置集，每个配置集都可以被一个有意义的名称标识。（比如：使用应用名称作为 Data ID）</p><h4 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="配置快照">配置快照<a class="hash-link" href="#配置快照" title="标题的直接链接"></a></h4><p>Nacos 的客户端 SDK 会在本地生成配置的快照。当客户端无法连接到 Nacos Server 时，可以使用配置快照显示系统的整体容灾能力。配置快照类似于 Git 中的本地 commit，也类似于缓存，会在适当的时机更新，但是并没有缓存过期（ expiration ）的概念。</p><h3 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="本地配置与配置中心对比">本地配置与配置中心对比<a class="hash-link" href="#本地配置与配置中心对比" title="标题的直接链接"></a></h3><ul><li><strong>本地配置（配置文件）</strong><ul><li>配置分散、与应用耦合、静态配置 </li><li>无环境隔离无版本支持，容易引发生产事故 </li><li>无安全审计 </li></ul></li><li><strong>配置中心</strong><ul><li>配置集中、外部化、动态化实时生效</li><li>多环境隔离多版本支持，较安全</li><li>配置权限控制、操作变更审计</li></ul></li></ul><h2 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="配置中心实战">配置中心实战<a class="hash-link" href="#配置中心实战" title="标题的直接链接"></a></h2><p>下面介绍一个使用配置中心的例子。其它基于本地配置的范例都可以参考这个例子改为基于配置中心的动态配置。</p><h3 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="安装相关盘古模块">安装相关盘古模块<a class="hash-link" href="#安装相关盘古模块" title="标题的直接链接"></a></h3><div class="tabs-container tabList__CuJ"><ul role="tablist" aria-orientation="horizontal" class="tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_LNqP tabs__item--active">盘古 Parent</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_LNqP">基础模块</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_Ymn6"><div class="language-jsx codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-jsx codeBlock_bY9V thin-scrollbar"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token tag punctuation" style="color:#393A34">&lt;</span><span class="token tag" style="color:#00009f">parent</span><span class="token tag punctuation" style="color:#393A34">&gt;</span><span class="token plain-text"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain-text">    </span><span class="token tag punctuation" style="color:#393A34">&lt;</span><span class="token tag" style="color:#00009f">groupId</span><span class="token tag punctuation" style="color:#393A34">&gt;</span><span class="token plain-text">com.gitee.pulanos.pangu</span><span class="token tag punctuation" style="color:#393A34">&lt;/</span><span class="token tag" style="color:#00009f">groupId</span><span class="token tag punctuation" style="color:#393A34">&gt;</span><span class="token plain-text"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain-text">    </span><span class="token tag punctuation" style="color:#393A34">&lt;</span><span class="token tag" style="color:#00009f">artifactId</span><span class="token tag punctuation" style="color:#393A34">&gt;</span><span class="token plain-text">pangu-parent</span><span class="token tag punctuation" style="color:#393A34">&lt;/</span><span class="token tag" style="color:#00009f">artifactId</span><span class="token tag punctuation" style="color:#393A34">&gt;</span><span class="token plain-text"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain-text">    </span><span class="token tag punctuation" style="color:#393A34">&lt;</span><span class="token tag" style="color:#00009f">version</span><span class="token tag punctuation" style="color:#393A34">&gt;</span><span class="token plain-text">latest.version.xxx</span><span class="token tag punctuation" style="color:#393A34">&lt;/</span><span class="token tag" style="color:#00009f">version</span><span class="token tag punctuation" style="color:#393A34">&gt;</span><span class="token plain-text"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain-text">    </span><span class="token tag punctuation" style="color:#393A34">&lt;</span><span class="token tag" style="color:#00009f">relativePath</span><span class="token tag punctuation" style="color:#393A34">/&gt;</span><span class="token plain-text"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain-text"></span><span class="token tag punctuation" style="color:#393A34">&lt;/</span><span class="token tag" style="color:#00009f">parent</span><span class="token tag punctuation" style="color:#393A34">&gt;</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="复制代码到剪贴板" title="复制" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg class="copyButtonIcon_y97N" viewBox="0 0 24 24"><path d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg class="copyButtonSuccessIcon_LjdS" viewBox="0 0 24 24"><path d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div></div><div role="tabpanel" class="tabItem_Ymn6" hidden=""><div class="language-jsx codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-jsx codeBlock_bY9V thin-scrollbar"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token tag punctuation" style="color:#393A34">&lt;</span><span class="token tag" style="color:#00009f">dependency</span><span class="token tag punctuation" style="color:#393A34">&gt;</span><span class="token plain-text"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain-text">    </span><span class="token tag punctuation" style="color:#393A34">&lt;</span><span class="token tag" style="color:#00009f">groupId</span><span class="token tag punctuation" style="color:#393A34">&gt;</span><span class="token plain-text">com.gitee.pulanos.pangu</span><span class="token tag punctuation" style="color:#393A34">&lt;/</span><span class="token tag" style="color:#00009f">groupId</span><span class="token tag punctuation" style="color:#393A34">&gt;</span><span class="token plain-text"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain-text">    </span><span class="token tag punctuation" style="color:#393A34">&lt;</span><span class="token tag" style="color:#00009f">artifactId</span><span class="token tag punctuation" style="color:#393A34">&gt;</span><span class="token plain-text">pangu-spring-boot-starter</span><span class="token tag punctuation" style="color:#393A34">&lt;/</span><span class="token tag" style="color:#00009f">artifactId</span><span class="token tag punctuation" style="color:#393A34">&gt;</span><span class="token plain-text"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain-text"></span><span class="token tag punctuation" style="color:#393A34">&lt;/</span><span class="token tag" style="color:#00009f">dependency</span><span class="token tag punctuation" style="color:#393A34">&gt;</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="复制代码到剪贴板" title="复制" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg class="copyButtonIcon_y97N" viewBox="0 0 24 24"><path d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg class="copyButtonSuccessIcon_LjdS" viewBox="0 0 24 24"><path d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div></div></div></div><h3 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="本地配置">本地配置<a class="hash-link" href="#本地配置" title="标题的直接链接"></a></h3><p>基于配置中心的配置也是需要一个本地配置文件的，但这个配置文件是固定的模版格式。用于配置一些与配置中心进行数据通信相关的基础类参数。如下所示。</p><div class="language-jsx codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-jsx codeBlock_bY9V thin-scrollbar"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">spring</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">application</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">name</span><span class="token operator" style="color:#393A34">=</span><span class="token plain">pangu</span><span class="token operator" style="color:#393A34">-</span><span class="token plain">examples</span><span class="token operator" style="color:#393A34">-</span><span class="token plain">config</span><span class="token operator" style="color:#393A34">-</span><span class="token plain">remote</span><span class="token operator" style="color:#393A34">-</span><span class="token plain">nacos</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">spring</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">profiles</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">active</span><span class="token operator" style="color:#393A34">=</span><span class="token plain">$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">spring</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">profiles</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">active</span><span class="token operator" style="color:#393A34">:</span><span class="token plain">dev</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">nacos</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">config</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">bootstrap</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">enable</span><span class="token operator" style="color:#393A34">=</span><span class="token boolean" style="color:#36acaa">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">nacos</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">config</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">bootstrap</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">log</span><span class="token operator" style="color:#393A34">-</span><span class="token plain">enable</span><span class="token operator" style="color:#393A34">=</span><span class="token boolean" style="color:#36acaa">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">nacos</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">config</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">auto</span><span class="token operator" style="color:#393A34">-</span><span class="token plain">refresh</span><span class="token operator" style="color:#393A34">=</span><span class="token boolean" style="color:#36acaa">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">nacos</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">config</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">namespace</span><span class="token operator" style="color:#393A34">=</span><span class="token plain">$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">nacos</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">namespace</span><span class="token operator" style="color:#393A34">:</span><span class="token plain">pangu</span><span class="token operator" style="color:#393A34">-</span><span class="token plain">dev</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">nacos</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">config</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">server</span><span class="token operator" style="color:#393A34">-</span><span class="token plain">addr</span><span class="token operator" style="color:#393A34">=</span><span class="token plain">$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">nacos</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">server</span><span class="token operator" style="color:#393A34">-</span><span class="token plain">addr</span><span class="token operator" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">127.0</span><span class="token number" style="color:#36acaa">.0</span><span class="token number" style="color:#36acaa">.1</span><span class="token operator" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">8848</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">#nacos</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">config</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">type</span><span class="token operator" style="color:#393A34">=</span><span class="token plain">yaml</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">nacos</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">config</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">type</span><span class="token operator" style="color:#393A34">=</span><span class="token plain">properties</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">nacos</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">config</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">data</span><span class="token operator" style="color:#393A34">-</span><span class="token plain">id</span><span class="token operator" style="color:#393A34">=</span><span class="token plain">$</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">spring</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">application</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">name</span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="复制代码到剪贴板" title="复制" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg class="copyButtonIcon_y97N" viewBox="0 0 24 24"><path d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg class="copyButtonSuccessIcon_LjdS" viewBox="0 0 24 24"><path d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div><h4 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="关键配置项说明">关键配置项说明<a class="hash-link" href="#关键配置项说明" title="标题的直接链接"></a></h4><ul><li>nacos.config.auto-refresh<br>配置中心的配置变更后自动刷新到配置客户端 </li><li>nacos.config.namespace<br>命名空间（注意是对应命名空间的 ID 值），建议使用命名空间来区分部署环境 </li><li>nacos.config.server-addr<br>配置中心通信地址 </li><li>nacos.config.type<br>配置中心使用的配置格式（ properties、yaml 等）   </li><li>nacos.config.data-id<br>配置中心某配置集的唯一标识 </li></ul><h3 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="配置中心配置">配置中心配置<a class="hash-link" href="#配置中心配置" title="标题的直接链接"></a></h3><p>在进行完上述本地配置后，我们的应用就能和配置中心进行数据同步了。现在根据本地配置信息在配置中心创建相对应的命名空间和同名 data-id 的配置集。</p><details class="details_lb9f alert alert--info details_b_Ee" data-collapsed="true"><summary><b>快速 QA：</b>客户端是如何与 Nacos 配置中心进行数据同步的？</summary><div><div class="collapsibleContent_i85q"><div>客户端通过 http 长轮询机制拉取 nacos server 端的配置数据，并会在本地创建配置快照（容灾）。在长轮询的超时等待过程中，nacos server 端如果配置发生改变，会主动将配置写入 response 并返回，模拟了“推送”效果。所以客户端能实时感知配置中心的配置变化。</div></div></div></details><h4 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="创建命名空间">创建命名空间<a class="hash-link" href="#创建命名空间" title="标题的直接链接"></a></h4><p>在 Nacos 管理系统的『命名空间』菜单新建 ID 为 <code>pangu-dev</code> 的命名空间（此 ID 即为上述配置项 nacos.config.namespace 的值）。如下图所示。</p><p><img loading="lazy" alt="创建命名空间" src="/pangu-framework/assets/images/5-pangu-framework-nacos-fe8c6993888d62ca44a92af4f8cb1a53.png" width="2870" height="766" class="img_ev3q"></p><h4 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="创建配置集">创建配置集<a class="hash-link" href="#创建配置集" title="标题的直接链接"></a></h4><p>一个命名空间下可以创建多组配置集，每个配置集由 data-id 来唯一标识。在 Nacos 管理系统的『配置管理-配置列表』菜单新建 data-id 值为 <code>pangu-examples-config-remote-nacos</code> 的配置集。如下图所示。</p><div class="tabs-container tabList__CuJ"><ul role="tablist" aria-orientation="horizontal" class="tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_LNqP tabs__item--active">配置集列表</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_LNqP">新增/编辑配置集</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_Ymn6"><p><img loading="lazy" alt="创建配置集" src="/pangu-framework/assets/images/6-pangu-framework-nacos-0a9156bbb5b3f7d49c4c50c5e0fb61a5.png" width="2624" height="726" class="img_ev3q"></p></div><div role="tabpanel" class="tabItem_Ymn6" hidden=""><p><img loading="lazy" alt="创建配置集" src="/pangu-framework/assets/images/7-pangu-framework-nacos-31a90858740c790cd14ec9e0b9a676a2.png" width="2240" height="1370" class="img_ev3q"></p></div></div></div><h3 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="启动入口">启动入口<a class="hash-link" href="#启动入口" title="标题的直接链接"></a></h3><div class="language-jsx codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-jsx codeBlock_bY9V thin-scrollbar"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">@</span><span class="token maybe-class-name">SpringBootApplication</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">public</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> </span><span class="token class-name">NacosConfigurationApplication</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">public</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">static</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">void</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">main</span><span class="token punctuation" style="color:#393A34">(</span><span class="token parameter known-class-name class-name">String</span><span class="token parameter punctuation" style="color:#393A34">[</span><span class="token parameter punctuation" style="color:#393A34">]</span><span class="token parameter"> args</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token maybe-class-name">PanGuApplicationBuilder</span><span class="token punctuation" style="color:#393A34">.</span><span class="token method function property-access" style="color:#d73a49">init</span><span class="token punctuation" style="color:#393A34">(</span><span class="token maybe-class-name">NacosConfigurationApplication</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">class</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token method function property-access" style="color:#d73a49">run</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">args</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="复制代码到剪贴板" title="复制" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg class="copyButtonIcon_y97N" viewBox="0 0 24 24"><path d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg class="copyButtonSuccessIcon_LjdS" viewBox="0 0 24 24"><path d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div><h3 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="使用配置">使用配置<a class="hash-link" href="#使用配置" title="标题的直接链接"></a></h3><p>至此，我们就可以在应用中使用 <code>@NacosValue</code> 注解来获取配置项了。如下代码所示。</p><div class="language-jsx codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-jsx codeBlock_bY9V thin-scrollbar"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">/**</span><br></span><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic"> * 开启 autoRefreshed配置项, 可以实现参数的动态刷新</span><br></span><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic"> */</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">@</span><span class="token function maybe-class-name" style="color:#d73a49">NacosValue</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">value </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;${demo.app.id}&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">private</span><span class="token plain"> </span><span class="token known-class-name class-name">String</span><span class="token plain"> appId</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">@</span><span class="token function maybe-class-name" style="color:#d73a49">NacosValue</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">value </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;${demo.app.name}&quot;</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> autoRefreshed </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token boolean" style="color:#36acaa">true</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">private</span><span class="token plain"> </span><span class="token known-class-name class-name">String</span><span class="token plain"> appName</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">@</span><span class="token function maybe-class-name" style="color:#d73a49">NacosValue</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">value </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;${demo.app.author}&quot;</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> autoRefreshed </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token boolean" style="color:#36acaa">true</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">private</span><span class="token plain"> </span><span class="token known-class-name class-name">String</span><span class="token plain"> appAuthor</span><span class="token punctuation" style="color:#393A34">;</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="复制代码到剪贴板" title="复制" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg class="copyButtonIcon_y97N" viewBox="0 0 24 24"><path d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg class="copyButtonSuccessIcon_LjdS" viewBox="0 0 24 24"><path d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div><details class="details_lb9f alert alert--info details_b_Ee" data-collapsed="true"><summary><b>快速 QA：</b>范例只演示了几个简单的变量参数，数据库等中间件的连接配置信息可以放配置中心吗？</summary><div><div class="collapsibleContent_i85q"><div>当然是可以的，干就完了。</div></div></div></details><h2 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="彩蛋基于配置中心的日志级别热切换">彩蛋：基于配置中心的日志级别热切换<a class="hash-link" href="#彩蛋基于配置中心的日志级别热切换" title="标题的直接链接"></a></h2><p>为了增强日志输出的可观测性，盘古基础模块实现了基于配置中心的日志级别热切换能力。只需要在配置中心修改或新增日志级别配置，则对应的日志输出级别即刻实时生效。</p><div class="language-jsx codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-jsx codeBlock_bY9V thin-scrollbar"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">#日志</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">logging</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">level</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">root</span><span class="token operator" style="color:#393A34">=</span><span class="token constant" style="color:#36acaa">INFO</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">logging</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">level</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">com</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">gitee</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">pulanos</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">pangu</span><span class="token operator" style="color:#393A34">=</span><span class="token constant" style="color:#36acaa">INFO</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="复制代码到剪贴板" title="复制" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg class="copyButtonIcon_y97N" viewBox="0 0 24 24"><path d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg class="copyButtonSuccessIcon_LjdS" viewBox="0 0 24 24"><path d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div><h2 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="本文相关范例源码">本文相关范例源码<a class="hash-link" href="#本文相关范例源码" title="标题的直接链接"></a></h2><ul><li><a href="https://gitee.com/pulanos/pangu-framework/tree/master/pangu-examples/pangu-examples-config-remote-nacos" target="_blank" rel="noopener noreferrer">pangu-examples-config-remote-nacos</a>：配置中心参考范例</li><li><a href="https://gitee.com/pulanos/pangu-framework/tree/master/pangu-examples/pangu-examples-log-dynamic" target="_blank" rel="noopener noreferrer">pangu-examples-log-dynamic</a>：基于配置中心的日志级别热切换参考范例</li></ul><h2 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="下一步">下一步<a class="hash-link" href="#下一步" title="标题的直接链接"></a></h2><p>继续阅读其它章节获取你想要的答案或通过我们的 <a href="/pangu-framework/community">开发者社区</a> 寻求更多帮助。</p></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="theme-doc-footer-tags-row row margin-bottom--sm"><div class="col"><b>标签：</b><ul class="tags_jXut padding--none margin-left--sm"><li class="tag_QGVx"><a class="tag_zVej tagRegular_sFm0" href="/pangu-framework/docs/tags/nacos">nacos</a></li><li class="tag_QGVx"><a class="tag_zVej tagRegular_sFm0" href="/pangu-framework/docs/tags/配置中心">配置中心</a></li><li class="tag_QGVx"><a class="tag_zVej tagRegular_sFm0" href="/pangu-framework/docs/tags/盘古简介">盘古简介</a></li><li class="tag_QGVx"><a class="tag_zVej tagRegular_sFm0" href="/pangu-framework/docs/tags/盘古架构">盘古架构</a></li></ul></div></div><div class="theme-doc-footer-edit-meta-row row"><div class="col"><a href="https://gitee.com/pulanos/pangu-framework/tree/master/pangu-website/docs/advanced-guide/配置中心.md" target="_blank" rel="noreferrer noopener" class="theme-edit-this-page"><svg fill="currentColor" height="20" width="20" viewBox="0 0 40 40" class="iconEdit_Z9Sw" aria-hidden="true"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>编辑此页</a></div><div class="col lastUpdated_vwxv"><span class="theme-last-updated">最后<!-- -->由 <b>xiongchun</b> <!-- -->更新</span></div></div></footer></article><nav class="pagination-nav docusaurus-mt-lg" aria-label="文档分页导航"><a class="pagination-nav__link pagination-nav__link--prev" href="/pangu-framework/docs/quick-start/gateway/shenyu"><div class="pagination-nav__sublabel">上一页</div><div class="pagination-nav__label">基于 ShenYu 泛化调用模式</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/pangu-framework/docs/advanced-guide/nacos-regist-center"><div class="pagination-nav__sublabel">下一页</div><div class="pagination-nav__label">注册中心</div></a></nav></div></div><div class="col col--3"><div class="tableOfContents_bqdL thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a href="#配置中心介绍" class="table-of-contents__link toc-highlight">配置中心介绍</a><ul><li><a href="#相关名词解释" class="table-of-contents__link toc-highlight">相关名词解释</a></li><li><a href="#本地配置与配置中心对比" class="table-of-contents__link toc-highlight">本地配置与配置中心对比</a></li></ul></li><li><a href="#配置中心实战" class="table-of-contents__link toc-highlight">配置中心实战</a><ul><li><a href="#安装相关盘古模块" class="table-of-contents__link toc-highlight">安装相关盘古模块</a></li><li><a href="#本地配置" class="table-of-contents__link toc-highlight">本地配置</a></li><li><a href="#配置中心配置" class="table-of-contents__link toc-highlight">配置中心配置</a></li><li><a href="#启动入口" class="table-of-contents__link toc-highlight">启动入口</a></li><li><a href="#使用配置" class="table-of-contents__link toc-highlight">使用配置</a></li></ul></li><li><a href="#彩蛋基于配置中心的日志级别热切换" class="table-of-contents__link toc-highlight">彩蛋：基于配置中心的日志级别热切换</a></li><li><a href="#本文相关范例源码" class="table-of-contents__link toc-highlight">本文相关范例源码</a></li><li><a href="#下一步" class="table-of-contents__link toc-highlight">下一步</a></li></ul></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container container-fluid"><div class="row footer__links"><div class="col footer__col"><div class="footer__title">文档</div><ul class="footer__items clean-list"><li class="footer__item"><a class="footer__link-item" href="/pangu-framework/docs/intro">盘古微服务开发</a></li><li class="footer__item"><a class="footer__link-item" href="/pangu-framework/admin/intro">盘古 Admin 开发</a></li><li class="footer__item"><a class="footer__link-item" href="/pangu-framework/app/intro">盘古 APP 开发</a></li></ul></div><div class="col footer__col"><div class="footer__title">源码</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://gitee.com/pulanos/pangu-framework" target="_blank" rel="noopener noreferrer" class="footer__link-item">Gitee PanGu Framework<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://gitcode.net/pulanos/pangu-framework" target="_blank" rel="noopener noreferrer" class="footer__link-item">GitCode PanGu Framework<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://github.com/xiongchun/pangu-framework" target="_blank" rel="noopener noreferrer" class="footer__link-item">GitHub PanGu Framework<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div><div class="col footer__col"><div class="footer__title">更多</div><ul class="footer__items clean-list"><li class="footer__item"><a class="footer__link-item" href="/pangu-framework/thanks">致敬</a></li><li class="footer__item"><a href="https://xiongchun.pulanit.com/blog/tags/%E7%9B%98%E5%8F%A4%E5%BC%80%E5%8F%91%E6%A1%86%E6%9E%B6" target="_blank" rel="noopener noreferrer" class="footer__link-item">博客</a></li><li class="footer__item"><a href="https://www.apache.org/" target="_blank" rel="noopener noreferrer" class="footer__link-item">Apache Software Foundation<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div></div><div class="footer__bottom text--center"><div class="footer__copyright">PanGu Dev Framework is Open Source and freely available under the <a target="_blank" class="ghostwhite" href="https://www.apache.org/licenses/LICENSE-2.0">Apache v2 License.</a> 
<br>Copyright © 2023 <a target="_blank" class="ghostwhite" href="https://www.pulanit.com">PuLan Open Source Community</a><br><img src="https://pangu.pulanit.com/img/dashi.gif"></div></div></div></footer></div>
<script src="/pangu-framework/assets/js/runtime~main.3d26c6de.js"></script>
<script src="/pangu-framework/assets/js/main.7db6da70.js"></script>
</body>
</html>