kubetail/kubetail-cluster-api

Kubetail Cluster API Docker镜像

概述

Kubetail Cluster API Docker镜像是用于容器化部署和运行Kubetail Cluster API服务的官方镜像。该镜像将Kubetail集群管理API服务打包为标准化容器，旨在简化部署流程、确保运行环境一致性，并降低依赖配置复杂度，适用于各类Kubernetes集群管理场景。

核心功能与特性

• 容器化部署：通过Docker镜像实现Kubetail Cluster API服务的一键部署，消除手动配置依赖的繁琐步骤
• 环境隔离：提供独立运行环境，避免与主机系统或其他服务产生依赖冲突
• 版本控制：支持通过镜像标签指定Kubetail Cluster API版本，便于版本管理和升级回滚
• 配置灵活性：支持通过环境变量、配置文件挂载等方式自定义服务参数
• 资源优化：基于轻量级基础镜像构建，减少资源占用并提升启动速度

使用场景

• Kubernetes集群管理：部署Kubetail Cluster API服务以提供集群管理接口，支持节点管理、资源调度等操作
• 开发与测试环境：快速搭建一致的API服务开发/测试环境，缩短环境准备时间
• 生产环境部署：作为生产环境中Kubetail Cluster API服务的标准化运行载体，确保服务稳定性
• CI/CD集成：集成到自动化部署流程，实现API服务的持续部署和版本更新

使用方法

前提条件

• Docker Engine 20.10.0+
• （可选）Docker Compose 2.0+（用于多服务编排）
• （可选）Kubernetes集群访问权限（若API服务需对接K8s集群）

快速启动

使用docker run命令直接启动服务：

bash
docker run -d \
  --name kubetail-cluster-api \
  -p 8080:8080 \
  kubetail/cluster-api:latest

说明：默认暴露8080端口，使用最新稳定版镜像

自定义配置

环境变量配置

通过-e参数设置环境变量自定义服务行为：

bash
docker run -d \
  --name kubetail-cluster-api \
  -p 8081:8080 \  # 映射主机8081端口到容器8080端口
  -e API_PORT=8080 \  # 容器内服务监听端口（默认8080）
  -e LOG_LEVEL=info \  # 日志级别（debug/info/warn/error，默认info）
  -e KUBE_CONFIG_PATH=/etc/kubetail/kubeconfig \  # Kubernetes配置文件路径
  -v /host/path/to/kubeconfig:/etc/kubetail/kubeconfig \  # 挂载K8s配置文件
  kubetail/cluster-api:v1.2.0  # 指定v1.2.0版本

配置文件挂载

通过挂载配置文件进行高级配置：

bash
docker run -d \
  --name kubetail-cluster-api \
  -p 8080:8080 \
  -v /host/path/to/config.yaml:/etc/kubetail/config.yaml \  # 挂载自定义配置文件
  kubetail/cluster-api:latest

配置文件格式参考Kubetail Cluster API官方文档，支持集群连接参数、认证配置等高级选项

Docker Compose部署

创建docker-compose.yml文件实现多服务编排：

yaml
version: '3.8'
services:
  kubetail-cluster-api:
    image: kubetail/cluster-api:latest
    container_name: kubetail-cluster-api
    restart: unless-stopped
    ports:
      - "8080:8080"
    environment:
      - LOG_LEVEL=info
      - KUBE_CONFIG_PATH=/etc/kubetail/kubeconfig
    volumes:
      - ./kubeconfig:/etc/kubetail/kubeconfig  # 相对路径挂载K8s配置
    networks:
      - kubetail-network

networks:
  kubetail-network:
    driver: bridge

启动服务：

bash
docker-compose up -d

验证服务状态

服务启动后，通过以下命令检查状态：

bash
# 查看容器运行状态
docker ps --filter "name=kubetail-cluster-api"

# 查看服务日志
docker logs -f kubetail-cluster-api

# 验证API可用性（默认健康检查接口）
curl http://localhost:8080/health

版本说明

• latest：最新稳定版，推荐生产环境使用
• vX.Y.Z：特定版本标签（如v1.2.0），用于版本锁定
• dev：开发版，包含最新特性，不建议生产环境使用

注意事项

• 生产环境建议使用固定版本标签（如v1.2.0）而非latest，避免自动升级导致兼容性问题
• 敏感配置（如认证密钥）建议通过环境变量或加密配置文件挂载，避免硬编码
• 若服务需持久化数据，可通过-v参数挂载数据卷（如-v kubetail-data:/var/lib/kubetail）