fleetdm/fleetctl

Fleet fleetctl 工具镜像

镜像概述和主要用途

本Docker镜像为轻量级镜像，仅包含Fleet项目的fleetctl命令行工具。Fleet是用于管理Kubernetes集群上应用部署的声明式GitOps工具，fleetctl则是其官方命令行客户端，用于与Fleet集群进行交互，执行应用部署、状态检查、配置管理等操作。本镜像旨在提供一个便捷、隔离的环境，使用户无需在主机系统直接安装fleetctl及其依赖，即可快速使用该工具。

核心功能和特性

• 仅含核心工具：镜像专注于提供fleetctl工具，无多余组件，保持轻量级特性
• 环境隔离：在容器环境中运行fleetctl，避免对主机系统依赖造成干扰
• 版本一致性：可通过镜像标签指定fleetctl版本，确保环境一致性
• 跨平台兼容：可在任何支持Docker的平台上运行，无需考虑底层系统差异

使用场景和适用范围

• CI/CD流程集成：在自动化流水线中嵌入fleetctl命令，实现Fleet应用的自动部署和更新
• 临时管理需求：在无本地fleetctl安装的环境中，快速启动容器执行集群管理操作
• 多版本测试：通过切换不同标签的镜像，测试不同版本fleetctl与集群的兼容性
• 开发环境隔离：避免在开发主机安装多个版本工具或依赖冲突

使用方法和配置说明

基本使用方法

通过docker run命令启动容器并执行fleetctl命令，基本格式如下：

bash
docker run --rm <镜像名称> fleetctl <命令>

查看工具版本

验证镜像中的fleetctl版本：

bash
docker run --rm fleet-fleetctl fleetctl version

与Fleet集群交互

与Fleet集群交互需提供Kubernetes集群配置（通常通过kubeconfig文件），可通过挂载主机的kubeconfig文件实现：

bash
docker run --rm -v $HOME/.kube/config:/root/.kube/config fleet-fleetctl fleetctl get clusters

常用命令示例

• 列出Fleet集群：

  bash
  docker run --rm -v $HOME/.kube/config:/root/.kube/config fleet-fleetctl fleetctl get clusters
  

• 部署应用到Fleet：

  bash
  docker run --rm -v $HOME/.kube/config:/root/.kube/config -v $(pwd):/workspace fleet-fleetctl fleetctl apply -f /workspace/fleet.yaml
  

• 检查应用部署状态：

  bash
  docker run --rm -v $HOME/.kube/config:/root/.kube/config fleet-fleetctl fleetctl status <应用名称>
  

配置参数

环境变量

挂载配置

• Kubernetes配置文件：需将主机的kubeconfig文件挂载到容器内$KUBECONFIG指定路径（默认/root/.kube/config）
• 应用配置文件：如需使用本地Fleet配置文件（如fleet.yaml），可通过挂载主机目录到容器内工作目录（如/workspace）

高级使用示例

持久化配置

如需在多次容器运行中保持配置，可创建数据卷挂载配置目录：

bash
# 创建数据卷
docker volume create fleet-config

# 首次运行时复制kubeconfig到数据卷
docker run --rm -v $HOME/.kube/config:/source -v fleet-config:/root/.kube alpine cp /source /root/.kube/config

# 后续使用数据卷中的配置
docker run --rm -v fleet-config:/root/.kube fleet-fleetctl fleetctl get deployments

在Docker Compose中使用

yaml
version: '3'
services:
  fleetctl:
    image: fleet-fleetctl
    volumes:
      - $HOME/.kube/config:/root/.kube/config
      - ./fleet-configs:/workspace
    command: fleetctl apply -f /workspace/deployment.yaml