YonBIPV3.0(R6_2407_1)旗舰版云平台-技术平台篇用友网络科技股份有限公司2024年9月用户手册1/190版权©2024用友集团版权所有。未经用友集团的书面许可，本用户手册任何整体或部分的内容不得被复制、复印、翻译或缩减以用于任何目的。本用户手册的内容在未经通知的情形下可能会发生改变，敬请留意。请注意：本用户手册的内容并不代表用友网络所做的承诺。用户手册2/190目录第一章总体概述...........................................................................................................................................41.1产品概述...........................................................................................................................................41.2产品价值...........................................................................................................................................51.3应用场景...........................................................................................................................................51.4基础架构...........................................................................................................................................6第二章操作指南...........................................................................................................................................72.1DevOps服务...................................................................................................................................72.1.1流水线........................................................................................................................................72.1.2微服务管理............................................................................................................................202.1.3变更大盘.................................................................................................................................432.1.4流量组管理............................................................................................................................432.1.5插件管理.................................................................................................................................492.2YKS容器云服务............................................................................................................................592.2.1资源池管理............................................................................................................................602.2.2镜像仓库.................................................................................................................................632.2.3存储管理.................................................................................................................................652.2.4集群管理.................................................................................................................................672.2.5环境管理.................................................................................................................................692.3微服务治理....................................................................................................................................702.3.1注册中心.................................................................................................................................70用户手册3/1902.3.2熔断管理.................................................................................................................................722.4YMS控制台....................................................................................................................................732.4.1中间件配置............................................................................................................................732.4.2微服务配置.........................................................................................................................1162.4.3公共配置..............................................................................................................................1692.4.4配置查询..............................................................................................................................1702.4.5配置中心..............................................................................................................................1702.4.6权限管理..............................................................................................................................1752.4.7维度管理..............................................................................................................................180第三章产品常见问题及解答...............................................................................................................185用户手册4/190第一章总体概述1.1产品概述用友YMSCloud技术平台(原技术中台)是YonBIP的PaaS平台，是基于云原生技术，集容器云、DevOps、服务治理、监控运维、测试工具为一体的综合技术支撑平台。iUAP技术平台是在继承原有的云服务基础上，完美融合Kubernetes和docker，深入践行DevOps理念，全方位监控业务应用及其底层资源，同时针对影响系统稳定性的问题做深入优化，满足企业所需的应用微服务化、业务快速交付、系统稳定运行、运维自动化等需求，助力企业实现业务及管理快速创新。主要功能包括：1.资源管理：以资源池的方式进行计算节点管理，自由添加自有主机，进行智能化的资源调度与分配。2.容器服务：以应用为中心，简化上云过程，为应用提供扩容、缩容、升级、回滚等功能，提供资源池管理及监控能力。3.DevOps：全新流水线，更换了底层引擎(Tekton)，优化了整个交互过程，流水线执行效率得到了大幅度的提升，使用过程更加便捷。4.持续交付：以Docker镜像为应用交付载体，支持灰度发布，实现业务上线无感知。5.镜像仓库：提供私有镜像仓库，镜像仓库中的应用开箱即用，同时支持私有镜像高可用。6.微服务治理：支持springcloud体系下微服务架构，提供业务服务的注册，发现，熔断，升级等一系列微服务管理能力。7.自动化运维：通过全面的监控报警、日志收集、健康检查、服务自愈、泛域名解析及应用链路管理等，减轻运维负担。8.日志管理：平台能够解决海量日志处理难题，数据加密存储。同时提供日志检索能力，满足不同类型需求。9.分流管理：能够按照业务规则(如租户、路径或自定义规则)进行分流，实现流量的可控管理，保障关键业务服务的同时使资源使用更加合理。10.环境迁移：支持用友内部或用户现场环境的快速迁移，实现大版本的快速、稳定的升级。11.云机一体：帮助技术人员本地调试云上产品功能，加速线上问题解决效率。用户手册5/19012.Standalone部署模式：除以容器作为部署环境外，YMSCloud还支持以物理资源作为底层资源，与普通物理资源不同的是，YMSCloud的Standalone版支持扩缩容，分流，进程组(实例)的重启，暂停，健康检查等内容。1.2产品价值YonBIP技术平台是为各领域业务的发展而打造的满足企业级应用需要的全生命周期管理的综合技术平台。底层基于容器技术（Docker），全新的技术模式正在快速改变着公司和用户创建、发布和运行分布式应用的方式。DevOps的理念使得软件行业日益清晰地认识到：为了按时交付软件产品和服务，开发、运维和运营工作必须紧密合作。YonBIP技术平台将DevOps理念融入其中，提供了企业上云所需的云原生技术支撑，为企业级应用开发、运维、监控、运营一站式云原生技术支撑服务。1.3应用场景在技术人员的日常工作中，资源管理、容器服务、持续集成、持续交付、镜像仓库等应用基础服务，同时为应用的微服务架构落地提供完备的支撑，结合DevOps的理念，通过提供自动化运维、日志管理、运营分析、中间件服务等功能，帮助开发及运维人员降低产品研发迭代过程中的负担。YonBIP技术平台围绕YMS构建了完整的工具链体系和标准，有效支撑了微服务的规范化治理，实现了微服务的配置简化和资源瘦身。建设了完备的YMS诊断体系，结合云机一体能力，开发者可以更高效的排查故障问题。提供了标准化的持续集成和持续交付能力，建立了完善的制品管理体系和简单可重复的安装流程，支持多数据中心多云的部署模式；其全新的安装出盘工程化体系，实现了YonBIP发版的快速敏捷化，提高项目快速交付能力；客户现场环境和基础设施复杂多样，安装器支持YMS服务的迁移部署过程，通过服务的可分可合部署模式，可以将YonBIP安装盘发布到各不同基础设施，并结合补丁机制，实现客户现场环境的持续升级。通过技术栈的统一，实现了用友YonBIPV3形成了用友独有的云上云下一体化交付体系，实现了产品→研发→测试→交付→实施→产品的良性循环。YonBIP技术平台信创版本，将YonBIPV3快速与信创产品对接，作为YonBIPV3的信创用户手册6/190底座，技术平台信创版本实现了信创产品适配体系化，适配范围包括服务器、CPU芯片、操作系统、数据库、中间件等，使用友系产品具备了信创产品快速适配能力。1.4基础架构YMSCloud技术平台是用友云产品家族的一部分，用友云定位于面向社会化商业应用的基础平台，而YMSCloud技术平台则是基础平台的底层技术支撑，以应用服务为中心，为企业应用服务提供需求、设计、开发、测试、部署、监控、运维、交付的全系服务，打造软件从生产到交付的技术生态。YMSCloud技术平台致力于解决如下几个方面的问题：1.企业级应用特性问题；2.研发效率和成本问题；3.混合云的纠结与挑战问题；4.应用生态和云市场统一打通的问题。5.企业产品能力快速交付。6.企业IT资源成本问题。从应用层面来看，YMSCloud技术平台底层可以接入各种不同的IaaS资源，以资源池的方式进行管理；上层基于容器技术，可以支持运行各种形态的云。从而解决开发、运维及运营的各种难题。从技术组件层面来看，YMSCloud技术平台致力于帮助用户打造高可用的线上系统，这需要众多的组件来支撑：配置管理、发布部署、负载均衡、服务发现、域名接入、弹性伸缩等。通过不断的核心链路优化及监控报警、限流、服务治理等手段，使得云服务的运行更加可靠。从DevOps的层面来看，YMSCloud技术平台能够完整的支持应用在云上的开发、上线过程，通过多种不同的应用发布入口，充分发挥docker生态的优势，更好的符合开发者的使用习惯。YMSCloud技术平台产品架构图如下：用户手册7/190YMSCloud技术平台架构图第二章操作指南2.1DevOps服务2.1.1流水线2.1.1.1概述YonBIP技术平台提供了针对各种类型的微服务进行快速迭代开发的流水线功能，包括持续集成、持续构建等，新版流水线替换了底层引擎，使流水线执行效率得到了很大的提升，同时配合插件能力，让流水线的自由编排程度得到了有效扩展。2.1.1.2流水线入口登录YonBIP技术平台，点击左侧四叶草→YMSCloud，点击DevOps服务菜单，然后点击进入流水线(新)(由于部分项目比较老旧，因此暂不下架老版流水线)，默认展示当前用户下流水线执行情况列表，流水线最新的执行状态等信息将在此展示出来。用户手册8/190流水线执行状态列表：2.1.1.3创建流水线1、在流水线列表页面，点击“创建流水线”，弹出如下页面：用户手册9/190流水线名称：根据自己的实际情况填写，不与其他流水线重复即可(重复会有提示)；数据中心/环境：选择流水线最后会部署在哪个数据中心以及环境中；产品线/领域/子领域：填写流水线所属领域，创建后可在流水线列表左侧树进行筛选流水线编：根据实际情况自行填写，不与其他流水线重复即可(重复会有提示)；2、选择创建流水线需要哪种模板，根据自己的实际情况，选择好创建即可。用户手册10/1903、选择好后，会默认给出模板提供的节点，可根据自己的实际情况进行修改。4、新版流水线会提供各类任务节点，帮助技术人员快速构建部署，具体节点介绍如下：2.1.1.3.1流水线源流水线源既流水线开始的第一个环节，新版流水线包含了四种流水线源包括代码源(从代码库中拉取)，已有镜像(填写已有镜像的地址)，应用包(上传自己制作的war包)，已有流水线(根据已有流水线的产出物作为这一条流水线的源，可以是包，也可以是镜像)。用户手册11/1902.1.1.3.2编译构建编译构建节点提供了自行编写编译命令的能力(如果不填写，将使用默认编译命令，填写则执行填写内容)，除此之外还有编译前、后所需要执行的脚本，也可以根据实际情况进行填写。如果是非YMS应用(创建流水线时选择的类型)，是不需要回填external依赖jar包的，YMS应用需要填写，帮助我们用友自己的业务进行统一的二三方包回填，进而进行编译，注意：只有流水线源是使用拉取代码的方式才使用这种回填方式。是否包含子项目默认不需要选择，如果自己对Maven中POM的路径有特殊要求，可自行指定，在编译的过程中就可读取填写的路径。用户手册12/1902.1.1.3.3YmsWar包回填当流水线源使用应用包时，使用YmsWar包方式进行回填；其意义与编译过程的YMS回填是一样的。2.1.1.3.4镜像构建在镜像构建节点中，选择“不使用dockerfile“构建时会使用系统默认的文件，选择”自定义dockerfile“构建时会使用自定义的dockerfile，选择根目录dockerfile构建时会使用构建的工程根目录下的dockerfile；勾选了不使用缓存，则所有的docker的镜像层全部重新进行build，使用缓存的话，则不会重复build未修改的镜像层。自定义基础镜像是在YKS容器云服务的镜像仓库中进行上传及管理的，详见2.2.2。用户手册13/1902.1.1.3.5前端引擎前端引擎CI：用户手册14/190前端引擎CD：2.1.1.3.6同步YPRYPR是技术平台的制品管理仓库，当使用“同步YPR“节点时，流水线所产生的制品会直接发送到YPR制品仓库中的”微服务“列表中。不抽取db，既是否要抽取流水线源中的SQL信息，SQL目录的地址为固定地址，仅为专属化出盘使用。用户手册15/1902.1.1.3.7请求部署与人工审核配合使用，审核人员能够看到请求部署节点所填写的更新内容。2.1.1.3.8部署部署节点包括了普通的部署，调试实例的部署、分流的部署以及灰度部署，其中调试部署执行后会产生新的调试实例，分流部署会产生分流实例，灰度部署会产生灰度实例，对应的实例都可以在微服务管理中查询到。用户手册16/190部署：在部署时首选要选择资源池，然后选择对应的调度策略，不同的策略部署的方式皆不相同；默认调度：无规律调度，随机部署在资源池中的主机上；指定节点：可选择要部署在哪一台主机上；匹配节点：会部署在对应标签的主机上；非严格匹配：部署在技术平台外的第三方集群上，应对场景：当用户已有集群时，通过非严格匹配的方式部署到客户提供的集群中；多实例反亲和性：会在所有主机上平均部署；调试部署：调试部署是重新拉取代码后重新生成一个调试实例，调试规则会根据“个人域账号”自用户手册17/190动填充。分流部署：分流部署处直接选择规则即可，规则创建具体信息请参见2.1.6流量规则管理。灰度部署：灰度部署分为公共规则与自定义规则，公共规则为系统内置规则，可直接使用，也可以自定义规则，详见2.1.6流量规则管理。用户手册18/1902.1.1.3.9人工审核流水线在执行过程中，如果需要人为参与，可使用人工审核环节，如部署前的审批，质量检查后是否具备发布的条件等，如果人工审核不通过或未审核时，流水线会暂停执行。需要审核的工单，可在“资源审批→流水线审核“中找到(注意配置好审批人，待审核的工单只会出现在审批人的代办中)。2.1.1.3.10自定义可将个性化的需求，通过写shell脚本的方式，插入到流水线执行中。用户手册19/1902.1.1.3.11自定义插件自定义的插件是作为流水线的扩展而存在，用户可以根据自己的需求制作相应的插件，并直接引入到流水线中，不同的插件需要提供的参数也不尽相同，此处只做插件的使用，插件管理及制作可参考2.1.7插件管理。2.1.1.4流水线详情在流水线详情页面中，在页面左侧可以查看到流水线的基础信息，包括创建人，执行人，流水线编码及ID等，右侧的信息卡片中展示出了每个阶段执行的详细信息，包括每个阶段执行所需要的参数配置以及产出物；右上角的功能区域包括了对流水线操作。推送镜像：将本条流水线所产生的镜像，推送到其他的环境中；用户手册20/190执行流水线：点击后会弹出工作流的选择页面，选择要执行哪一个工作流后，点击执行即可按照新的工作流进行执行；应用配置：可在权限管理中配置流水线的管理权限；在流水线转移中修改流水线的所属权，主要的场景为流水线的创建人不再负责原有工作，新人接手后的调整。微服务管理：点击后跳转到本条流水线对应的微服务中；编辑：点击后会弹出工作流的选择页面，选择要编辑的工作流，进行编辑即可。2.1.2微服务管理2.1.2.1概述用友云YonBIP技术平台的微服务管理，主要是围绕微服务的运行态进行综合性管理，提供的能力包括微服务的启动、暂停、销毁、迁移、升级、回滚、扩缩、健康度检查、故障隔离、云机一体、分流、日志收集等能力，帮助技术人员规范化、快速管理微服务。2.1.2.2微服务管理入口在YonBIP技术平台菜单栏的DevOps服务下面点击：微服务管理即可进入微服务管理列表页面。进入微服务列表后，可以查看已部署的应用列表，支持通过产品线、产品、数据中心、环境、资源池、主机等条件进行查询。用户手册21/1902.1.2.3微服务详情基本信息在基本信息页面，显示了微服务的编码、镜像、命名空间、应用ID等信息；同时提供了启动/暂停、重启、配置重启、销毁、升级、回滚等功能；启动/暂停：将应用暂停，这时应用的实例数变为0，暂停的按钮会变成启动字样，点击后应用将启动。重启：将应用的所有实例重启，先启动相同的实例数，健康后销毁旧的实例，实现蓝绿切换。配置重启：在基本信息页面可以编辑监控与日志、资源申请范围，容器启动命令等，但是修改配置后并不生效，可通过点击配置重启，使其生效。销毁：删除微服务，将微服务完全销毁。迁移：将微服务迁移到指定的资源池中。升级：将微服务升级到指定版本。回滚：将微服务回滚到指定版本。用户手册22/190k8s从主机发出的实例健康监测，包括接口可用性、端口连通性、命令是否可执行等，只需要配置好访问协议、访问路径以及访问规则即可。一旦实例管理中的某一个实例容器运行状态异常，可以点击检测进行监控状态检查。2.1.2.3.1实例管理在实例管理中，我们可以通过手动修改的方式，增加或减少应用的实例数(启动的POD个数)。正常实例：通过正常启动或流水线执行所产生的实例；灰度实例：在流水线部署环节，选择了灰度部署，执行后所产生的实例；调试实例：在流水线部署环节，选择了调试部署，执行后所产生的实例；分流实例：在流水线部署环节，选择了分流部署，执行后所产生的实例；故障隔离：通过点击实例→操作中的故障隔离按钮，将有问题的实例与其他实例进行隔离，点击故障隔离后实例会在故障隔离中。右上角中会展示出所有对实例的操作按钮，包括重启服务(所有实例重启)，实例重启(单实例重启)，实例强杀，新增调试实例，批处理命令(为了在正常启动容器的过程中，能够执行一些额外的个性化操作而准备的，目前只支持shell脚本，填写好shell脚本并保存后，会在容器启动过程中执行)等；在下放会展示出具体某一个实例的详细信息，调试工具，日志下载，YMAL文件等。用户手册23/1902.1.2.3.2云机一体在测试环境中，可以在实例管理的右上角看到云机一体按钮，这里做一下详细说明。云机一体的含义指将本地的网络与在云端运行的K8S网络打通，以方便本地调试，提升研发效率。开机云机一体调试之后，对于带有特定cookie的流量，将从云端劫持转发到本地。本地如果依赖云端的其他服务或中间件，流量随后也可以到达云端。云机一体流程示意图如下：用户手册24/190支持的环境列表：环境是否支持备注公有云测试环境支持公有云日常环境不支持公有云预发，灰度，生产环境不支持公有云日常多数据库环境不支持公有云平台开发环境支持参考4.10小节其他公有云环境不支持专属化环境支持从YonBIPv3_R1_2208版本开始，参考4.11小节用户手册25/190前提条件前提条件功能YMS项目，并且middleware版本5.5.14-RELEASE及以上使用注册中心启动命令加上-Denable_cloud_debug=truerpc调用使用统一域名设置本地启动端口为62871打通容器云到本地的网络从2022年6月5日起，集群安全部门将研发网段与办公网段做了网络隔离，只开了一个端口用于云机一体调试，即62871端口。因此，对于公有云测试环境，为了能使云端的流量能够到达本地，本地服务的启动端口必须设置为62871。具体设置方法如下图所示：使用流程注意：3.1和3.2介绍的2种使用方式是二选一，只使用其中一种即可。使用方法使用流程3.1直接从类启动1.设置app.versionVM选项2.设置工作台cookie3.设置hubbleagent（可选）3.2从yms插件启动1.配置云机一体maven插件2.从maven插件启动3.设置插件参数注：启动后，此插件会自动完成上面从类启动的流程中的3个步骤。3.1直接从类启动用户手册26/1903.1.1设置app.version标识此程序启动后将在注册中心注册，版本号即为上述app.version的值。同时，在访问工作台时，此标识符将作为cookie值传入，用来识别调试流量，将调试流量劫持并转发到本地。cookie的自动植入方法请参考3.1.3。注：为了避免调试标识符冲突，请将此值设置为自己的域账号前缀。【2023年2月16日更新】集团研发管理部开发的云机一体使用情况统计报表即将上线，为了更准确的将云机一体使用者对应到具体人员，需要大家使用云机一体时注册的app.version为域账号前缀（即邮箱的@前的部分）。为了保证统计数据的准确性，请大家注意填写的规范性与正确性！例如，张三的邮箱为zhangsan@yonyou.com,那么使用云机一体时，填写的app.version为zhangsan3.1.2设置注册中心地址参数：-Diris.serviceUrl.defaultZone=http://172.20.28.67:8080/registry-0/eureka/,http://172.20.28.79:8080/registry-1/eureka/,http://172.20.28.233:8080/registry-2/eureka/3.1.3Cookie自动植入为了浏览器发送请求时自动带入调试cookie，请访问如下连接进行cookie自动植入，https://bip-test.yyuap.com/version.html用户手册27/190注：此处填入的值必须与3.1.1中设置的标识一致。3.2通过云机一体Maven插件启动应用（YMS2.1或以上）3.2.1配置云机一体maven插件在项目的主pom文件中增加如下设置，<openOperationGuide>true</openOperationGuide>如下图所示，3.2.2从maven插件启动用户手册28/1903.2.3设置插件参数从此插件启动后，应用程序会在注册中心注册，版本号即为此调试标识符。同时，从浏览器访问工作台时，会自动携带包含此标识符的cookie值。注：灰度策略值即为调试标识符，为了避免冲突，请将此值设置为自己的域账号。3.3查看已启动的云机一体实例测试环境的云机一体实例可以在技术中台微服务管理的实例列表中看到其他环境云机一体实例需要到对应的注册中心查看，如：平台开发环境：http://172.20.34.35/registry-0/日常多数据库环境：http://172.20.34.122/registry-0/4.常见问题4.1流水线与微服务关联对于Rest服务，请检查微服务Code(一般为application.properties中的spring.application.name项)与流水线的应用编码是否匹配。如果不匹配，请进入流水线，选择“测试环境”，点击右上角“应用配置”图标，点击“关联微服务”按钮。用户手册29/190可以通过如下接口检查是否已经绑定成功：：https://developer.yonyoucloud.com/confcenter/api/v1/appstreamline/findMicroServ?streamLineCode=iuap-apdoc-basedoc&streamLineProfile=test请修改streamLineCode为页面显示的应用编码，profile为相应的环境code。注：专属化环境请使用专属化的技术中台域名。输出大致如下，请确保appCode字段是正确的：4.2domainkey与微服务关联对于MDF转发的请求，需要确定domainkey与微服务的对应关系正确。domainkey的获取方式如下图：用户手册30/190得到domaikey之后，可以通过如下接口查询其与微服务的对应关系：https://bip-test.yyuap.com/mdf-node/private/common-config/keytocode/<domainkey>注：请见<domainkey>替换为自己实际获取的值。注：专属化环境请使用专属化的业务域名。MDF会根据此接口的返回值获取appcode，并使用4.3.2小节介绍的接口在注册中心查询注册实例列表。接口返回有两种情况：如果返回404，则直接使用domainkey作为appcode来查询注册实例列表如果返回200，则使用返回的data作为appcode来查询注册实例列表4.3确定本地服务启动并注册成功4.3.1验证本地服务启动成功通过如下命令测试本地服务是否已经启动成功：curl"http://<本地IP地址>:62871/CloudRemoteCall/"例如如果本地的IP地址为10.6.237.25，则测试的例子如下:注意：测试的时候一定要注意将IP地址替换为自己本地电脑的IP地址。如果是办公室用户手册31/190Wifi接入，IP地址为10.6.x.x；如果是iNodeSSLVPN接入，则IP地址为10.8.x.x。4.3.2验证本地服务注册成功通过如下链接检查注册中心的注册列表，请确认本地的IP地址在列表中，并且版本标识符为3.1.1或3.2.3中设置的标识符。https://developer.yonyoucloud.com/governance/registry/getInstanceIportByCode?appCode=<微服务code>&env=test注：专属化环境请使用专属化的技术中台域名。例如，对于微服务iuap-apdoc-base,可以使用如下查询命令：curl"https://developer.yonyoucloud.com/governance/registry/getInstanceIportByCode?appCode=iuap-apdoc-basedoc&env=test"请确认在查询结果中包含3.1.1或3.2.3中设置的标识符，以及本地的IP地址和云机一体端口号。对应的输出大致如下：4.4确定容器控制台到本地的网络连通如果确认一切设置正常，但是无法成功连接本地机器的服务，可以通过K8S上的任何一个容器的容器控制台，测试到达本地的连通性。使用curl命令测试的例子如下图所示：使用telent命令测试的例子如下图所示：如果不能连通：⚫确定注册的IP地址是否正确，办公网的IP地址位于10.6.0.0/16网段，iNodeSSLVPN的IP地址位于10.8.0.0/16网段。如果注册的地址不在这两个地址范围内，则需要关闭用户手册32/190无用的网卡并重启服务，或者依照4.5小节的方法设置环境变量后重启服务。⚫对于Windows操作系统，需要关闭Windows防火墙。4.5多网卡或VPN使用场景如果本地电脑有多网卡，或者通过VPN连入办公网时，由于服务启动时无法指定在注册中心注册的地址，所以如果注册的地址不是正确的地址，会导致从测试集群连不上本机地址，从而导致云机一体本地调试不可用。为了解决这个问题，可以在服务启动前，配置一个HOST和PORT的环境变量。比如，使用VPN办公，则将HOST和PORT设置为VPN的地址，端口为本地服务对外提供服务的端口。这样在注册中心会注册除了默认的网卡地址，也会注册VPN的地址。在设置之前，先获取本机电脑的VPN地址（Windows通过命令ipconfig,Mac通过命令ifconfig，地址位于10.8.0.0/16网段）。然后设置环境变量，示意图如下：保存并启动，通过4.3.2的方式检查VPN地址是否已注册成功，通过4.4的方式确定是否可以从容器控制台连通此VPN地址。如果一切正常，就可以正常使用云机一体本地调试了。注意：⚫公司现在有2种VPN接入方式。集团网络安全部门只开放了对iNodeSSLVPN客户端的62871端口访问方式，所以必须使用iNode的VPN接入方式。⚫VPN连接公司网络时，本地天擎等安全引擎确保开启并升级到最新。⚫使用网页版VPN（https://vpn.yonyou.com/）无法使用云机一体。4.6确定cookie已植入通过F12查看发送的请求是否已经携带正确的cookie值,cookie的键值为zone，value值为3.1.1或3.2.3设置的标识符。用户手册33/190设置的cookie的默认有效时长为4个小时，如果cookie已过期，而需要继续使用，则可以使用3.1.3的方法重新植入cookie。本地服务启动后，如果想将请求不转发到本地，而想仍然转发到云端（比如想对比云端服务的返回页面），则删除此cookie即可。对比测试之后，可以按3.1.3的方法加上cookie继续调试。4.7域名与应用编码匹配对于REST服务，一般情况下，流水线的应用编码与域名的第一个字段是一致的，如下图，查看域名的截图如下：用户手册34/190如果这两个地方不一致，则ingresscontroller无法将调试流量导流到本地。此时只需要通过部署管理的“自定义域名”功能创建与应用管理一致的域名，或者重新创建流水线。4.8启动前关闭所有断点在本地如果以调试模式启动，先关闭所有断点，以避免启动变得非常慢，而且有可能导致连接云上其他服务超时。如下图所示：4.9本地context-path的设置如果云机一体配置成功后，调试请求可以正确的到达本地，但是返回404错误，例如如下的错误截图：这种情况有两种方法解决：方法1:开启MDF配置的needContextPath参数对于多版本部署和云机一体实例,通过MDF转发的接口,默认的context-path统一为"/"。如果需要转发的时候携带context-path，需要在MDF的配置中开启参数“needContextPath”。具体可以参考文档https://gfwiki.yyrd.com/pages/viewpage.action?pageId=22512589或咨询前端框架开发部。方法2:修改本地的context-path用户手册35/190如果本地服务是通过YMS启动的，则修改方式可以参考3.2.1中截图所示的配置。如果是类直接启动的，则修改方式如下：注意：如果同时使用云机一体和多版本部署，请确保这两者的context-path保持一致！4.10日常多数据库环境和平台开发环境日常多数据库环境和平台开发环境的envcode分别如下：环境日常多数据环境平台开发环境环境编码daily-dedicatediuap-dev配置Host172.20.34.122registry-dedicated.ywb-k8s-yonbip.com172.20.34.35registry-iuap-dev.ywb-k8s-yonbip.com注册中心-Diris.serviceUrl.defaultZone=http://registry-dedicated.ywb-k8s-yonbip.com/registry-0/eureka/-Diris.serviceUrl.defaultZone=http://registry-iuap-dev.ywb-k8s-yonbip.com/registry-0/eureka/配置中心--用户手册36/190Ddisconf.conf_server_host=http://registry-dedicated.ywb-k8s-yonbip.com/confcenterDdisconf.conf_server_host=http://registry-iuap-dev.ywb-k8s-yonbip.com/confcenterYMS配置Profile-Dmw.profiles.active=daily-dedicated-Dmw.profiles.active=iuap-devAKSK-Daccess.key=fuaJUwsE69mccrCl-Daccess.secret=evQeAcSH8jm2UysqVNbsNvDEG4a0C8-Daccess.key=fuaJUwsE69mccrCl-Daccess.secret=evQeAcSH8jm2UysqVNbsNvDEG4a0C84.11专属化使用场景从YonBIPv3_R1_2208版本开始，支持在专属化环境中使用云机一体。在专属化中使用云机一体的注意事项如下，4.11.1网络环境专属化不一定必需设置62871端口，根据专属化的实际网络情况进行设置。保证容器云的Pod网络与本地网络的端口相通即可。（对于用友集团的网络，只有172.20.30.0-172.20.32.0/24到本地的62871端口是相通的，如果是其他网段的专属化环境，需要自行找安全部门提申请开放端口。）（网络策略申请文档：https://wiki.yyrd.com/pages/viewpage.action?pageId=181708154）为了本地能够访问容器云的Pod网络，需要将本地电脑的DNS设置为专属化环境的DNS。4.11.2MDF设置MDF相关配置请参考：https://gfwiki.yyrd.com/pages/viewpage.action?pageId=22512589项目级配置文件https://gfwiki.yyrd.com/pages/viewpage.action?pageId=22512586MDF服务配置用户手册37/190项说明MDF的如下两个配置与云机一体相关，第一个配置是设置domainKey与微服务的映射关系，当两者不一致时需要加此配置，否则不用加；第二个配置为开启云机一体的开关。如果开启云机一体，需要将openCanaryDebug设置为true2.1.2.3.3流量管理流量管理中可以查看服务端口和分流组信息用户手册38/1902.1.2.3.4弹性管理扩缩管理：依据实际业务需求量情况，可以自行设置自动扩缩功能来实现应用的自动扩缩，具体操作：根据业务应用的实际运行情况，调整CPU百分比和内存百分比，并以此为条件，同时需要调整最大实例数与最小实例数，以此为接口，例如：调整CPU/内存百分比为80%，最大实例数为2，最小实例数为1，那么当CPU/内存百分比不足80%时，实例数为1，当CPU/内存百分比超过80%时，实例数自动变化为2，CPU百分比与内存百分比可同时设置，优先满足触发了条件的那一个。定时扩缩：同样是扩缩容的一种，可以在固定的时间触发扩缩容，其中目标副本数是指扩缩的实例数，重复是指扩缩执行的具体日期是否轮询执行，时间是指扩缩的具体执行时间。如：任务名称：A，目标副本数：2，重复：周一，时间：07：00：...
