文档中心

升级 LogCollector（Kubernetes 集群）

最近更新时间：2023.11.09 13:55:59

首次发布时间：2022.11.22 14:42:34

LogCollector 新版本发布后，建议您及时升级以体验新的功能与更稳定的服务。本文档介绍如何在 Kubernetes 集群中升级 LogCollector 版本。

升级方式

您可以通过以下方式在 Kubernetes 集群中升级 LogCollector 版本。

版本	升级方式	说明
1.0.8 及之前版本	手动修改镜像版本	1.0.9 版本开始，LogCollector 使用固定的镜像地址，建议存量的历史版本用户尽快替换镜像地址，使用更为稳定的LogCollector服务。
1.0.9 及后续版本	（推荐）重启 LogCollector 服务	直接执行重启命令即可快速升级 LogCollector。
1.0.9 及后续版本	重新安装 LogCollector	该方法在升级过程中会中断采集，可能会丢失部分日志数据。

对于 1.0.8 及之前版本的 LogCollector，如果需要升级至最新版本，请参考以下步骤在配置文件中替换镜像地址，并增加 imagePullPolicy 配置。

说明

登录需要升级 LogCollector 的 Kubernetes 集群。
执行以下命令进入配置模式。
- DaemonSet 方式：
```
kubectl edit  daemonset -n ${namespace} logcollector
```
- Sidecar 方式：
```
kubectl edit ${workloadtype} -n ${namespace} logcollector
```
其中：
变量
示例
说明
${namespace}
test1
POD 所在的命名空间。
${workloadtype}
deployment
实际业务场景的负载类型。
修改 image 字段配置的 ${logcollector-image}，改为固定的镜像地址。
各地域的镜像地址列表请参考LogCollector 镜像地址。
增加 imagePullPolicy: Always 配置。

变量	示例	说明
${namespace}	test1	POD 所在的命名空间。
${workloadtype}	deployment	实际业务场景的负载类型。

对于 1.0.9 及后续版本的 LogCollector，如果需要升级至最新版本，请参考以下说明直接重启 LogCollector 服务即可。

DaemonSet 方式部署的 LogCollector，执行以下命令重启 LogCollector 服务：
```
kubectl rollout restart daemonset -n ${namespace} logcollector
```
Sidecar 方式重启 Pod 即可。
说明
Sidecar 方式重启 Pod 时，可能造成业务容器同时重启，请根据业务需求选择合适的时间段重启 Pod。重启后 LogCollector 服务升级完成。

执行以下命令，查看 Pod 状态。LogCollector 将在所有 Pod 中滚动升级，如果所有 Pod 状态均为 Running，表示升级成功。
```
kubectl get pod -n ${namespace}
```
在控制台中查看机器组中指定机器的 LogCollector 版本号。如果是最新版本号，表示升级成功。

升级方式

手动修改镜像版本

重启 LogCollector服务

验证升级结果