rmeharg/bosh-creds-resource

BOSH凭证的Concourse资源镜像

镜像概述

本镜像作为Concourse CI/CD流水线的资源类型，用于连接Ops Manager并获取BOSH Director的相关凭证，简化流水线中与BOSH交互的配置流程。

核心功能

1. 从Ops Manager获取BOSH凭证文件（CA证书、用户名、密码、Director IP等）
2. 提供BOSH CLI v2直接可用的凭证脚本，无需手动登录
3. 生成与https://github.com/cloudfoundry/bosh-deployment-resource%E5%85%BC%E5%AE%B9%E7%9A%84JSON%E6%A0%BC%E5%BC%8F%E5%87%AD%E8%AF%81
4. 支持配置外部BOSH Director的凭证，实现多环境切换

使用场景

• Concourse流水线中部署或管理BOSH应用的自动化场景
• 批量获取BOSH凭证以执行部署、更新等操作
• 切换Ops Manager内置BOSH Director与外部BOSH Director的部署环境

配置说明

1. 定义资源类型

在流水线中引入该资源类型：

resource_types:
- name: bosh-creds
  type: docker-image
  source:
    repository: mkuratczyk/bosh-creds-resource
    tag: latest

2. 配置资源实例

填写Ops Manager认证信息创建资源实例：

resources:
- name: om-bosh-creds
  type: bosh-creds
  source:
    pcf_opsman_admin_username: {{pcf_opsman_admin_username}}
    pcf_opsman_admin_password: {{pcf_opsman_admin_password}}
    opsman_url: {{opsman_url}}

3. 任务中使用资源

将资源添加到任务计划，可选指定deployment参数：

- name: job-name
  plan:
  - aggregate:
    # 其他资源...
    - get: om-bosh-creds
      params:
        deployment: my_deployment

4. 外部BOSH Director配置

若需使用外部BOSH，添加外部凭证配置：

resources:
- name: pcf-bosh-creds
  type: bosh-creds
  source:
    pcf_opsman_admin_username: ((pcf_opsman_admin_username))
    pcf_opsman_admin_password: ((pcf_opsman_admin_password))
    opsman_url: ((opsman_url))
    external_bosh_address: ((external_bosh_address))
    external_bosh_client: ((external_bosh_client))
    external_bosh_client_secret: ((external_bosh_client_secret))
    external_bosh_ca_cert: ((external_bosh_ca_cert))

通过参数切换内置/外部BOSH：

- put: bosh-deployment
  params:
    source_file: pcf-bosh-creds/((director_for_deployment)).json

director_for_deployment可取值opsman_bosh（内置）或external_bosh（外部）。

注意事项

当前资源仅一次性获取凭证，凭证更新需重新触发资源获取操作。