dronelab/kubernetes

Dronelab Kubernetes镜像

镜像概述

Dronelab是一套包装器和Docker镜像集合，旨在让用户在Gitlab CI流水线中直接使用Drone CI生态的插件。本镜像（dronelab/kubernetes）是Dronelab工具集的核心组件之一，通过环境变量转换和参数适配，实现Drone插件在Gitlab CI环境中的无缝运行。

核心功能

• 多参数传递方式：支持通过环境变量、YAML格式的plugin变量、命令行参数(-p)三种方式提供插件配置
• 自动变量转换：将Gitlab CI参数转换为Drone插件预期的PLUGIN_前缀环境变量
• 秘密安全处理：支持Gitlab CI项目/组级别的秘密变量传递，避免敏感信息硬编码
• 执行器兼容：适配Gitlab CI的Docker、Docker Machine、Kubernetes等主流执行器
• 预定义变量映射：自动将Gitlab CI预定义变量转换为Drone插件可识别的格式

使用场景

• 在Gitlab CI中复用Drone下载插件获取远程资源
• 通过Drone CloudFormation插件完成AWS资源部署
• 利用Drone Matrix插件发送流水线状态通知到Matrix房间
• 使用yaml锚点/extends关键字简化多任务的插件配置

配置说明

基本用法

以Drone下载插件为例，Gitlab CI配置示例：

yaml
download:
  image: dronelab/kubernetes
  script: dronelab
  variables:
    source: https://example.com/file.tar.gz

参数传递方式

1. 环境变量传递
   直接通过Gitlab CI variables定义插件参数：

yaml
deploy:
  image: dronelab/kubernetes
  script: dronelab
  variables:
    stackname: my-stack
    template: templates/stack.yml

2. Plugin YAML变量传递
   对于复杂对象参数，使用plugin变量传递YAML内容：

yaml
awscf:
  image: dronelab/kubernetes
  script: dronelab
  variables:
    stackname: my-stack
    plugin: |
      params:
        Version: 1.0
        Environment: staging

3. 命令行参数传递
   通过-p参数动态覆盖配置：

yaml
stack-one:
  image: dronelab/kubernetes
  script: dronelab -p stackname stack-one
  variables:
    template: templates/stack.yml

秘密处理

通过Gitlab CI项目秘密变量传递敏感信息（如Matrix密码）：

yaml
matrix-notify:
  image: dronelab/kubernetes
  script: dronelab
  variables:
    username: gitlab-bot
    homeserver: https://matrix.org
    roomid: abcdef:matrix.org
    template: "流水线完成: $CI_PROJECT_NAME"

（注：MATRIX_PASSWORD需在Gitlab CI项目设置中配置为秘密变量）

参数优先级

参数应用顺序（后覆盖前）：

1. 直接定义的PLUGIN_前缀变量或秘密变量
2. Gitlab CI variables中的普通变量
3. plugin YAML变量
4. 命令行-p参数

与Drone使用的差异

• 工件传递：Gitlab CI需显式配置cache或artifacts传递步骤间文件，而Drone默认共享工作空间

工作原理

镜像基于Alpine构建，内置dronelab二进制工具：

1. 读取Gitlab CI参数和环境变量
2. 转换为Drone插件所需的环境变量格式
3. 执行上游Drone插件二进制（由DRONELAB环境变量指定）

联系我们

报告bug或提出建议，请访问https://github.com/mprasil/dronelab/issues/new%E6%8F%90%E4%BA%A4Issue%E3%80%82