<p class="shortdesc">使用服务治理，须在用户环境下部署PAFA-Cloud团队提供的Portal-Agent基础服务，该服务采用单向长轮询机制连接到服务治理平台的Portal-Server，负责收集用户服务集群的相关信息，接收并执行服务治理平台下发的指令，从而对用户服务集群进行治理。</p> <section class="section prereq" id="Service_governance_access__prereq_vch_czl_bsb"><div class="tasklabel"><h2 class="doc-tairway">前提条件</h2></div> <ol class="ol" id="Service_governance_access__ol_z2p_1mt_3sb"> <li class="li">已创建应用、环境。</li> <li class="li">完成微服务环境搭建，即Portal-Agent服务的部署。</li> <li class="li">已部署过<strong class="ph b">Eureka注册中心</strong>，或者接入<strong class="ph b">Nacos注册中心</strong>。</li> </ol> </section> <section class="section context"><div class="tasklabel"><h2 class="doc-tairway">背景信息</h2></div> <p class="p">每套环境均部署了Portal-Server服务供对应环境下的用户服务集群连接，用户服务集群在部署Portal-Agent服务时，需根据实际场景连接到对应环境的Portal-Server。</p> </section> <section><div class="tasklabel"><h2 class="doc-tairway">操作步骤</h2></div><ol class="ol steps"><li class="li step stepexpand"> <span class="ph cmd"><strong class="ph b">开通防火墙</strong></span> <div class="itemgroup info"> <p class="p">Portal-Agent 需要连接到Portal-Server，以接入服务治理平台，启动Portal-Agent之前，请先检查网络是否能通。</p> <table class="table" id="Service_governance_access__table_ujp_nzl_bsb"><caption></caption><colgroup><col><col></colgroup><thead class="thead"> <tr class="row"> <th class="entry" id="Service_governance_access__table_ujp_nzl_bsb__entry__1"><strong class="ph b">环境类型</strong></th> <th class="entry" id="Service_governance_access__table_ujp_nzl_bsb__entry__2"><strong class="ph b">服务地址</strong></th> </tr> </thead><tbody class="tbody"> <tr class="row"> <td class="entry" headers="Service_governance_access__table_ujp_nzl_bsb__entry__1 "> <p class="p">开发</p> </td> <td class="entry" headers="Service_governance_access__table_ujp_nzl_bsb__entry__2 "> <p class="p">30.23.111.223:80</p> </td> </tr> <tr class="row"> <td class="entry" headers="Service_governance_access__table_ujp_nzl_bsb__entry__1 "> <p class="p">测试</p> </td> <td class="entry" headers="Service_governance_access__table_ujp_nzl_bsb__entry__2 "> <p class="p">30.115.65.158:80</p> </td> </tr> <tr class="row"> <td class="entry" headers="Service_governance_access__table_ujp_nzl_bsb__entry__1 "> <p class="p">生产</p> </td> <td class="entry" headers="Service_governance_access__table_ujp_nzl_bsb__entry__2 "> <p class="p">30.93.121.219:80</p> </td> </tr> </tbody></table> </div> </li><li class="li step stepexpand"> <span class="ph cmd"><strong class="ph b">本地启动Agent</strong></span> <div class="itemgroup info"> <p class="p">由于Agent的安装包根据注册中心不同，分为Eureka版本和Nacos版本，请根据自身注册中心不同，选择对于的版本启动。</p> <ul class="ul" id="Service_governance_access__ul_lry_pzl_bsb"> <li class="li"><strong class="ph b">Eureka版本</strong><p class="p">java -jar -Deureka.client.serviceUrl.defaultZone=<a class="xref" href="http://localhost:8761/eureka/" target="_blank" rel="external noopener">http://localhost:8761/eureka/</a> -DPORTAL_AGENT_KEY=*** agent-bootstrap-${version}.jar</p><table class="table" id="Service_governance_access__table_sxx_szl_bsb"><caption></caption><colgroup><col><col></colgroup><thead class="thead"> <tr class="row"> <th class="entry align-left" id="Service_governance_access__table_sxx_szl_bsb__entry__1"><strong class="ph b">变量</strong></th> <th class="entry align-left" id="Service_governance_access__table_sxx_szl_bsb__entry__2"><strong class="ph b">值</strong></th> </tr> </thead><tbody class="tbody"> <tr class="row"> <td class="entry align-left" headers="Service_governance_access__table_sxx_szl_bsb__entry__1 "> <p class="p">eureka.client.serviceUrl.defaultZone</p> </td> <td class="entry align-left" headers="Service_governance_access__table_sxx_szl_bsb__entry__2 "> <p class="p">配置注册中心地址，单节点为本机，也可配置集群地址</p> </td> </tr> <tr class="row"> <td class="entry align-left" headers="Service_governance_access__table_sxx_szl_bsb__entry__1 "> <p class="p">PORTAL_AGENT_KEY</p> </td> <td class="entry align-left" headers="Service_governance_access__table_sxx_szl_bsb__entry__2 "> <p class="p">Agent连接服务治理平台标识，最小15位，建议设置成UUID</p> </td> </tr> <tr class="row"> <td class="entry align-left" headers="Service_governance_access__table_sxx_szl_bsb__entry__1 "> <p class="p">PORTAL_SERVER_DOMAIN</p> </td> <td class="entry align-left" headers="Service_governance_access__table_sxx_szl_bsb__entry__2 "> <p class="p">按环境配置</p> </td> </tr> <tr class="row"> <td class="entry align-left" headers="Service_governance_access__table_sxx_szl_bsb__entry__1 "> <p class="p">version</p> </td> <td class="entry align-left" headers="Service_governance_access__table_sxx_szl_bsb__entry__2 "> <p class="p">请获取Agent最新版本，填写对应版本号</p> </td> </tr> </tbody></table></li> <li class="li"><strong class="ph b">Nacos版本</strong><p class="p">java -jar -DENV_PROFILE=CI -DNACOS_NAMESPACE=* -DPORTAL_AGENT_KEY=* agent-bootstrap-${version}.jar</p><table class="table" id="Service_governance_access__table_whs_xzl_bsb"><caption></caption><colgroup><col><col></colgroup><thead class="thead"> <tr class="row"> <th class="entry align-left" id="Service_governance_access__table_whs_xzl_bsb__entry__1"><strong class="ph b">变量</strong></th> <th class="entry align-left" id="Service_governance_access__table_whs_xzl_bsb__entry__2"><strong class="ph b">值</strong></th> </tr> </thead><tbody class="tbody"> <tr class="row"> <td class="entry align-left" headers="Service_governance_access__table_whs_xzl_bsb__entry__1 "> <p class="p">ENV_PROFILE</p> </td> <td class="entry align-left" headers="Service_governance_access__table_whs_xzl_bsb__entry__2 "> <p class="p">开发环境和办公网CI，测试STG，生产PRD，表示连接对应环境的Nacos注册中心</p> </td> </tr> <tr class="row"> <td class="entry align-left" headers="Service_governance_access__table_whs_xzl_bsb__entry__1 "> <p class="p">NACOS_NAMESPACE</p> </td> <td class="entry align-left" headers="Service_governance_access__table_whs_xzl_bsb__entry__2 "> <p class="p">连接Nacos注册中心标识</p> </td> </tr> <tr class="row"> <td class="entry align-left" headers="Service_governance_access__table_whs_xzl_bsb__entry__1 "> <p class="p">PORTAL_AGENT_KEY</p> </td> <td class="entry align-left" headers="Service_governance_access__table_whs_xzl_bsb__entry__2 "> <p class="p">Agent连接服务治理平台标识，最小15位，建议设置成UUID</p> </td> </tr> <tr class="row"> <td class="entry align-left" headers="Service_governance_access__table_whs_xzl_bsb__entry__1 "> <p class="p">PORTAL_SERVER_DOMAIN</p> </td> <td class="entry align-left" headers="Service_governance_access__table_whs_xzl_bsb__entry__2 "> <p class="p">按环境配置</p> </td> </tr> <tr class="row"> <td class="entry align-left" headers="Service_governance_access__table_whs_xzl_bsb__entry__1 "> <p class="p">version</p> </td> <td class="entry align-left" headers="Service_governance_access__table_whs_xzl_bsb__entry__2 "> <p class="p">请获取Agent最新版本，填写对应版本号</p> </td> </tr> </tbody></table></li> </ul> </div> </li><li class="li step stepexpand"> <span class="ph cmd"><strong class="ph b">启动Agent成功</strong></span> <div class="itemgroup info"><p class="p">当Agent日志启动出现如下信息，表示Agent已经连接上Portal服务治理平台，已经启动成功，但还没有与对应的环境绑定，需要在服务治理平台创建对应的环境。</p><pre class="pre codeblock" id="Service_governance_access__codeblock_xsm_11m_bsb"><code> Failed to apply token.error code:21001,msg:Current agent has not bound enviroment yet!</code></pre><img class="image" id="Service_governance_access__image_v1m_f1m_bsb" src="https://obs-cn-shanghai.fincloud.pinganyun.com/pacloud/20220910180811-143bdd849d35.png" width="800"></div> </li><li class="li step stepexpand"> <span class="ph cmd"><strong class="ph b">绑定Agent成功</strong></span> <div class="itemgroup info"><p class="p">当Agent启动日志如下显示时，表示绑定环境成功，此时可以登录服务治理平台进行相关操作。</p><img class="image" id="Service_governance_access__image_jr5_r1m_bsb" src="https://obs-cn-shanghai.fincloud.pinganyun.com/pacloud/20220910180811-1d71f8ce9791.png" width="800"></div> </li></ol></section>