octopusdeploy/kubernetes-agent-tentacle

Kubernetes agent tentacle 镜像文档

1. 镜像概述与主要用途

1.1 重要提示

本镜像不支持直接使用，仅可作为 Kubernetes agent helm chart 的组成部分。

1.2 概述

Kubernetes agent tentacle 镜像是 https://hub.docker.com/repository/docker/octopusdeploy/tentacle 镜像的定制版本，专门用于 https://hub.docker.com/repository/docker/octopusdeploy/kubernetes-agent helm chart。该镜像针对 Kubernetes agent 的工作流进行了适配性修改，以支持其特定运行逻辑。

1.3 主要用途

作为 Octopus Deploy Kubernetes agent helm chart 的核心组件，提供 Tentacle 运行环境，支持 Kubernetes 集群内的任务执行与 agent 工作流协调。

2. 核心功能与特性

• 基于 Tentacle 基础镜像：继承 octopusdeploy/tentacle 镜像的核心能力，提供 Octopus Deploy 任务执行基础环境。
• 适配 Kubernetes agent 工作流：针对 Kubernetes agent 的部署、通信及任务调度流程进行定制优化，确保与 helm chart 组件协同工作。

3. 使用场景与适用范围

3.1 使用场景

仅用于配合 Octopus Deploy 官方提供的 Kubernetes agent helm chart 进行部署，作为 Kubernetes agent 在集群内的任务执行节点。

3.2 适用范围

适用于通过 Kubernetes agent 在 Kubernetes 集群中运行 Octopus Deploy 任务的用户，需结合官方 helm chart 使用。

4. 使用方法与配置说明

4.1 使用限制

不支持直接通过 docker run 或 docker-compose 部署，必须作为 Kubernetes agent helm chart 的一部分，通过 helm 工具进行部署。

4.2 部署方法（通过 Helm Chart）

1. 添加 Octopus Deploy Helm 仓库（若未添加）：

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

2. 部署 Kubernetes agent helm chart： 参考官方 helm chart 文档配置参数后执行部署，示例命令：

   bash
   helm install kubernetes-agent octopus/kubernetes-agent \
     --namespace octopus-agent \
     --create-namespace \
     --set agent.name=my-agent \
     --set server.url=https://your-octopus-server-url \
     --set server.apiKey=your-api-key
   

   注：具体参数需根据实际环境调整，详细配置项参考 https://hub.docker.com/repository/docker/octopusdeploy/kubernetes-agent%E3%80%82

4.3 配置参数

镜像相关配置通过 helm chart 的 values.yaml 文件或 --set 参数传递，主要包括：

• Octopus Server 连接信息（URL、API Key 等）
• Agent 名称与标识
• 资源限制与请求（CPU、内存）
• 网络与存储配置

具体参数列表及说明请参考官方 Kubernetes agent helm chart 文档。

5. 注意事项

• 若需在 Kubernetes 集群中独立运行 Tentacle 以执行工作负载，可参考 Octopus Deploy 路线图中的 Workers on Kubernetes 项目。
• 镜像版本需与 Kubernetes agent helm chart 版本匹配，避免兼容性问题。