aequitas/ftp-resource

FTP Resource镜像

这是一个Concourse CI的资源镜像，用于在Concourse流水线中与FTP服务器进行交互，实现文件的上传、下载以及版本管理等功能。

核心功能

• check: 从FTP服务器获取匹配正则的文件版本列表
• in: 从FTP服务器下载指定版本的文件
• out: 将指定文件上传至FTP服务器，并可配置保留版本数量

使用场景

• Concourse流水线中自动化上传构建产物到FTP服务器
• 从FTP服务器下载依赖文件用于流水线任务
• 对FTP服务器上的文件进行版本控制与管理

配置说明

源配置（Source Configuration）

• uri（必填）: FTP服务器URI，包含路径、用户名和密码，示例：ftp://user:password@example.com/team/prod/
• regex（必填）: 匹配文件名的Python正则表达式，需包含至少一个名为version的捕获组，其他组将作为元数据
• version_key（可选）: 替代version的捕获组键名，默认值为version
• debug（可选）: 是否开启脚本调试日志，布尔值，默认值为true

行为说明（Behavior）

check：返回文件版本列表

从uri指定的FTP路径获取文件列表，通过regex过滤并提取version_key对应的版本信息，返回版本列表。

in：下载指定版本的文件

根据regex匹配文件和版本，下载与params中version匹配的文件。
参数: version（必填）：需下载的文件版本（与正则中的version捕获组匹配）

out：上传文件到FTP服务器

将file参数指定的 glob 匹配文件上传至uri的FTP目录。
参数:

• file（必填）：指定上传文件的glob模式
• keep_versions（可选）：保留的文件版本数量，需正则中包含名为file的捕获组，默认不限制

示例流水线

yaml
resource_types:
  - name: ftp
    type: docker-image
    source:
      repository: aequitas/ftp-resource

resources:
  - name: ftpupload
    type: ftp
    source:
      regex: (?P<file>test(?P<version>[0-9\.]+).*\.txt)
      uri: [***]

jobs:
  - name: testftp
    plan:
      - task: touchfile
        config:
          platform: linux
          run:
            path: sh
            args:
            - -exc
            - |
              touch test/test1.txt
          outputs:
          - name: test
      - put: ftpupload
        params:
          file: test/test1.txt