stenderg/concourse-fossil-resource

Concourse Fossil资源镜像

概述

该镜像是Avalos的Fossil-Repo的Python实现，专为私有Fossil仓库设计。作为Concourse资源，它允许将Fossil代码仓库集成到Concourse CI/CD流水线中，实现持续集成流程。有关Concourse的安装、使用及流水线编写，请参考官方文档。

核心功能与特性

• 提交监控：定期轮询指定分支的提交记录
• 代码拉取：从Fossil仓库拉取指定提交的代码
• 私有仓库支持：通过认证机制支持私有Fossil仓库访问
• 轻量集成：无缝对接Concourse CI流水线

前提条件

• 编译了JSON支持的最新版Fossil
• 运行在HTTP或CGI模式下的Fossil服务器
• 私有仓库需在访问设置中启用HTTP_AUTHENTICATION

资源类型配置

yaml
resource_types:
  - name: fossil-resource
    type: docker-image
    source:
      repository: stenderg/concourse-fossil-resource
      tag: latest

源配置参数

• url: Fossil仓库URL (必填)
• branch: 要监控和拉取的分支 (必填)
• user: 具有读权限的Fossil仓库用户 (私有仓库必填)
• password: Fossil仓库用户密码 (私有仓库必填)

行为说明

check: 轮询分支提交

资源会从指定url的/json/timeline端点获取提交信息，返回包含提交ID的ref值。

in: 拉取提交代码

使用check步骤返回的ref作为输入，从/tarball/{ref}端点下载代码压缩包并解压到目标目录。

out: 未实现

当前版本不支持向Fossil仓库推送代码。

使用示例

yaml
resource_types:
  - name: fossil-resource
    type: docker-image
    source:
      repository: stenderg/concourse-fossil-resource
      tag: latest

resources:
  - name: fossil
    type: fossil-resource
    source:
      url: https://fossil.avalos.me/fossil-concourse
      branch: trunk

jobs:
  - name: do-something
    serial: true
    plan:
      - get: fossil
        trigger: true
      - task: build
        config:
          platform: linux
          image_resource:
            type: docker-image
            source:
              repository: alpine
              tag: edge
          inputs:
            - name: fossil
              path: .
          run:
            path: ls
            args:
              - -la

许可证

Copyright (C) 2020  Gordon Stender

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <[***]>.