dronelab/scp

Dronelab SCP插件

镜像概述

Dronelab是一个包装器和Docker镜像集合，允许用户在Gitlab CI流水线中使用Drone CI插件。dronelab/scp镜像作为其中一员，提供了Drone SCP插件的Gitlab CI集成能力，帮助用户在CI流程中高效实现文件传输操作。

核心功能

1. 支持多种参数传递方式：Gitlab CI变量、plugin YAML字符串、命令行参数(-p)
2. 自动转换参数为Drone插件所需的环境变量格式（如PLUGIN_前缀）
3. 兼容Gitlab CI Secrets配置，安全处理敏感信息（如SSH密钥）
4. 明确的参数优先级规则，满足灵活配置需求

使用场景

• 构建产物传输：将CI构建生成的文件同步到远程服务器
• 自动化部署：在部署步骤中传递配置文件或静态资源到目标环境
• 跨步骤文件传递：在Gitlab CI多步骤流水线中共享文件资源

配置说明

基本使用示例

yaml
scp-deploy:
  image: docker.xuanyuan.run/dronelab/scp
  script: dronelab
  variables:
    source: ./build/**/*
    target: deploy@example.com:/var/www/app
    key: $SSH_PRIVATE_KEY  # 引用Gitlab CI Secrets中的密钥

参数提供方式

1. 变量直接传递（适用于简单参数）：

   yaml
   scp-transfer:
     image: docker.xuanyuan.run/dronelab/scp
     script: dronelab
     variables:
       source: ./dist/*.zip
       target: user@server:/data/archives
   

2. plugin YAML变量（适用于复杂结构）：

   yaml
   scp-transfer:
     image: docker.xuanyuan.run/dronelab/scp
     script: dronelab
     variables:
       plugin: |
         source: ./dist/*
         target: user@server:/path/to/dest
         key: $SSH_PRIVATE_KEY
         port: 2222
   

3. 命令行参数(-p)（适用于模板覆盖）：

   yaml
   .scp-template: &scp-template
     image: docker.xuanyuan.run/dronelab/scp
     variables:
       source: ./dist/*
       key: $SSH_PRIVATE_KEY
   
   deploy-dev:
     <<: *scp-template
     script: dronelab -p target dev@server:/dev/app -p port 2222
   
   deploy-prod:
     <<: *scp-template
     script: dronelab -p target prod@server:/prod/app -p port 22
   

参数优先级规则

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

1. 直接提供的PLUGIN_前缀变量或Secret变量
2. variables中的单个参数
3. plugin YAML变量中的参数
4. 命令行-p参数传递的参数

敏感信息处理

敏感信息（如SSH密钥）建议通过Gitlab CI的项目/组级CI/CD变量配置（设置为"Protected"和"Masked"），避免硬编码到配置文件中。在配置中通过$变量名引用即可。

yaml
scp-transfer:
  image: dronelab/scp
  script: dronelab
  variables:
    source: ./dist/*
    target: user@server:/path/to/dest
    key: $SSH_PRIVATE_KEY  # 引用Gitlab CI Secrets中的密钥