smgoller/gci-resource

GCI更新资源

这是一个Concourse CI资源，用于检查Google Compute Image（GCI）家族中的新镜像，基于Jeff Waugh的AMI Update Resource开发。

镜像概述

该资源可帮助Concourse流水线自动检测指定GCI家族的更新，获取镜像详细信息，并生成适配Packer工具的配置文件，支持自动化构建流程。

核心功能

1. 检查更新: 定期查询指定GCI家族中的最新镜像，以镜像名称作为版本标识。
2. 获取镜像信息: 下载镜像的完整描述（JSON格式）、镜像ID（纯文本）及Packer变量文件（适配Packer构建）。

使用场景

适用于Concourse CI流水线中需要基于最新GCI进行自定义镜像构建、环境部署更新等场景，例如：

• 自动检测Ubuntu LTS系列GCI更新，触发Packer构建自定义应用镜像；
• 跟踪GCP官方镜像家族，确保流水线使用最新稳定镜像。

配置说明

源配置（Source Configuration）

• key: 必填。包含GCP服务账号凭证的JSON字符串，该账号需具备查询GCI信息的权限。
• family_project: 必填。镜像家族所属的GCP项目（如ubuntu-os-cloud）。
• family: 必填。需要跟踪的镜像家族名称（如ubuntu-1804-lts）。

行为说明

check: 检查指定家族的新GCI

查询指定家族中的最新GCI，返回镜像名称作为版本信息。无额外参数。

in: 获取GCI描述

在目标目录生成以下文件：

• output.json: GCI的完整描述JSON文件；
• name: 镜像ID的纯文本文件；
• packer.json: Packer变量文件，格式示例：

  json
  {"source_image": "debian-7-wheezy-v20150127"}
  

无额外参数。

流水线示例

以下流水线每小时检查Ubuntu 18.04 LTS GCI的更新，若发现新镜像则触发后续构建任务：

yaml
resource_types:
- name: gci
  type: docker-image
  source:
    repository: smgoller/gci-resource

resources:
- name: ubuntu-gci
  type: gci
  check_every: 1h
  source:
    key: "你的GCP服务账号凭证JSON字符串"
    family_project: ubuntu-os-cloud
    family: ubuntu-1804-lts

jobs:
- name: build-with-new-gci
  plan:
  - get: ubuntu-gci
    trigger: true
  - task: build-custom-image
    # 此处填写自定义镜像构建任务配置
    ...