vavere/concourse-smb-share

concourse-smb-share

镜像概述

这是Concourse CI的资源镜像，用于通过Windows服务器上的SMB/CIFS共享存储位置获取或持久化构建工件。基于Node.js开发，内部使用Samba项目的smbclient工具实现SMB协议交互。

核心功能

1. 从SMB共享获取指定文件或全部文件
2. 向SMB共享上传指定文件或目录内容
3. 支持跳过put操作后的隐式get步骤（优化大文件场景）
4. 允许通过数组或字符串形式指定目标文件（字符串形式需确保文件名无空格）

使用场景

适用于Concourse CI流水线中与Windows SMB共享的交互场景：

• 从共享获取依赖包或配置文件
• 上传构建结果到共享存储
• 同步流水线中间产物到SMB共享

配置说明

定义资源类型

在Concourse流水线中注册该资源类型：

yaml
resource_types:
- name: smb-resource
  type: docker-image
  source:
      repository: vavere/concourse-smb-share
      tag: latest

定义资源实例

每个资源需指定SMB路径及可选凭证：

• path: 共享路径（格式：//服务器名/共享名/内部路径，如//win-server/shared/artifacts）
• user: 访问用户名（可选）
• pass: 访问密码（可选）

示例：

yaml
resources:
- name: smb-artifacts
  type: smb-resource
  source:
    path: //win-server/shared/build-output
    user: ((smb-username))
    pass: ((smb-password))

流水线任务使用示例

获取指定文件

yaml
jobs:
- name: fetch-dependencies
  plan:
  - get: smb-artifacts
    params:
      files:
      - libs/utils.jar
      - config/app.conf

上传文件并跳过隐式获取

yaml
jobs:
- name: upload-build-result
  plan:
  - put: smb-artifacts
    params:
      dir: dist
      files:
      - app.exe
      - logs/build.log
    get_params:
      skip: true

字符串形式指定文件（无空格）

yaml
put: smb-artifacts
  params:
    files: app.exe build.log

测试

执行以下命令运行测试：

bash
npm test

许可

采用MIT许可证（MIT）