uala/drone-rancher-deploy

Drone Rancher Deploy插件镜像

镜像概述

本镜像为Drone CI/CD平台的专用插件，旨在帮助团队在Rancher 2.x管理的Kubernetes集群上实现自动化部署。它支持多环境配置、标签合规验证等核心能力，是持续部署流程中的关键工具。

核心功能

1. 多环境部署：通过YAML配置文件定义开发、生产等不同环境的部署规则，支持分支匹配（含正则表达式）。
2. 标签合规检查：验证标签是否部署在指定分支，可选要求标签指向分支头部，确保发布合规性。
3. Dry-run调试：开启后仅输出执行命令而不实际部署，便于提前验证配置正确性。
4. 灵活配置复用：支持ERB模板和YAML锚点，减少重复配置，提升维护效率。

使用场景

• 开发分支提交后自动部署到测试环境。
• 生产环境标签发布前的合规性校验。
• 多环境统一配置管理，降低运维成本。

配置说明

Drone流水线步骤示例

yaml
steps:
  - name: rancher-deploy
    image: docker.xuanyuan.run/uala/drone-rancher-deploy
    settings:
      config: k8s-envs.yml
      dry_run: true
    environment:
      RANCHER_ACCESS_KEY:
        from_secret: RANCHER_ACCESS_KEY
      RANCHER_SECRET_KEY:
        from_secret: RANCHER_SECRET_KEY

配置文件示例（支持ERB与YAML锚点）

yaml
.common: &common
  branch: develop
  server_url: "https://k8s.example.com"
  project: RancherProject
  access_key: <%= ENV['RANCHER_ACCESS_KEY'] %>
  secret_key: <%= ENV['RANCHER_SECRET_KEY'] %>
  services: [web, worker, cron]

develop:
  <<: *common
  namespace: develop

production:
  <<: *common
  namespace: production
  branch: main

关键配置参数

• branch：匹配的分支名称/正则，决定是否触发部署。
• server_url：Rancher服务器地址（必填）。
• project/namespace：Rancher项目与K8s命名空间。
• services：需更新的K8s服务列表。
• image：部署的镜像名称（可通过ERB引用环境变量）。

标签检查功能示例

yaml
steps:
  - name: tag-check
    image: docker.xuanyuan.run/uala/drone-rancher-deploy
    settings:
      action: tag_check
      enforce_branch_for_tag: main
      enforce_head: true

插件设置参数

• config：配置文件路径（必填）。
• dry_run：开启调试模式（非空字符串生效）。
• action：执行动作（deploy/tag_check）。
• enforce_branch_for_tag：标签检查的目标分支。
• enforce_head：要求标签指向分支头部（可选）。