zzzsochi/kubedrone

zzzsochi/kubedrone 镜像文档

镜像概述和主要用途

zzzsochi/kubedrone是一个用于从Drone CI/CD平台应用Kubernetes配置的Docker镜像。它提供了多种部署方式和认证机制，支持自动化部署Kubernetes资源，并包含项目版本管理功能，适用于CI/CD流水线中的部署阶段。

核心功能和特性

• 支持通过kubectl apply -f直接部署配置文件
• 支持通过kustomize build构建配置并应用
• 支持执行自定义部署脚本
• 提供多种Kubernetes认证方式：Token、客户端密钥、基本认证、AWS EKS
• 支持调试模式，输出详细操作日志
• 提供版本管理功能：保存版本到ConfigMap和从ConfigMap获取版本

使用场景和适用范围

适用于Drone CI/CD流水线中需要自动化部署Kubernetes应用的场景，包括：

• 直接部署Kubernetes YAML配置文件
• 通过kustomize管理多环境配置并部署
• 执行自定义部署脚本实现复杂部署逻辑
• 在不同构建/部署阶段进行项目版本的保存和获取

使用方法和配置说明

部署方式

kubectl apply -f <文件>

通过指定Kubernetes配置文件直接部署资源：

yaml
- name: deploy
  image: zzzsochi/kubedrone
  settings:
    apply_file: build/config.yaml
    ...

kustomize build <目录> | kubectl apply -f -

构建kustomize目录并应用生成的配置：

yaml
- name: deploy
  image: zzzsochi/kubedrone
  settings:
    apply_kustomize: build/kustomize/stage
    ...

运行脚本

执行自定义部署脚本：

yaml
- name: deploy
  image: zzzsochi/kubedrone
  settings:
    script: build/kustomize/stage
    ...

认证方式

Token认证

使用Token进行Kubernetes集群认证：

yaml
- name: deploy
  image: zzzsochi/kubedrone
  settings:
    server: "secret"          # Kubernetes API服务器地址
    server_ca: "secret"       # 服务器CA证书
    token: "secret"           # 认证Token
    ...

客户端密钥认证

使用客户端证书和密钥进行认证：

yaml
- name: deploy
  image: zzzsochi/kubedrone
  settings:
    server: "secret"          # Kubernetes API服务器地址
    server_ca: "secret"       # 服务器CA证书
    client_crt: "secret"      # 客户端证书
    client_key: "secret"      # 客户端密钥
    ...

基本认证

使用用户名和密码进行认证：

yaml
- name: deploy
  image: zzzsochi/kubedrone
  settings:
    server: "secret"          # Kubernetes API服务器地址
    server_ca: "secret"       # 服务器CA证书
    username: "secret"        # 用户名
    password: "secret"        # 密码
    ...

AWS EKS认证

针对AWS EKS集群的认证：

yaml
- name: deploy
  image: zzzsochi/kubedrone
  settings:
    eks_cluster_region: "secret"      # EKS集群区域
    eks_cluster_name: "secret"        # EKS集群名称
    aws_access_key_id: "secret"       # AWS访问密钥ID
    aws_secret_access_key: "secret"   # AWS密钥
    ...

详细模式

启用调试模式以输出详细操作日志：

yaml
- name: deploy
  image: zzzsochi/kubedrone
  settings:
    debug: "true"   # 设置为"true"启用详细日志
    ...

项目版本管理

在项目构建阶段（如stage分支）保存版本，并在部署阶段（如master分支）获取该版本。

为提交保存版本

将版本信息保存到Kubernetes ConfigMap中：

yaml
- name: version
  image: zzzsochi/kubedrone:version
  settings:
    command: save               # 命令：保存版本
    vendor: tc                  # 供应商/组织标识
    service: core               # 服务名称
    status: ok                  # 版本状态
    version_file: build/version # 版本文件路径
    ...

通过提交获取版本

从ConfigMap获取之前保存的版本，并创建版本文件：

yaml
- name: version
  image: zzzsochi/kubedrone:version
  settings:
    command: get                # 命令：获取版本
    vendor: tc                  # 供应商/组织标识（需与保存时一致）
    service: core               # 服务名称（需与保存时一致）
    status: ok                  # 版本状态（需与保存时一致）
    version_file: build/version # 生成的版本文件路径
    ...

此阶段将创建build/version文件，包含之前保存的项目版本。