ystyle/drone-plugin-rancher2

drone-plugin-rancher2

镜像概述和主要用途

drone-plugin-rancher2是一个Drone CI/CD插件，专门用于更新Rancher平台上的工作负载Docker镜像。支持Rancher 2.6.3及以上版本，适配不同版本的Drone CI（1.x和0.8），实现自动化镜像更新流程。

核心功能和特性

• 支持更新Rancher工作负载的Docker镜像名称
• 兼容Rancher 2.6.3及以上版本
• 适配Drone 1.x和0.8版本的CI/CD流程
• 通过环境变量或配置参数传递认证信息和更新数据

使用场景和适用范围

适用于使用Drone作为CI/CD工具的场景，在代码推送或构建完成后，自动更新Rancher管理的Kubernetes集群中工作负载的镜像。例如，项目构建完成后将新镜像部署到测试或生产环境。

使用方法和配置说明

Rancher 2.6.3以上版本

yaml
steps:
  - name: update-rancher
    image: docker.xuanyuan.run/ystyle/drone-plugin-rancher2:2.6
    when:
      branch: master
      event: [push]
    environment:
      SERVER: https://rancher.youdomain.com/k8s/clusters/c-m-w7b37mq1  # 集群kubectl config中的server地址
      TOKEN: kubeconfig-user-d71qwk98dq:d45jfxrdx672r26xmf8ltsj46dcbw2p7lf76dck3vt5nr24gzlpbk9  # 集群kubectl config中的token
    commands:
      - /setup.sh
      - kubectl set image deployment/${DRONE_REPO_NAME} ${DRONE_REPO_NAME}=registry.cn-hangzhou.aliyuncs.com/dexdev/${DRONE_REPO_NAME}:${DRONE_COMMIT_BRANCH}-${DRONE_BUILD_NUMBER}

说明：SERVER和TOKEN需从Rancher集群的kubectl配置中获取（集群页面右上角搜索图标旁边的"kubectl config"）。

Drone 1.x版本

yml
steps:
  - name: update-rancher
    image: docker.xuanyuan.run/ystyle/drone-plugin-rancher2
    settings:
      api: https://rancher.youdomain.com/v3/project/c-27tt1:p-wqtk3/workloads/default:default:nginx  # workload的API URL
      access_key: token-dfi8s  # Rancher用户API密钥
      secret_key: mhgb9w2csrvs6h9nm4fldl4z8f7h4sznx4m6ggvv4p54sffhjlkwvx  # Rancher用户API密钥
      data: [{
        "name": "nginx",  # 容器名称
        "image": "nginx:alpine",  # 镜像名称
        "environment": {  # 环境变量
          "tag": "${DRONE_COMMIT_SHA:0:8}"
          }
      }]

Drone 0.8版本

yml
pipeline:
  update-rancher:
    image: docker.xuanyuan.run/ystyle/drone-plugin-rancher2
    api: https://rancher.youdomain.com/v3/project/c-27tt1:p-wqtk3/workloads/default:default:nginx  # workload的API URL
    access_key: token-dfi8s  # Rancher用户API密钥
    secret_key: mhgb9w2csrvs6h9nm4fldl4z8f7h4sznx4m6ggvv4p54sffhjlkwvx  # Rancher用户API密钥
    data: [{
      "name": "nginx",  # 容器名称
      "image": "nginx:alpine",  # 镜像名称
      "environment": {  # 环境变量
        "tag": "${DRONE_COMMIT_SHA:0:8}"
        }
      }]

参数参考

• api: workload的API URL
• access_key: Rancher用户API密钥
• secret_key: Rancher用户API密钥
• data: API返回结果中的containers字段，仅支持name（容器名称）、image（镜像名称）和environment（环境变量）字段