升级 Gateway 至 v1.0.4

从 Gateway 升级至 v1.0.4(开源版本)

操作指南

注意事项

如果安装时设定了自定义参数,请先备份,并在升级时重新设置:

helm get values -n kubesphere-system ks-core | grep -v 'USER-SUPPLIED VALUES' > bak-values.yaml

步骤 1:更新扩展组件仓库

# 不带自定义参数
helm upgrade --install -n kubesphere-system --create-namespace ks-core https://charts.kubesphere.io/main/ks-core-1.1.4.tgz --debug --wait --set ksExtensionRepository.image.tag=v1.1.4

# 带自定义参数
helm upgrade --install -n kubesphere-system --create-namespace ks-core https://charts.kubesphere.io/main/ks-core-1.1.4.tgz --debug --wait -f bak-values.yaml --set ksExtensionRepository.image.tag=v1.1.4

步骤 2:触发扩展组件仓库更新

kubectl patch repository extensions-museum --type=json -p='[{"op": "replace", "path": "/status", "value": {}}]'

更新网关版本到 v1.0.4

更新扩展组件配置

将概览-》升级 中的配置粘贴到扩展组件配置更新框中

步骤 3:升级网关版本至 v1.0.4

升级完成后,请根据扩展组件页面的“升级”部分,更新 Gateway 扩展组件配置。

重启 Gateway apiserver

kubectl rollout restart deploy -n extension-gateway gateway-agent-backend-apiserver

更新已存在网关

如果集群中已经开启了网关,更新操作会导致业务中断,请提前预留更新窗口。

1. 备份网关配置

进入网关详情页,点击 编辑,记录当前的自定义配置。

2. 记录 nodePort(若需保持端口一致)

应用负载 > 服务 中,查找 kubesphere-controls-system 下网关服务,记录 nodePort 端口。

3. 禁用网关

在网关详情页点击 禁用

注意:该步骤会导致业务中断。

4. 重新启用网关

若存在自定义配置,请重新设置,确保 nodePort 保持一致(如有需要请点击“编辑 YAML”进行设置)。

检查 Nginx Ingress 版本

确保使用的版本为:

kubesphere-nginx-ingress-4.12.1

商业产品与合作咨询