octopusdeploy/kubernetes-agent-tools-base

Kubernetes Agent 工具基础镜像 (Octopus Deploy)

镜像概述

该容器镜像为 Octopus Deploy 的 Kubernetes Agent 提供基础执行环境，用于运行 Kubernetes 相关脚本。镜像包含执行 Octopus Deploy 管理的 Kubernetes 工作负载所需的最小化工具集，确保轻量且高效的脚本执行能力。

核心功能与特性

• 最小化工具集：仅包含运行 Kubernetes 脚本的必要工具（如 kubectl 等 Kubernetes 客户端工具），减少镜像体积并优化资源占用。
• Octopus Deploy 兼容性：原生适配 Octopus Deploy 的 Kubernetes Agent，确保脚本执行流程与 Octopus Deploy 平台无缝集成。
• 标准化执行环境：提供一致的工具版本和运行时环境，避免因依赖差异导致的脚本执行异常。

使用场景与适用范围

• Octopus Deploy Kubernetes 工作流：作为 Kubernetes Agent 的执行载体，用于执行 Octopus Deploy 中定义的 Kubernetes 部署、资源管理、配置更新等脚本任务。
• CI/CD 流程集成：在基于 Octopus Deploy 的 CI/CD 管道中，作为 Kubernetes 相关步骤的运行环境，实现容器化应用的自动化部署与管理。
• 轻量级 Agent 环境：适用于资源受限的 Agent 节点，通过最小化工具集降低对宿主机资源的占用。

使用方法与配置说明

镜像拉取

该镜像托管于 Docker Hub（或 Octopus Deploy 官方镜像仓库），可通过以下命令拉取：

bash
docker pull octopusdeploy/kubernetes-agent-tools-base:latest

注：具体标签版本可参考 https://github.com/OctopusDeploy/kubernetes-agent-tools-base 的发布记录。

基本运行示例

通过 docker run 命令直接执行 Kubernetes 脚本（需挂载 Kubernetes 配置文件或配置环境变量以连接集群）：

bash
# 挂载本地 kubeconfig 并执行 kubectl 命令示例
docker run --rm \
  -v ~/.kube/config:/root/.kube/config \  # 挂载 Kubernetes 配置文件
  octopusdeploy/kubernetes-agent-tools-base \
  kubectl get pods -n default  # 执行具体的 Kubernetes 脚本/命令

环境变量配置

镜像支持通过环境变量配置 Kubernetes 集群连接信息，常用配置如下：

与 Octopus Deploy 集成

在 Octopus Deploy 中使用该镜像时，需将其配置为 Kubernetes Agent 的执行环境：

1. 在 Octopus Deploy 管理界面中，导航至 基础设施 > 环境 > [目标环境] > Kubernetes 集群。
2. 配置 Kubernetes Agent 时，指定容器镜像为 octopusdeploy/kubernetes-agent-tools-base:latest。
3. 在项目部署流程中添加 执行 Kubernetes 脚本 步骤，选择上述配置的 Agent，即可基于该镜像执行脚本任务。

相关资源

• GitHub 仓库：https://github.com/OctopusDeploy/kubernetes-agent-tools-base
• Octopus Deploy 文档：Kubernetes Agent 配置指南