资讯动态

Devtron 升级到 Beta 版本指南:基于 Helm 的完整操作流程与源码解析

发布时间:2026/10/23 23:52:30 来源:尧图企业网站定制
云原生DevOps运维【免费下载链接】devtronThe only Kubernetes dashboard you need项目地址https://gitcode.com/gh_mirrors/dev/devtron点击查看免费下载本指南面向已经通过 Helm 安装了 Devtron稳定版的用户讲解如何将现有安装无缝升级到 Beta 版本发布通道。文章以docs/setup/upgrade/devtron-upgrade-to-beta.md为主体结合仓库中 Helm Chart、Installer CRD 与 BOM 清单的源码实现完整覆盖版本查询、升级命令、参数含义与注意事项。读完本文你将掌握一套可直接复制执行的 Beta 升级方案并理解其底层工作机制。升级前确认当前 Devtron 版本在执行任何升级操作之前建议先确认集群中正在运行的 Devtron 版本。Devtron 通过一个名为installer-devtron的自定义资源Installer来记录自身的版本信息该资源由 Helm Chart 模板在安装时创建定义于 charts/devtron/templates/devtron-installer.yaml对应的 CRD 声明可见于 charts/devtron/crds/crd-devtron.yaml 与 manifests/crds/crd-devtron.yaml。运行以下命令即可读取当前版本kubectl -n devtroncd get installers installer-devtron -o jsonpath{.status.sync.data} | grep ^LTAG | cut -d -f2-这条命令的执行逻辑分为三层kubectl get installers installer-devtron获取名为installer-devtron的 Installer 资源API 组为installer.devtron.ai/v1alpha1参考 manifests/install/devtron-installer.yaml-o jsonpath{.status.sync.data}提取其状态字段中的同步数据grep ^LTAG | cut -d -f2-过滤出以LTAG开头的行并取出等号后面的值。LTAG即 Latest TAG是 Devtron 记录自身发布标签如v2.2.0的字段它在仓库的 manifests/installation-script 中可见LTAGv2.2.0;与当前 Chart 的appVersion: 2.2.0见 charts/devtron/Chart.yaml保持一致。该安装脚本会被 Installer 控制器拉取执行用于完成 Devtron 各组件镜像的部署与版本同步。Beta 版本通道与稳定版安装的本质差异Devtron 的稳定版本通过官方 Helm 仓库https://helm.devtron.ai分发可以直接使用helm repo add与helm install安装。而Beta 版本 Chart 不在官方 Helm 仓库中因此必须直接从 Devtron 的源码仓库获取 Chart 目录即本仓库的 charts/devtron再基于本地目录执行安装或升级。这一点在 charts/devtron/README.md 的 Install with Helm (Beta) 一节中有明确说明。Chart 的元信息可从 charts/devtron/Chart.yaml 确认Chart 名为devtron-operator版本0.23.3appVersion为2.2.0并声明了三个依赖依赖版本启用条件argo-cd7.7.15argo-cd.enabledsecurity0.x.xsecurity.enabledredis2.4.0devtronEnterprise.athenaApi.enabled这些依赖需要通过helm dependency up拉取这也是升级流程中必须执行该命令的原因。升级到 Beta完整操作步骤在原文档给出的升级流程基础上结合仓库实际内容完整的升级命令如下# 1. 克隆 Devtron 源码仓库获取 Beta Chart $ git clone https://gitcode.com/gh_mirrors/dev/devtron.git $ cd devtron/charts/devtron # 2. 拉取 Chart 依赖argo-cd、security、redis 等 $ helm dependency up # 3. 按需修改 values.yaml 中的配置 $ #modify values in values.yaml # 4. 使用 --reuse-values 保留既有配置并叠加 BOM 文件执行升级 $ helm upgrade devtron . --reuse-values --namespace devtroncd \ -f devtron-bom.yaml步骤一获取 Beta ChartBeta Chart 直接以源码形式存放在仓库的charts/devtron目录下因此需要先克隆仓库。进入目录后即可看到 Chart.yaml、values.yaml、devtron-bom.yaml 以及templates/与crds/等文件。步骤二同步 Helm 依赖helm dependency up会读取Chart.yaml中的dependencies声明从对应仓库拉取 argo-cdhttps://argoproj.github.io/argo-helm、securityhttps://helm.devtron.ai与 redis 子 Chart。由于 Beta Chart 通常以源码而非打包形式分发这一步是保证后续helm upgrade能正确渲染模板的前提。步骤三按需调整 values 配置values.yaml是 Chart 的默认配置入口升级前可按集群实际情况修改。仓库中的 charts/devtron/values.yaml 主要配置项包括global.containerRegistry全局镜像仓库地址默认quay.io/devtronglobal.dbConfigPostgreSQL 连接配置默认PG_ADDR: postgresql-postgresql.devtroncd、PG_PORT: 5432、PG_USER: postgres、PG_DATABASE: orchestratorglobal.externalPostgres若使用外部数据库设置enabled: true并填写PG_PASSWORD与PG_ADDRinstaller.releaseInstaller 对应的发布版本号当前为v2.2.0installer.source安装脚本拉取来源可选github或giteecomponents.*各微服务组件dashboard、devtron、kubelink、kubewatch、gitsensor、lens、nats、migrator 等的镜像与运行参数configs.BLOB_STORAGE_PROVIDER构建缓存与日志的存储提供商AZURE|S3|MINIO|GCPargo-cd.enabled、security.enabled、notifier.enabled、minio.enabled、monitoring.grafana.enabled等集成组件的开关。注意values.yaml中多个集成组件如security、minio、monitoring、notifier默认处于enabled: false状态升级时这些开关状态会被--reuse-values继承一般无需重复修改。步骤四执行 Helm 升级关键参数解读helm upgrade devtron . --reuse-values --namespace devtroncd -f devtron-bom.yaml各参数的作用如下参数含义devtronHelm Release 名称与初次安装时保持一致.Chart 路径指向当前目录charts/devtron--reuse-values复用上一次安装/升级时设定的 values避免覆盖用户已有的自定义配置--namespace devtroncd目标命名空间Devtron 组件默认部署在devtroncd-f devtron-bom.yaml叠加 BOMBill of Materials清单文件为本次升级指定各组件的镜像标签devtron-bom.yaml是 Beta 升级的关键文件。它相当于一张物料清单固定了本次 Beta 构建中所有组件的镜像版本。仓库内的 charts/devtron/devtron-bom.yaml 中可以看到installer: release: v2.2.0 image: inception tag: 473deaa4-185-21582 components: dashboard: image: dashboard:c7b89667-690-39290 devtron: image: hyperion:0874dcaf-280-39287 cicdImage: devtron:0874dcaf-434-39286 ciRunner: image: ci-runner:3b3d6d0e-138-39293 kubelink: image: kubelink:09867a9c-564-39289 gitsensor: image: git-sensor:3b3d6d0e-200-39291 nats: image: nats:2.9.3-alpine migrator: image: migrator:v4.16.2 argo-cd: global: image: tag: v2.13.3 workflowController: image: workflow-controller:v3.4.3该文件覆盖了从 dashboard、hyperionorchestrator、ci-runner、kubelink、kubewatch、git-sensor、lens、nats、migrator 到 Argo CD、Argo Workflow、security 扫描器、notifier、minio、grafana 等全部组件的镜像标签确保升级后整个平台处于同一套 Beta 构建版本避免组件间版本错配。升级后验证版本与状态升级完成后可以再次执行第一节中的版本查询命令确认LTAG已更新为 Beta 构建对应的标签kubectl -n devtroncd get installers installer-devtron -o jsonpath{.status.sync.data} | grep ^LTAG | cut -d -f2-从模板 charts/devtron/templates/devtron-installer.yaml 可以看到Installer 资源还带有reSync: true标记这表示 Installer 控制器会主动拉取安装脚本并同步组件状态模板中的url指向https://raw.githubusercontent.com/{{ $.Values.installer.repo }}/{{ $.Values.installer.release }}/manifests/installation-script即版本标签对应的安装脚本这解释了为何升级后各组件镜像会被统一更新到 BOM 指定的标签。另外charts/devtron/templates/install.yaml 中定义了installerServiceAccount 及其绑定到cluster-admin的 ClusterRoleBinding升级时 Helm 会以此权限在集群内创建或更新 Installer 资源整个同步过程由 Devtron 的 Installer 控制器完成。重要说明Beta 升级与 Stack Manager UI 的限制原文档明确指出以下限制升级前务必知悉目前 Stack Manager UI 中没有提供升级到 Beta 版本的入口。在 Stack Manager 界面中你始终可以看到升级到最新稳定版的可用提示使用该入口会将 Devtron 移动到最新的稳定版本。也就是说想要升级到 Beta只能通过本文的 Helm 方式执行Stack Manager UI对应路径为Stack Manager About Devtron详见 docs/setup/upgrade/upgrade-devtron-ui.md只支持升级到最新稳定版二者是互斥的两条升级路径如果后续希望回到稳定版同样需要借助 Helm 并指定稳定版对应的 Chart 与 BOM 重新执行升级。常见问题与补充建议helm dependency up拉取失败怎么办检查网络能否访问argoproj.github.io/argo-helm、helm.devtron.ai与groundhog2k.github.io/helm-charts见 charts/devtron/Chart.yaml 中声明的依赖仓库内网或离线环境可考虑预先将依赖打包后通过helm dependency build使用本地charts/目录。升级过程中如何保留自定义配置务必保留--reuse-values参数若需要修改配置应在升级命令中追加--set keyvalue或在-f后叠加自定义 values 文件而不是直接改掉values.yaml后不带--reuse-values执行否则可能丢失先前设定。升级后如何确认各组件镜像已更新可以通过kubectl -n devtroncd get pods检查各组件 Pod 的镜像标签并与 charts/devtron/devtron-bom.yaml 中声明的标签逐一比对。Beta 版本的含义Beta 版本是 Devtron 在正式稳定版发布前数日推出的预发布构建用于让用户提前体验与验证新功能。使用 Beta 通道意味着会接收到尚未完全稳定的特性生产环境请评估后再决定是否采用。赞分享云原生DevOps运维【免费下载链接】devtronThe only Kubernetes dashboard you need项目地址https://gitcode.com/gh_mirrors/dev/devtron点击查看免费下载相关推荐GPUStack 基于 Docker 的版本升级指南服务端与 Worker 的完整操作流程GPUStack 基于 Docker 的版本升级指南服务端与 Worker 的完整操作流程 本篇指南围绕 GPUStack 的 Docker 部署形态系统讲后端人工智能模型推理服务集群管理可观测性pytype Python 版本升级指南从字节码、操作码到发布的完整改造流程pytype Python 版本升级指南从字节码、操作码到发布的完整改造流程 本文是 pytype 开发者文档 docs/developers/python_静态分析开发工具代码质量引流宝版本升级指南平滑迁移到最新版本的完整操作流程引流宝版本升级指南平滑迁移到最新版本的完整操作流程 引流宝作为一款致力于为个人和团队提供基于微信私域流量的推广、引流效率工具完全开源免费可商用且支持任意二后端前端创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

读完文章,也想定制专属网站?

尧图设计师 24 小时内与您沟通定制方案

免费获取报价 →
↑