Devtron 安装入门指南：前置条件、安装模式选择与快速上手指南

云原生DevOps运维【免费下载链接】devtronThe only Kubernetes dashboard you need项目地址https://gitcode.com/gh_mirrors/dev/devtron点击查看免费下载Devtron 是一个构建在 Kubernetes 之上的开源应用交付与可观测性平台官方定位为 The only Kubernetes dashboard you need。本文依据仓库内 getting-started.md 官方入门文档整理系统讲解在安装 Devtron 之前需要满足的前置条件Kubernetes 集群、Helm、资源配额并逐一对比三种主流安装形态独立 Helm Dashboard、附带 CI/CD、附带 CI/CD GitOps覆盖安装命令、Blob Storage 配置、安装状态验证、管理员凭据获取以及通过 ConfigMap Override 定制安装等完整流程。读完本文你将能够根据自身业务规模正确评估资源需求并独立完成 Devtron 的安装、验证与基础定制。Devtron 的安装形态先想清楚你要什么Devtron 始终运行在 Kubernetes 集群之上官方提供三种安装入口核心差异在于是否内置 CI/CD 与 GitOps 能力安装选项说明适用场景Devtron with CI/CD内置 CI/CD 集成支持持续构建、安全扫描、GitOps、调试与可观测性需要完整的构建 部署流水线能力Helm Dashboard by Devtron独立安装聚焦于在多个集群中部署、观察、管理与调试已有的 Helm 应用应用已通过 Helm 管理仅需统一的部署与运维视图后续可通过 Devtron Stack Manager 按需安装集成Devtron with CI/CD GitOpsArgo CD安装 CI/CD 的同时启用 GitOps安装时直接带上 Argo CD期望以 Git 作为唯一事实来源追求版本控制、协作、合规与基础设施自动化的可扩展方案无论选择哪种形态安装完成后都可以通过 Devtron Stack Manager 随时发现并安装更多集成集成安装与 Devtron 更新同步详见 Stack Manager 文档。安装前置条件官方明确要求先创建一个 Kubernetes 集群再在其上安装 Devtron。除此之外还需准备 Helm并确保集群资源配额满足推荐值。第一步创建 Kubernetes 集群官方建议使用Kubernetes 1.16 及以上版本的集群主流云厂商与轻量级发行版均可可按需选择云平台/发行版说明AWS EKS使用 AWS EKS 官方控制台或 CLI 创建集群官方另有针对 AWS EKS 的 CI/CD 安装专项文档Google Kubernetes Engine (GKE)使用 GKE 创建托管集群Azure Kubernetes Service (AKS)使用 AKS 创建托管集群k3s轻量级 Kubernetes适合本地与边缘环境官方提供在 Minikube、Microk8s、K3s、Kind 上安装 Helm Dashboard 的专项指南见 Install-devtron-on-Minikube-Microk8s-K3s-Kind.md第二步安装 HelmDevtron 全部通过 Helm Chartdevtron/devtron-operator交付因此必须先在本机安装 Helm 3。安装完成后建议确认helm version可正常执行。第三步确认资源配额官方按照管理的应用数量给出两档最低资源要求安装前请务必确认集群可用资源小规模配置管理不超过 5 个应用集成CPU内存Devtron with CI/CD26 GBHelm Dashboard by Devtron11 GB中/大规模配置管理超过 5 个应用集成CPU内存Devtron with CI/CD613 GBHelm Dashboard by Devtron23 GB资源细节可参考 Override 默认安装配置 进一步调整。注意事项推荐的资源配额必须在安装前就已就绪否则安装过程可能失败或异常官方明确不推荐使用可突发型burstableCPU 虚拟机AWS 的 T 系列、Azure 的 B 系列、GCP 的 E2/N1来运行 Devtron这类实例的 CPU 配额不稳定会影响性能一致性。安装 Devtron以下按三种形态给出完整命令。所有命令都以devtroncd命名空间安装请确保本机已配置好 kubectl 且能访问目标集群。方式一安装 Helm Dashboard by Devtron独立安装该命令不会安装 CI/CD 集成需要 CI/CD 时请改用方式二。helm repo add devtron https://helm.devtron.ai helm repo update devtron helm install devtron devtron/devtron-operator \ --create-namespace --namespace devtroncd方式二安装 Devtron with CI/CD在安装命令中追加--set installer.modules{cicd}即可启用 CI/CD 模块helm repo add devtron https://helm.devtron.ai helm repo update devtron helm install devtron devtron/devtron-operator \ --create-namespace --namespace devtroncd \ --set installer.modules{cicd}方式三安装 Devtron with CI/CD GitOpsArgo CD在方式二基础上追加--set argo-cd.enabledtruehelm repo add devtron https://helm.devtron.ai helm repo update devtron helm install devtron devtron/devtron-operator \ --create-namespace --namespace devtroncd \ --set installer.modules{cicd} \ --set argo-cd.enabledtrue多架构节点ARM 与 AMD 混合集群若集群节点为 ARM/AMD 多架构混合需在安装命令后追加--set installer.archmulti-arch该参数在方式一、二、三中均可使用。在 Minikube/Kind/k3s 等本地集群安装时还会结合--set components.devtron.service.typeNodePort以便通过 NodePort 访问详见 本地集群安装指南。EKS 1.23 的额外前置aws-ebs-csi-driver官方特别提示若使用 EKS 1.23 及以上版本必须先安装 aws-ebs-csi-driver否则存储卷无法正常挂载。可通过 Helm 安装helm repo add aws-ebs-csi-driver \ https://kubernetes-sigs.github.io/aws-ebs-csi-driver helm repo update helm upgrade --install aws-ebs-csi-driver \ --namespace kube-system aws-ebs-csi-driver/aws-ebs-csi-driver安装过程中配置 Blob StorageBlob Storage 用于存放构建日志与构建缓存。官方明确警告如果不配置 Blob Storage将出现以下问题超过 1 小时后无法访问构建与部署日志由于没有缓存按 commit hash 构建的时间显著变长pre/post 构建与部署阶段无法生成制品artifact报告。因此生产环境务必在安装时同步配置。官方支持四种存储后端安装时通过--set注入configs.*ConfigMap与secrets.*Secret参数。MinIO StorageMinIO 可本地部署适合自建环境helm install devtron devtron/devtron-operator \ --create-namespace --namespace devtroncd \ --set installer.modules{cicd} \ --set minio.enabledtrueAWS S3 BucketS3 支持三种认证方式安装时选择其一使用 S3 IAM 策略需提前为节点所挂 IAM 角色配置 S3 权限策略helm install devtron devtron/devtron-operator \ --create-namespace --namespace devtroncd \ --set installer.modules{cicd} \ --set configs.BLOB_STORAGE_PROVIDERS3 \ --set configs.DEFAULT_CACHE_BUCKETdemo-s3-bucket \ --set configs.DEFAULT_CACHE_BUCKET_REGIONus-east-1 \ --set configs.DEFAULT_BUILD_LOGS_BUCKETdemo-s3-bucket \ --set configs.DEFAULT_CD_LOGS_BUCKET_REGIONus-east-1使用 access-key / secret-key 认证helm install devtron devtron/devtron-operator \ --create-namespace --namespace devtroncd \ --set installer.modules{cicd} \ --set configs.BLOB_STORAGE_PROVIDERS3 \ --set configs.DEFAULT_CACHE_BUCKETdemo-s3-bucket \ --set configs.DEFAULT_CACHE_BUCKET_REGIONus-east-1 \ --set configs.DEFAULT_BUILD_LOGS_BUCKETdemo-s3-bucket \ --set configs.DEFAULT_CD_LOGS_BUCKET_REGIONus-east-1 \ --set secrets.BLOB_STORAGE_S3_ACCESS_KEYaccess-key \ --set secrets.BLOB_STORAGE_S3_SECRET_KEYsecret-key使用 S3 兼容存储在上一命令基础上追加 endpoint--set configs.BLOB_STORAGE_S3_ENDPOINTendpointAWS 相关参数的完整说明见 installation-configuration.md 的 AWS 小节。Azure Blob Storagehelm install devtron devtron/devtron-operator \ --create-namespace --namespace devtroncd \ --set installer.modules{cicd} \ --set secrets.AZURE_ACCOUNT_KEYxxxxxxxxxx \ --set configs.BLOB_STORAGE_PROVIDERAZURE \ --set configs.AZURE_ACCOUNT_NAMEtest-account \ --set configs.AZURE_BLOB_CONTAINER_CI_LOGci-log-container \ --set configs.AZURE_BLOB_CONTAINER_CI_CACHEci-cache-containerGoogle Cloud StorageGCP 的凭证以 Base64 编码后的 JSON 注入可用echo -n string | base64生成helm install devtron devtron/devtron-operator \ --create-namespace --namespace devtroncd \ --set installer.modules{cicd} \ --set configs.BLOB_STORAGE_PROVIDERGCP \ --set secrets.BLOB_STORAGE_GCP_CREDENTIALS_JSONbase64-encoded-json \ --set configs.DEFAULT_CACHE_BUCKETcache-bucket \ --set configs.DEFAULT_BUILD_LOGS_BUCKETlog-bucket通用注意确保集群对上述桶/容器具备读写权限使用 AWS 时还需保证集群能读取 SSM 与 Secrets Manager。若安装完成后想切换存储后端可在 installation-configuration.md 找到对应helm upgrade --reuse-values命令。验证安装状态、日志与 Dashboard完整安装约需15~20 分钟所有 Devtron 微服务会逐个拉起。官方通过自定义资源Installers来驱动安装该 CRD 定义在仓库 manifests/crds/crd-devtron.yaml 中group 为installer.devtron.aikind 为Installer因此可用 kubectl 直接查询其同步状态。检查安装状态kubectl -n devtroncd get installers installer-devtron \ -o jsonpath{.status.sync.status}状态含义Downloadedinstaller 已下载全部清单安装进行中Appliedinstaller 已成功应用全部清单安装完成查看 installer 日志kubectl logs -f -l appinception -n devtroncd获取 Dashboard 地址kubectl get svc -n devtroncd devtron-service \ -o jsonpath{.status.loadBalancer.ingress}输出示例[map[hostname:aaff16e9760594a92afa0140dbfd99f7-305259315.us-east-1.elb.amazonaws.com]]返回的 hostname 即为 LoadBalancer URL可直接在浏览器打开 Devtron Dashboard。若未返回 hostname 或提示 service doesnt exist说明 Devtron 仍在安装中请耐心等待安装完成。如需使用自定义域名可配置一条 CNAME 指向上述负载均衡地址HostTypePoints todevtron.yourdomain.comCNAMEaaff16e9760594a92afa0140dbfd99f7-305259315.us-east-1.elb.amazonaws.com本地集群Minikube/Kind/k3s则使用minikube service devtron-service --namespace devtroncd或kubectl -n devtroncd port-forward service/devtron-service 8000:80访问详见 本地集群安装指南。获取管理员凭据首次安装时 Devtron 会创建默认管理员账号拥有全部权限。Devtron v0.6.0 及以上版本用户名admin密码从devtron-secret中解密ADMIN_PASSWORDkubectl -n devtroncd get secret devtron-secret \ -o jsonpath{.data.ADMIN_PASSWORD} | base64 -d若使用 v0.6.0 之前的旧版本密钥字段名为ACD_PASSWORD。官方强烈建议首次登录后立即配置 SSO如 Google、GitHub并将自己与其他用户纳入 SSO 登录体系之后所有用户统一通过 SSO 访问 Dashboard。通过 Override 定制安装某些场景下需要调整默认配置例如修改 Deployment/StatefulSet 的 CPU/内存请求与限制、为 Pod 增加 node affinity 或 taint 容忍或者为 Ingress 增加注解与 host。仓库在 manifests/updates 目录中提供了各组件对应的 override 模板如devtron-ingress-override.yaml、devtron-argocd-override.yaml、devtron-workflow-override.yaml等。其机制是Devtron 会在devtroncd命名空间查找与组件对应的 ConfigMap例如 dashboard 对应dashboard-override-cm、argocd 对应argocd-override-cm、ingress 对应devtron-ingress-override-cmConfigMap 的data.override字段承载多行 YAML 来匹配并修改目标对象。以修改 Ingress 为例devtron-ingress-override.yaml 的结构如下apiVersion: v1 kind: ConfigMap metadata: name: devtron-ingress-override-cm namespace: devtroncd data: override: | apiVersion: networking.k8s.io/v1 # k8s 1.19 使用 extensions/v1beta1 kind: Ingress metadata: name: devtron-ingress # update: # metadata: # annotations: # owner: app1 # spec: # rules: # - http: # host: http://change-me其中apiVersion、kind、metadata.name用于匹配需要修改的对象update段中的内容会被合并应用到目标对象。修改多个对象时可在同一个override中用---分隔多段清单例如同时改 Argo CD 的 dex-server 与 redis参见 devtron-argocd-override.yaml 与 devtron-override-cm.yaml。应用与生效命令kubectl apply -f file-name -n devtroncd kubectl patch -n devtroncd installer installer-devtron --typejson \ -p[{op: add, path: /spec/reSync, value: true }]变更将在约 20~30 分钟内逐步生效。更多 Secrets / ConfigMaps 参数如BASE_URL_SCHEME、BASE_URL、PROMETHEUS_URL、CI_NODE_LABEL_SELECTOR等可查阅 installation-configuration.md。生产环境推荐配置官方在 manifests/updates/production 目录维护了一套面向生产环境的推荐 overrides官方声明其规模足够支撑约 200 个微服务整体资源需求为CPU 6 核、内存 13 GB与上文中/大规模配置一致。这套配置既可在安装前kubectl create ns devtroncd后预先 apply也可在安装后应用到现有devtroncd命名空间kubectl apply -f prod-configs -n devtroncd升级与卸载升级Devtron 支持两种升级路径——通过 Helm 升级各历史版本升级路线见 upgrade 目录以及从 Devtron UI 直接升级见 upgrade-devtron-ui.md。卸载卸载命令会删除所有与 Devtron 相关的命名空间devtroncd、devtron-cd、devtron-ci等完整流程见 uninstall-devtron.mdhelm uninstall devtron --namespace devtroncd kubectl delete -n devtroncd -f crd-devtron.yaml # 仓库内对应 manifests/crds/crd-devtron.yaml kubectl delete -n argo -f workflow.yaml # 仓库内对应 manifests/yamls/workflow.yaml kubectl delete ns devtroncd devtron-cd devtron-ci devtron-demo argo小结安装 Devtron 的关键决策链可归纳为四步选集群 → 配资源 → 选形态 → 配存储。先按管理应用数量确认 CPU/内存配额1~6 核 / 1~13 GB再按是否使用 CI/CD、GitOps 选择三种安装命令之一生产环境务必同步配置 Blob Storage最后用kubectl get installers验证Applied状态、获取 Dashboard 地址与管理员凭据。后续如需扩展能力可随时通过 Devtron Stack Manager 安装更多集成并通过 Override 机制 与 安装配置参数 对安装进行细粒度定制。赞分享云原生DevOps运维【免费下载链接】devtronThe only Kubernetes dashboard you need项目地址https://gitcode.com/gh_mirrors/dev/devtron点击查看免费下载相关推荐Fuse.js 入门指南安装方式、快速上手与构建产物选择Fuse.js 入门指南安装方式、快速上手与构建产物选择 本文是 Fuse.js 的官方入门指南对应仓库中的 docs/getting started.md前端搜索引擎如何在10分钟内部署iTopWeb化ITSM工具快速上手指南如何在10分钟内部署iTopWeb化ITSM工具快速上手指南 iTop是一款简单易用的Web化IT服务管理ITSM工具集成了CMDB配置管理数据库功后端企业应用Apache MXNet 纯 CPU 版 PyPI 安装指南mxnet 包的前置条件、安装与变体选择Apache MXNet 纯 CPU 版 PyPI 安装指南mxnet 包的前置条件、安装与变体选择 output Apache MXNet 纯 CPU 版深度学习机器学习人工智能上一篇OpenAvatarChat 数字人对话系统详解模块化架构、系统需求与组件依赖下一篇ng-zorro-antd Alert 自定义关闭用 nzCloseText 替换默认关闭按钮的完整指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考