octopusdeploy/kubernetes-agent

Octopus Deploy Kubernetes Agent Helm Chart 技术文档

一、镜像概述和主要用途

概述

本Helm Chart是Octopus Deploy官方提供的部署工具，用于在Kubernetes集群中简化Octopus Kubernetes Agent的安装与管理流程。Octopus Kubernetes Agent作为Octopus Deploy平台与Kubernetes集群之间的通信桥梁，支持持续部署（CD）流程的自动化执行。

主要用途

• 作为Octopus Deploy与Kubernetes集群的中间件，实现部署任务的下发与执行结果的反馈
• 简化Kubernetes集群中应用的持续部署流程，降低手动配置复杂度
• 支持Kubernetes集群资源的管理与监控，确保部署任务的稳定运行

二、核心功能和特性

• 简化安装与管理：通过Helm Chart标准化部署流程，支持一键安装、升级与卸载，降低Kubernetes Agent的运维成本
• 与Octopus Deploy无缝集成：原生支持Octopus Deploy平台的部署任务调度，确保部署流程与平台功能深度联动
• 灵活配置：提供可定制的values.yaml配置文件，支持根据实际集群环境调整资源分配、网络策略等参数
• 集群兼容性：适配主流Kubernetes集群版本，兼容各类云厂商托管集群及自建集群

三、使用场景和适用范围

使用场景

• 采用Octopus Deploy进行应用持续部署的开发/运维团队
• 需要在Kubernetes集群中自动化部署、更新或回滚应用的场景
• 需对Kubernetes集群资源进行集中管理与监控的企业级部署流程

适用范围

• 已部署Octopus Deploy平台的组织或团队
• 各类规模的Kubernetes集群（开发、测试、生产环境）
• 需实现Kubernetes资源编排与应用生命周期管理的场景

四、使用方法和配置说明

4.1 仓库信息

Helm Chart的源代码及文档托管于GitHub仓库：
https://github.com/OctopusDeploy/helm-charts

4.2 安装步骤

4.2.1 添加Helm仓库

bash
helm repo add octopus https://octopusdeploy.github.io/helm-charts
helm repo update

4.2.2 部署Kubernetes Agent

使用默认配置安装：

bash
helm install octopus-k8s-agent octopus/kubernetes-agent --namespace octopus-agent --create-namespace

如需自定义配置，可通过指定values.yaml文件覆盖默认参数：

bash
helm install octopus-k8s-agent octopus/kubernetes-agent --namespace octopus-agent --create-namespace -f custom-values.yaml

4.3 配置说明

4.3.1 配置文件参考

values.yaml是Helm Chart的核心配置文件，包含资源限制、环境变量、网络策略等参数。详细配置说明请参考官方文档：
https://github.com/OctopusDeploy/helm-charts/tree/main/charts/kubernetes-agent#readme

4.3.2 关键配置项（示例）

• 资源配置：调整CPU/内存资源限制（通过resources字段）
• 连接参数：配置Octopus Deploy服务器地址、认证令牌（通过octopusServerUrl、apiKey等字段）
• 网络策略：设置Pod间通信规则（通过networkPolicy字段）

五、注意事项

• 使用前需确保已拥有Octopus Deploy账户，未使用Octopus Deploy可注册免费试用：[***]
• 部署前需确认Kubernetes集群版本兼容性（参考Octopus Deploy官方文档）
• 生产环境建议通过values.yaml自定义资源限制、持久化存储等关键配置，确保高可用性

参考链接

• Octopus Kubernetes Agent官方文档：[***]
• Helm Chart仓库：https://github.com/OctopusDeploy/helm-charts