升级注意事项¶
本页介绍一些升级 Insight Server 和 Agent 的注意事项。
insight-agent¶
从 0.28.x（或更低版本）升级到 v0.29.x¶
由于 0.29.0 升级了 Opentelemetry 社区的 operator chart 版本，values 中的 featureGates 的支持的值有所变化，因此，在 upgrade 之前，需要将 featureGates 的值设置为空, 即：
- --set opentelemetry-operator.manager.featureGates="+operator.autoinstrumentation.go,+operator.autoinstrumentation.multi-instrumentation,+operator.autoinstrumentation.nginx" \
+ --set opentelemetry-operator.manager.featureGates=""
Insight server¶
从 v0.26.x（或更低版本）升级到 v0.27.x 或更高版本¶
在 v0.27.x 版本中将 vector 组件的开关单独抽出。故原有环境开启了 vector，那在升级 Insight Server 时，需要指定 --set vector.enabled=true 。
从 v0.19.x（或更低版本）升级到 0.20.x¶
在升级 Insight 之前，您需要执行以下命令手动删除 jaeger-collector 和 jaeger-query 部署：
kubectl -n insight-system delete deployment insight-jaeger-collector
kubectl -n insight-system delete deployment insight-jaeger-query
从 v0.17.x（或更低版本）升级到 v0.18.x¶
由于 0.18.x 中更新了 Jaeger 相关部署文件，因此需要在升级 Insight Server 前手动执行如下命令：
kubectl -n insight-system delete deployment insight-jaeger-collector
kubectl -n insight-system delete deployment insight-jaeger-query
由于 0.18.x 中指标名产生了变动，因此，需要在升级 Insight Server 之后，Insight Agent 也应该做升级。
此外，调整了开启链路模块的参数，以及 ElasticSearch 连接调整。具体参考以下参数：
+ --set global.tracing.enable=true \
- --set jaeger.collector.enabled=true \
- --set jaeger.query.enabled=true \
+ --set global.elasticsearch.scheme=${your-external-elasticsearch-scheme} \
+ --set global.elasticsearch.host=${your-external-elasticsearch-host} \
+ --set global.elasticsearch.port=${your-external-elasticsearch-port} \
+ --set global.elasticsearch.user=${your-external-elasticsearch-username} \
+ --set global.elasticsearch.password=${your-external-elasticsearch-password} \
- --set jaeger.storage.elasticsearch.scheme=${your-external-elasticsearch-scheme} \
- --set jaeger.storage.elasticsearch.host=${your-external-elasticsearch-host} \
- --set jaeger.storage.elasticsearch.port=${your-external-elasticsearch-port} \
- --set jaeger.storage.elasticsearch.user=${your-external-elasticsearch-username} \
- --set jaeger.storage.elasticsearch.password=${your-external-elasticsearch-password} \
从 v0.15.x（或更低版本）升级到 v0.16.x¶
由于 0.16.x 中使用了 vmalertmanagers CRD 的新特性参数 disableRouteContinueEnforce， 因此需要在升级 Insight Server 前手动执行如下命令。
kubectl apply --server-side -f https://raw.githubusercontent.com/VictoriaMetrics/operator/v0.33.0/config/crd/bases/operator.victoriametrics.com_vmalertmanagers.yaml --force-conflicts
Note
如您是离线安装，可以在解压 Insight 离线包后，请执行以下命令更新 CRD。
insight-agent¶
从 0.23.x（或更低版本）升级到 v0.24.x¶
由于 0.24.x 版本中 OTEL operator chart 中新增了 CRD，但由于 Helm Upgrade 时并不会更新 CRD，因此，需要手动执行以下命令：
kubectl apply -f https://raw.githubusercontent.com/open-telemetry/opentelemetry-helm-charts/main/charts/opentelemetry-operator/crds/crd-opentelemetry.io_opampbridges.yaml
如您是离线安装，可以在解压 insight-agent 离线包后可找到上述 CRD 的 yaml，解压 Insight-Agent Chart 之后手动执行以下命令：
从 0.19.x（或更低版本）升级到 v0.20.x¶
由于 0.20.x 中增加了 Kafka 日志导出配置，日志导出配置做了一些调整。升级 insight-agent 之前需要注意参数变化， 即原来 logging 的配置已经移到了配置中 logging.elasticsearch：
- --set global.exporters.logging.host \
- --set global.exporters.logging.port \
+ --set global.exporters.logging.elasticsearch.host \
+ --set global.exporters.logging.elasticsearch.port \
从 v0.17.x（或更低版本）升级到 v0.18.x¶
由于 0.18.x 中更新了 Jaeger 相关部署文件，因此需要在升级 insight-agent 前需要注意参数的改动。
+ --set global.exporters.trace.enable=true \
- --set opentelemetry-collector.enabled=true \
- --set opentelemetry-operator.enabled=true \
从 v0.16.x（或更低版本）升级到 v0.17.x¶
在 v0.17.x 版本中将 kube-prometheus-stack chart 版本从 41.9.1 升级至 45.28.1, 其中使用的 CRD 也存在一些字段的升级，如 servicemonitor 的 attachMetadata 字段，因此需要在升级 insight-agent 前执行如下命令：
kubectl apply --server-side -f https://raw.githubusercontent.com/prometheus-operator/prometheus-operator/v0.65.1/example/prometheus-operator-crd/monitoring.coreos.com_servicemonitors.yaml --force-conflicts
如您是离线安装，可以在解压 insight-agent 离线包后，在 insight-agent/dependency-crds 中找到上述 CRD 的 yaml。
从 v0.11.x（或更低版本）升级到 v0.12.x¶
在 v0.12.x 将 kube-prometheus-stack chart 从 39.6.0 升级到 41.9.1，其中包括 prometheus-operator 升级到 v0.60.1, prometheus-node-exporter chart 升级到 4.3.0 等。 prometheus-node-exporter 升级后使用了 Kubernetes 推荐 label，因此需要在升级前删除 node-exporter 的 DaemonSet。 prometheus-operator 更新了 CRD，因此需要在升级 insight-agent 前执行如下命令：
Note
如您是离线安装，可以在解压 insight-agent 离线包后，执行以下命令更新 CRD。