编辑YAML

云容器引擎为适配多种复杂场景下的项目间访问需求，提供了多样化的Service访问方式配置途径。本文档将详细介绍通过YAML格式编辑Service访问方式的完整操作流程，帮助用户精准调整Service配置，满足定制化访问需求。

一、操作概述

YAML格式编辑是一种灵活高效的Service配置方式，适用于需要精细化调整Service参数（如访问类型、端口映射、选择器规则等）的场景。通过直接编辑YAML配置文件，可快速完成Service访问方式的修改与更新，操作完成后配置即时生效。

二、操作步骤

步骤1：打开YAML编辑页面

按照以下路径导航至目标Service的YAML编辑入口：
「容器云服务」>「网络服务」>「服务」，在服务列表中找到需要编辑访问方式的Service记录，点击该记录操作栏中的「编辑YAML」按钮，进入YAML编辑页面。

YAML编辑入口示意图：

步骤2：编辑YAML配置内容

进入YAML编辑页面后，可在编辑区域直接修改Service的配置参数。核心编辑要点包括：

• 访问方式调整：修改type字段值，可切换Service访问类型（如ClusterIP、NodePort、LoadBalancer等）；
• 端口映射配置：在ports节点下调整port（访问端口）、targetPort（容器端口）、nodePort（节点端口，仅NodePort类型生效）等参数；
• 选择器配置：确认selector字段参数正确，确保Service能精准关联目标工作负载；
• 其他参数：根据业务需求调整sessionAffinity（会话亲和性）、externalIPs（外部IP）等可选参数。

注意：编辑过程中需严格遵循YAML语法规范，避免出现缩进错误、字段缺失等问题，否则会导致配置提交失败。

YAML编辑页面示意图：

步骤3：查看编辑后内容

YAML配置修改完成后，仔细核对编辑后的完整内容，重点检查以下核心配置项：

• 访问类型（type）是否符合预期；
• 端口映射关系是否准确，无端口冲突；
• 选择器、标签等关联信息是否正确；
• YAML语法无错误，无红色语法提示标识。

编辑后YAML内容示意图：

步骤4：完成配置提交

确认编辑后的YAML配置无误后，点击编辑页面底部的「确认」或「提交」按钮，完成配置更新。系统将自动校验配置的合法性，若校验通过，配置即时生效；若校验失败，会提示具体错误信息，需根据提示修正后重新提交。

配置提交完成示意图：

三、重要注意事项

• 语法规范：YAML对缩进敏感（推荐使用2个空格作为缩进），编辑时需严格遵循语法要求，避免因格式错误导致配置失效；
• 配置备份：编辑前建议先复制原有YAML内容进行备份，若修改后出现问题，可快速恢复至原始配置；
• 业务影响：Service配置修改可能会短暂影响服务可用性，建议在业务低峰期操作，并提前告知相关业务负责人；
• 参数校验：提交前务必核对关键参数（如端口、访问类型、选择器），尤其是NodePort类型的端口需确保未被其他服务占用（端口范围通常为30000-32767）；
• 权限要求：操作账号需具备「Service编辑权限」，无权限将无法看到「编辑YAML」按钮，需联系管理员申请对应权限。