fiftin/concourse-ansible-playbook-resource

Concourse Ansible 2.9 Playbook资源

这是一个[***] playbooks。镜像包含Java、Python和Ruby等必要依赖，支持从Git仓库拉取playbooks并完成自动化配置或部署任务。

核心功能

• 执行Git仓库中的Ansible playbooks
• 通过ansible-galaxy install安装requirements.yml定义的依赖
• 支持SSH私钥、Git认证等安全配置
• 提供调试模式和详细输出，便于问题排查
• 兼容Ansible Vault密码解密功能

使用场景

• Concourse CI流水线中的自动化部署任务
• 多环境（开发/测试/生产）的一致性配置管理
• 服务器初始化与维护操作
• 应用环境的批量更新

配置说明

源配置（Source Configuration）

大部分配置映射到ansible-playbook选项，git_*配置用于处理requirements.yml中的Git仓库：

• debug：可选，布尔值，默认false，输出调试信息
• env：可选，环境变量列表，传递依赖配置或Ansible选项
• git_https_username/password：Git HTTP/S认证信息
• git_private_key：Git SSH私钥
• ssh_private_key：必填，远程系统SSH私钥
• vault_password：Ansible Vault解密密码
• verbose：输出详细程度（如v/vv）

源配置示例

yaml
resource_types:
- name: ansible-playbook
  type: docker-image
  source:
    repository: troykinsella/concourse-ansible-playbook-resource
    tag: latest

resources:
- name: ansible
  type: ansible-playbook
  source:
    debug: false
    user: ubuntu
    ssh_private_key: ((ansible_ssh_private_key))
    vault_password: ((ansible_vault_password))
    verbose: v

参数配置（Parameters）

控制playbook执行的参数：

• check：可选，布尔值，默认false，仅检查变更不执行
• inventory：必填，inventory文件路径（相对path）
• playbook：可选，默认site.yml，playbook路径（相对path）
• path：必填，playbook源目录路径（通常指向Git资源目录）

任务配置示例

yaml
jobs:
- name: provision-frontend
  plan:
  - get: master # Git资源
  - put: ansible
    params:
      check: true
      diff: true
      inventory: inventory/some-hosts.yml
      playbook: provision-frontend.yml
      path: master

测试

bash
docker build .

Roadmap

• 支持ansible-playbook的--tags和--skip-tags参数

许可证

MIT © Troy Kinsella