arsenick/concourse-ansible-playbook-resource

Concourse Ansible Playbook资源镜像

镜像概述

本镜像为Concourse CI平台提供Ansible playbook执行能力，内置通过pip安装的最新版Ansible（基于Python3），支持Ansible Galaxy依赖安装、SSH连接配置、Vault密码管理等核心功能，帮助用户在CI/CD流水线中实现自动化基础设施配置与应用部署。

核心功能

1. 执行Ansible playbook，支持权限提升、主机限制等参数配置
2. 自动安装requirements.yml定义的Ansible Galaxy依赖包
3. 配置SSH私钥与Vault密码，实现目标主机访问与加密文件解密
4. 支持环境变量注入、Git全局配置及自定义前置命令
5. 提供调试模式与多级别日志输出选项

使用场景

• CI/CD流水线中的自动化部署与配置任务
• 基础设施即代码（IaC）的持续集成与验证
• 多环境（开发/测试/生产）的批量配置管理

配置说明

源配置（Source Configuration）

以下属性对应ansible-playbook命令选项，部分用于Git与SSH配置：

• debug：可选，布尔值，默认false，开启调试模式输出详细命令
• env：可选，环境变量列表，传递AWS密钥等外部配置
• git_global_config：可选，Git全局配置项列表
• git_https_username/password：可选，Git HTTP/S访问的凭据
• git_private_key：可选，Git SSH私钥
• git_skip_ssl_verification：可选，布尔值，默认false，跳过TLS证书验证
• user：可选，连接目标主机的用户名
• requirements：可选，默认requirements.yml，Galaxy依赖文件路径
• ssh_common_args：可选，传递给SSH的额外参数
• ssh_private_key：必填，连接目标主机的SSH私钥
• vault_password：可选，Ansible Vault解密密码
• verbose：可选，日志详细程度（如v、vv）

源配置示例

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

resources:
- name: ansible-resource
  type: ansible-playbook
  source:
    debug: false
    user: ubuntu
    ssh_private_key: ((ansible_ssh_key))
    vault_password: ((ansible_vault_pass))
    verbose: v

输出参数（Out Parameters）

执行playbook时的参数配置：

• become：可选，布尔值，默认false，开启权限提升
• become_user：可选，权限提升后的目标用户名
• check：可选，布尔值，默认false，仅检查不执行变更
• diff：可选，布尔值，默认false，显示文件变更差异
• inventory：必填，inventory文件路径（相对于path）
• limit：可选，限制执行的主机/组
• playbook：可选，默认site.yml，playbook文件路径
• skip_tags：可选，跳过的任务标签列表
• setup_commands：可选，执行playbook前的自定义命令列表
• tags：可选，仅执行的任务标签列表
• vars：可选，额外变量对象（与vars_file互斥）
• vars_file：可选，额外变量文件路径（与vars互斥）
• path：必填，playbook源文件所在目录路径

任务示例

yaml
jobs:
- name: provision-web
  plan:
  - get: code-repo # Git资源
  - put: ansible-resource
    params:
      check: true
      diff: true
      inventory: inventory/web-hosts.yml
      playbook: deploy.yml
      path: code-repo

许可证

MIT © Troy Kinsella