lorands/bx-docker-image-resource

Concourse IBM Cloud私有Docker仓库资源

概述

该Docker镜像提供Concourse资源类型，用于与IBM Cloud (bluemix)私有Docker仓库进行交互，支持Docker镜像的推送和拉取操作，可无缝集成到Concourse CI/CD管道中，实现镜像的自动化管理。

核心功能

• 支持向IBM Cloud私有Docker仓库推送Docker镜像
• 支持从IBM Cloud私有Docker仓库拉取Docker镜像
• 与Concourse CI/CD管道原生集成，提供标准化资源接口

使用场景

• 企业CI/CD流程中，通过Concourse管道自动构建并推送镜像至IBM Cloud私有仓库
• 从IBM Cloud私有仓库拉取指定版本镜像用于测试或生产环境部署
• 实现IBM Cloud私有仓库与Concourse构建流程的紧密衔接

使用方法

资源配置

在Concourse管道定义中，需先配置该资源类型：

yaml
resources:
- name: ibm-cloud-docker-resource
  type: docker-image
  source:
    repository: [镜像仓库地址]  # 该资源的Docker镜像仓库地址
    tag: latest  # 可选，指定镜像版本

- name: my-ibm-docker-repo
  type: ibm-cloud-docker-resource
  source:
    api_endpoint: https://api.ng.bluemix.net  # IBM Cloud API端点
    registry_endpoint: registry.ng.bluemix.net  # 私有仓库端点
    namespace: my-ibm-namespace  # IBM Cloud命名空间
    repository: my-app-repo  # 目标仓库名称
    username: ((ibm-cloud-username))  # IBM Cloud用户名（建议使用凭证管理）
    password: ((ibm-cloud-password))  # IBM Cloud密码（建议使用凭证管理）

推送镜像（out操作）

通过put步骤推送镜像至IBM Cloud私有仓库：

yaml
jobs:
- name: build-and-push-image
  plan:
  - get: source-code
  - task: build-docker-image
    config:
      platform: linux
      image_resource:
        type: docker-image
        source: {repository: docker}
      inputs:
      - name: source-code
      outputs:
      - name: built-image
      run:
        path: sh
        args:
        - -c
        - |
          cd source-code
          docker build -t registry.ng.bluemix.net/my-ibm-namespace/my-app-repo:v1.0 .
          docker save registry.ng.bluemix.net/my-ibm-namespace/my-app-repo:v1.0 > ../built-image/image.tar
  - put: my-ibm-docker-repo
    params:
      image: docker.xuanyuan.run/built-image/image.tar
      tag: v1.0  # 镜像标签

拉取镜像（in操作）

通过get步骤从IBM Cloud私有仓库拉取镜像：

yaml
jobs:
- name: pull-and-deploy
  plan:
  - get: my-ibm-docker-repo
    params:
      tag: v1.0  # 要拉取的镜像标签，默认为latest
    trigger: true  # 当指定标签镜像更新时触发任务
  - task: deploy-app
    config:
      platform: linux
      image_resource:
        type: docker-image
        source: {repository: registry.ng.bluemix.net/my-ibm-namespace/my-app-repo, tag: v1.0}
      run:
        path: /app/start.sh  # 运行镜像中的部署脚本

配置参数说明

资源源参数（source）

推送参数（put params）

拉取参数（get params）

注意事项

• 确保IBM Cloud账户具有目标命名空间和仓库的读写权限
• 敏感信息（如用户名、密码）建议使用Concourse Credentials Manager管理
• 详细配置和高级用法请参考该资源的GitHub仓库获取完整文档