jpmorin/cf-flyway-resource

已迁移至 https://hub.docker.com/r/emeraldsquad/cf-flyway-resource

早期采用者注意！此仓库已迁移至 > https://hub.docker.com/r/emeraldsquad/cf-flyway-resource%E3%80%82

cf-flyway-resource

数据库版本控制工具，可通过https://concourse-ci.org/%E5%92%8Chttps://flywaydb.org/%E8%BD%BB%E6%9D%BE%E3%80%81%E5%8F%AF%E9%9D%A0%E5%9C%B0%E8%BF%81%E7%A7%BB%E8%87%B3Cloud Foundry数据库服务。

核心功能

• 无缝连接Cloud Foundry数据库服务
• 支持所有Flyway CLI命令
• 支持Flyway配置文件
• 兼容社区版与专业版
• 输出数据库服务元数据

支持的标签

以下标签为官方支持：

http://dockeri.co/image/emeraldsquad/cf-flyway-resource](https://hub.docker.com/r/emeraldsquad/cf-flyway-resource/)

• https://github.com/emerald-squad/cf-flyway-resource/blob/v1.0.1/Dockerfile
• https://github.com/emerald-squad/cf-flyway-resource/blob/v1.0.0/Dockerfile

http://dockeri.co/image/jpmorin/cf-flyway-resource](https://hub.docker.com/r/jpmorin/cf-flyway-resource/)

• https://github.com/emerald-squad/cf-flyway-resource/blob/v0.1.2/Dockerfile
• https://github.com/emerald-squad/cf-flyway-resource/blob/v0.1.1/Dockerfile

resource_types配置

该镜像基于https://hub.docker.com/r/boxfuse/flyway%E6%9E%84%E5%BB%BA%EF%BC%8C%E5%B7%B2%E9%A2%84%E8%A3%85%60cf_cli%60%E5%92%8C%60jq%60%E5%B7%A5%E5%85%B7%EF%BC%9A

yml
- name: cf-flyway-resource
  type: docker-image
  source:
    repository: emeraldsquad/cf-flyway-resource
    tag: 1.0.1

resource配置

source参数（必填）

• api: Cloud Foundry控制器API端点
• username: 认证用户名
• password: 认证密码
• organization: 目标组织名称
• space: 目标空间名称
• service: 数据库服务实例名称

示例：

yml
- name: cf-flyway
  type: cf-flyway-resource
  source:
    api: cf-api-endpoint
    username: cf-user
    password: cf-user-password
    organization: organization-name
    space: space-name
    service: service-instance-name

check操作

version

check脚本始终返回当前版本号，若未收到版本则生成初始版本（UTC时间戳格式）。

metadata

从CF API读取服务信息生成元数据：

yml
metadata_url : /v2/service_instances/fe7f0258-5b6f-7b26-2cb2-79ad6f2a7454
pcf_api : https://my.api.endpoint.com
pcf_org : organization-name
pcf_space : space-name
service_instance : cf-db-service-instance-name
service_label : cf-db-service-name
service_plan : cf-db-service-plan

in操作

version

in脚本始终返回当前版本号，因此该资源不能作为输入触发器。

metadata

同check操作的metadata输出。

out操作（数据库迁移）

out脚本流程：

1. 在Cloud Foundry数据库服务上创建service-key
2. 读取service-key凭据生成flyway.conf（包含数据库连接信息，默认设置flyway.cleanDisabled=true）
3. 执行Flyway命令（默认：info→migrate→info）

params参数

• locations（必填）：逗号分隔的迁移文件路径列表（支持classpath:和filesystem:前缀）
• commands（可选）：执行的Flyway命令列表（默认：[info, migrate, info]）
• clean_disabled（可选）：是否禁用clean操作（默认：true）
• delete_service_key（可选）：迁移完成后是否删除service-key（默认：false）
• flyway_conf（可选）：Flyway配置文件路径或内联配置（部分参数会被覆盖）
• jdbc_builder（可选，测试版）：自定义JDBC URL生成脚本（接收service-key JSON作为参数）

使用示例

1. 仅使用必填参数

yml
jobs:
- name: deploy
  plan:
  - get: my-app-package
  - put: cf-flyway
    params:
      locations: filesystem:my-app-package/DB/Schema

2. 添加Flyway配置文件

yml
jobs:
- name: deploy
  plan:
  - get: my-app-package
  - put: cf-flyway
    params:
      locations: filesystem:my-app-package/DB/Schema
      flyway_conf: my-app-package/DB/flyway.config

3. 内联Flyway配置

yml
jobs:
- name: deploy
  plan:
  - get: my-app-package
  - put: cf-flyway
    params:
      locations: filesystem:my-app-package/DB/Schema
      flyway_conf: |
        flyway.schemas=dbo
        flyway.connectRetries=2

4. 自定义命令序列

yml
jobs:
- name: deploy
  plan:
  - get: my-app-package
  - put: cf-flyway
    params:
      locations: filesystem:my-app-package/DB/Schema
      commands: [info, validate]

5. 使用Flyway专业版功能

yml
jobs:
- name: deploy
  plan:
  - get: my-app-package
  - put: cf-flyway
    params:
      locations: filesystem:my-app-package/DB/Schema
      commands: [info, undo, info]
      flyway_conf: |
        flyway.licenseKey=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

6. 使用自定义JDBC生成脚本

yml
jobs:
- name: deploy
  plan:
  - get: my-app-package
  - put: cf-flyway
    params:
      locations: filesystem:my-app-package/DB/Schema,
      jdbc_builder: my-app-package/my-jdbc-builder.sh

version

out脚本始终返回新的版本号（UTC时间戳）。

metadata

同check操作的metadata输出。