环境配置

点击【Kubernetes-环境配置】进入环境配置菜单，环境配置菜单下展示“当前Kubernetes环境”栏和所有Kubernetes环境列表。

接入前准备

1. 确认许可证已包含“云原生流量引擎”功能。许可证申请和激活方法参见许可证授权与激活说明；
2. 确认管理节点能够访问Kubernetes API Server的IP地址和端口，默认端口通常为6443；
3. 从集群获取kubeconfig，并确认其中包含client-certificate-data和client-key-data。

API Server地址必须可达

部分K3s生成的kubeconfig中，server为https://127.0.0.1:6443。该地址只适用于K3s节点本机，不能直接作为矩尺平台的Master IP。请在环境配置中填写矩尺管理节点能够访问到的Kubernetes API Server地址。

当前Kubernetes环境

每一个Kubernetes菜单中，在头部都会有一个当前Kubernetes环境栏，展示当前Kubernetes环境名称以及状态。当环境验证成功时显示为绿色，当环境验证失败时显示为红色。

新增Kubernetes环境

1. 创建Kubernetes用户凭证

进入【平台系统-用户凭证】，新增“Kubernetes 证书认证”凭证。字段必须按以下方式填写：

用户凭证字段	kubeconfig字段
Kubernetes证书	users[].user.client-certificate-data的Base64原文
Kubernetes私钥	users[].user.client-key-data的Base64原文

不要对这两个字段进行Base64解码，也不要填入PEM的BEGIN、END包装行。详细操作参见用户凭证。

2. 新增环境

在Kubernetes环境配置列表的左上方点击“新增”，填写以下信息：

配置项	说明
名称	用于在矩尺平台中识别该集群的名称
Master IP	矩尺管理节点能够访问到的Kubernetes API Server地址
Master端口	Kubernetes API Server端口，K3s默认通常为6443
用户凭证	选择上一步创建的Kubernetes证书凭证或Token凭证

3. 设为当前环境并验证

创建完成后，在环境项右侧点击“设为当前环境”。当顶部状态显示为绿色，并且环境列表能够显示Kubernetes版本时，表示认证和连接验证成功。此时可进入Gateway虚拟服务、Route分发规则、Service服务器池、Pod节点、Node节点、ConfigMaps、Secrets和Event事件等页面查看集群数据。

修改Kubernetes环境

在Kubernetes环境配置列表中，在需要修改的环境项右侧点击“修改”按钮，可打开修改对话框，如下图：

删除Kubernetes环境

在Kubernetes环境配置列表中，在需要删除的环境项右侧点击“删除”按钮，可对这条配置进行删除操作，如下图：

切换Kubernetes环境

在Kubernetes环境配置列表中，在需要切换的环境项右侧点击“设为当前环境”按钮，即可切换到该环境，如下图：

常见问题

现象	检查方法
提示“用户凭证错误”	检查是否直接填写了client-certificate-data和client-key-data的Base64原文；不要填写解码后的PEM内容或BEGIN、END包装行
环境连接失败	检查Master IP和端口是否可从矩尺管理节点访问，并确认Kubernetes API Server正在监听该地址
凭证无法修改	凭证正在被环境引用时不能直接修改；请新建正确凭证，再修改环境所引用的凭证
页面无资源数据	确认目标环境已设为当前环境且状态为绿色，再检查当前租户权限和集群内是否存在对应资源