jakepivotal/apache-directory-index-resource

Apache Directory Index Resource 镜像

镜像概述

本镜像为Concourse CI/CD平台的资源类型，用于对接Apache目录索引服务，实现版本化文件的自动检测与下载。它支持从指定的Apache目录中识别符合规则的版本文件夹及文件，并将其下载到Concourse任务环境中。

核心功能

1. 版本检测（check）：自动检查指定Apache目录中是否存在新的版本文件。
2. 文件下载（in）：下载对应版本的文件，并生成包含文件本身、下载URL、版本号的元数据；若开启expand，则会解压文件到expanded目录。
3. 版本匹配：通过folder_pattern和file_pattern参数匹配符合规则的版本文件夹与文件。

使用场景

适用于CI/CD流程中自动化获取Apache官方发布的软件包（如Tomcat、Httpd等），例如：

• 自动下载最新版本的Tomcat安装包用于应用部署。
• 定期获取Apache软件的历史版本用于测试兼容性。

配置说明

资源类型配置

yaml
resource_types:
  - name: apache-directory-index
    type: docker-image
    source:
      repository: jakepivotal/apache-directory-index-resource

资源配置

yaml
resources:
  - name: tomcat-8
    type: apache-directory-index
    source:
      directory: https://archive.apache.org/dist/tomcat/tomcat-8/  # Apache目录索引地址
      folder_pattern: v$VERSION  # 版本文件夹命名规则（$VERSION为版本占位符）
      file_pattern: bin/apache-tomcat-$VERSION.tar.gz  # 文件命名规则
      expand: true  # 是否解压文件到expanded目录

参数说明：

• directory：版本文件夹所在的Apache目录索引URL。
• folder_pattern：版本文件夹的命名模式，使用$VERSION作为版本占位符。
• file_pattern：目标文件的路径及命名模式，使用$VERSION作为版本占位符。
• expand：是否将下载的文件解压到expanded目录（布尔值）。

注意：版本号需符合<scripts/check>中定义的version_pattern规则（例如1.2.3-beta.4）。

行为说明

check：检测新版本

检查指定Apache目录中是否存在符合规则的新版本文件。

in：下载版本文件

在目标目录生成以下内容：

• 下载的文件本身（如apache-tomcat-8.5.93.tar.gz）。
• url文件：包含下载文件的URL。
• version文件：包含识别到的版本号。
• expanded目录：若expand为true，则存放解压后的文件内容。

使用示例

yaml
jobs:
  - name: download-tomcat-8
    plan:
      - get: tomcat-8
        trigger: true  # 当检测到新版本时自动触发任务