pivotalservices/github-team-repos-resource

GitHub团队仓库资源

该资源是Concourse的自定义资源，用于跟踪GitHub团队所属仓库的提交记录，同时监控仓库的添加或删除操作。

资源类型配置

由于该资源类型非Concourse内置资源，需在流水线中配置为自定义资源类型：

yml
resource_types:
- name: github-team-repos
  type: docker-image
  source:
    repository: pivotalservices/github-team-repos-resource
    tag: "1.0"

资源配置参数

配置该资源需指定以下参数：

• org: 必填。GitHub组织名称。例如团队仓库页面为https://github.com/orgs/pivotalservices/teams/app-0/repositories时，org值为pivotalservices。
• team: 必填。组织内的团队名称。以上述示例为例，team值为app-0。
• auth_token: 必填。具有团队仓库列表访问权限及仓库读权限（克隆、拉取）的GitHub授权令牌。
• repos_excluded: 可选。需排除跟踪的仓库列表，格式为{组织名}/{仓库名}，如pivotalservices/modernization-cookbook-template。

配置示例

yaml
resources:
- name: my-team-repos
  type: github-team-repos
  source:
    auth_token: {{GITHUB_AUTH_TOKEN}}
    org: pivotalservices
    team: app-0
    repos_excluded:
    - pivotalservices/modernization-cookbook-template
    - pivotalservices/transformation-recipes-aggregator

行为说明

check：检查新提交

克隆（或拉取已存在的）团队所有仓库，返回每个仓库的HEAD引用。因Concourse仅支持单字符串版本信息，会将多仓库引用转为JSON字符串并通过base64编码。

in：克隆指定引用的仓库

将仓库克隆到目标路径并锁定到指定引用，返回与版本一致的base64编码引用。

out：未实现

该资源不支持向团队仓库推送任何变更。

开发贡献

可通过以下地址贡献代码：https://github.com/pivotalservices/github-team-repos-resource