evoila/concourse-mvn-resource

concourse-maven-resource

镜像概述和主要用途

concourse-maven-resource是用于Concourse流水线的Docker镜像，主要功能包括在流水线中构建JAR文件、缓存依赖以及从指定位置获取JAR文件。

核心功能和特性

• 支持通过FTP服务器进行依赖缓存管理
• 能够从FTP服务器获取指定的JAR文件
• 支持构建Maven项目并生成JAR文件
• 允许自定义Maven配置（如私有仓库设置）
• 支持修改pom.xml文件（通过pom.add配置）

使用场景和适用范围

适用于需要在Concourse CI/CD流水线中处理Maven项目的场景，包括但不限于：

• Java应用的自动化构建
• 依赖缓存管理以加速构建过程
• 从指定FTP服务器获取或上传JAR文件
• 自定义Maven构建参数和配置

详细使用方法和配置说明

资源定义

在Concourse流水线中定义该资源类型：

yaml
resource_types:
- name: maven-resource
  type: docker-image
  source:
    repository: evoila/concourse-mvn-resource
    tag: latest

Source配置

作为缓存（FTP服务器）

配置FTP服务器用于缓存文件：

yaml
resources:
- name: [资源名称]
  type: maven-resource
  source:
    cache:
      username:     % FTP用户名   
      password:     % FTP密码
      server:       % FTP服务器URL
      path:         % FTP远程路径 
      file:         % FTP远程文件名
      localPath:    % 本地保存文件路径
      excludeCache: % 不缓存到tar文件中的文件
        - de/evoila % 排除de.evoila组（该组从资源构建）

获取JAR文件

从FTP服务器获取指定JAR文件：

yaml
resources:
- name: [资源名称]
  type: maven-resource
  source:
    get:
      username:     % FTP用户名
      password:     % FTP密码
      repository:   % FTP服务器URL
      group:        % 组ID
      artifact:     % artifact ID
      fileName:     % JAR的本地文件名
      lastupdate: 1 % 使用更新日期检查版本变化，而不仅是版本号

构建JAR文件

配置Maven构建参数和私有仓库：

yaml
resources:
- name: [资源名称]
  type: maven-resource
  source:
    pom:
      add: 
      - pom.xml: file % 需要修改的pom文件
    privateRepos:  % 在m2 settings.xml中生成仓库配置
    - repo:
        id:        % 与pom.xml中使用的ID相同
        url:       % FTP服务器URL 
        username:  % FTP服务器用户名
        password:  % FTP服务器密码
    params:
    - name: value  % 定义可在bash脚本中通过PARAMS[name]获取的参数

Put操作（构建JAR）

构建JAR并执行相关操作：

yaml
put: [资源名称]
  params:
    pom:
      file: git-osb-samba/pom.xml % 用于开始替换版本号的pom文件 
    script:                     % 调用mvn的bash脚本路径
    updateCache: true            % 是否更新缓存，默认为false
    version:                      % JAR的版本文件或版本号，可在bash中通过VERSION[main]引用
    versions:
    - name: value                 % 版本文件或版本号，可在bash中通过VERSION[name]引用
    params:                       % 可在bash中通过PARAMS[name]引用的参数
    - name: value

pom.add文件格式

用于修改pom.xml文件的配置格式：

yaml
path: /project/build/pluginManagement/plugins % 无需占位符的pom路径，必须存在
insert:                                       % 作为path的XML子节点添加的内容
  plugin:
    groupId: org.apache.maven.plugins
    artifactId: maven-deploy-plugin

生成的pom.xml片段示例：

xml
<project>
  <build>
    <pluginManagement>
      <plugins>
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-deploy-plugin</artifactId>
        </plugin>
      </plugins>
    </pluginManagement>
  </build>
</project>