crs81/drone-kubernetes

drone-kubernetes镜像说明

镜像概述

本镜像为drone.io CI/CD平台的Kubernetes插件，用于在CI/CD流水线中自动化更新Kubernetes集群中的部署资源，支持多种部署场景及环境配置。

核心功能

• 单部署资源更新：更新指定Kubernetes Deployment的镜像版本
• 多部署资源更新：同时更新多个Deployment（如调度器- worker架构）
• 多容器更新：更新单个Deployment内的多个容器镜像
• 环境区分部署：根据代码分支自动部署到不同环境（如staging/prod）
• RBAC权限支持：适配Kubernetes RBAC权限模型，需配置专用服务账户

使用场景

1. CI/CD流水线中Kubernetes应用的自动部署与版本更新
2. 多环境（测试/预发/生产）的差异化部署
3. 包含多个容器的微服务应用更新
4. 需要严格权限控制的Kubernetes集群部署场景

配置说明

基础使用示例

更新单个Deployment的镜像：

yaml
pipeline:
  deploy:
    image: crs81/drone-kubernetes
    deployment: my-deployment
    repo: myorg/myrepo
    container: my-container
    tag: 
      - mytag
      - latest

多环境部署示例

根据分支部署到staging和prod环境：

yaml
pipeline:
  deploy-staging:
    image: crs81/drone-kubernetes
    kubernetes_server: ${KUBERNETES_SERVER_STAGING}
    kubernetes_cert: ${KUBERNETES_CERT_STAGING}
    kubernetes_token: ${KUBERNETES_TOKEN_STAGING}
    deployment: my-deployment
    repo: myorg/myrepo
    container: my-container
    namespace: app
    tag: 
      - mytag
      - latest
    when:
      branch: [staging]

  deploy-prod:
    image: crs81/drone-kubernetes
    kubernetes_server: ${KUBERNETES_SERVER_PROD}
    kubernetes_token: ${KUBERNETES_TOKEN_PROD}
    deployment: my-deployment
    repo: myorg/myrepo
    container: my-container
    namespace: app
    tag: 
      - mytag
      - latest
    when:
      branch: [master]

必备Secret配置

需在drone中添加以下Secret：

bash
# 添加Kubernetes API服务器地址
drone secret add --image=crs81/drone-kubernetes your-user/your-repo KUBERNETES_SERVER https://your-k8s-api-server
# 添加Kubernetes CA证书（base64编码）
drone secret add --image=crs81/drone-kubernetes your-user/your-repo KUBERNETES_CERT <base64-encoded-ca-crt>
# 添加Kubernetes认证Token
drone secret add --image=crs81/drone-kubernetes your-user/your-repo KUBERNETES_TOKEN <your-k8s-token>

RBAC权限配置

当Kubernetes启用RBAC时，需创建专用服务账户：

yaml
apiVersion: v1
kind: ServiceAccount
metadata:
  name: drone-deploy
  namespace: web

---
apiVersion: rbac.authorization.k8s.io/v1beta1
kind: Role
metadata:
  name: drone-deploy
  namespace: web
rules:
  - apiGroups: ["extensions"]
    resources: ["deployments"]
    verbs: ["get","list","patch","update"]

---
apiVersion: rbac.authorization.k8s.io/v1beta1
kind: RoleBinding
metadata:
  name: drone-deploy
  namespace: web
subjects:
  - kind: ServiceAccount
    name: drone-deploy
    namespace: web
roleRef:
  kind: Role
  name: drone-deploy
  apiGroup: rbac.authorization.k8s.io

获取Token步骤

1. 查看Pod使用的Token Secret：

bash
kubectl describe po/[your-pod-name] | grep SecretName | grep token

2. 提取Secret中的ca.crt和token：

bash
kubectl get secret [secret-name] -o yaml | egrep 'ca.crt:|token:'

3. 将ca.crt的base64内容填入KUBERNETES_CERT Secret
4. 解码token并填入KUBERNETES_TOKEN Secret：

bash
echo [base64-token] | base64 -d