monolithprojects/github-action-molecule

Molecule GitHub Action

用于Molecule（docker驱动）的GitHub Action Docker镜像，可测试Ansible角色及Ansible-playbook参数。该GitHub Action基于Alpine Linux 3.12构建，采用多阶段构建，体积小巧。

输入参数

yaml
  molecule_command:
    description: |
      Molecule命令：
        check        使用provisioner执行预演（Dry-Run）。
        cleanup      使用provisioner清理变更。
        converge     使用provisioner配置实例。
        create       使用provisioner启动实例。
        dependency   管理角色依赖。
        destroy      使用provisioner销毁实例。
        drivers      列出驱动。
        idempotence  使用provisioner测试幂等性。
        init         初始化新角色或场景。
        lint         对角色进行 lint 检查。
        list         列出实例状态。
        login        登录到某个实例。
        matrix       列出用于测试实例的步骤矩阵。
        prepare      使用provisioner准备实例。
        reset        重置molecule临时文件夹。
        side-effect  使用provisioner对实例执行副作用操作。
        syntax       使用provisioner对角色进行语法检查。
        test         测试周期。
        verify       对实例运行自动化测试。
    required: true
    default: 'test'
  converge_extra_args:
    description: |
      使用ansible-playbook参数运行molecule converge（例如：molecule converge -- --tags foo,bar --extra_vars "my_var=true"）。
    required: false
  scenario:
    description: |
      运行特定的Molecule场景
    required: false

使用方法

要使用该Action，只需在.github/workflows/目录中创建一个yaml文件。请参见以下示例。

基本示例

在这种情况下，GitHub Action将运行molecule test：

yaml
on: push

jobs:
  molecule:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
        with:
          path: "${{ github.repository }}"
      - name: Molecule
        uses: monolithprojects/action-molecule@v1.4.1

Ansible-playbook参数

在这种情况下，GitHub Action将运行molecule converge -s special_scenario -- --tags foo,bar --extra_vars "my_var=true"：

yaml
on: push

jobs:
  molecule:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
        with:
          path: "${{ github.repository }}"
      - name: Molecule
        uses: monolithprojects/action-molecule@v1.4.1
        with:
          molecule_command: converge
          scenario: special_scenario
          converge_extra_args: --tags foo,bar --extra_vars "my_var=true"

镜像和标签矩阵

yaml
on: push

jobs:
  molecule:
    runs-on: ubuntu-latest
    strategy:
      fail-fast: false
      matrix:
        config:
          - os: "centos8"
            tag: "latest"
          - os: "ubuntu20"
            tag: "latest"
    steps:
      - uses: actions/checkout@v2
        with:
          path: "${{ github.repository }}"
      - name: Molecule
        uses: MonolithProjects/action-molecule@v1.4.1
        with:
          os: ${{ matrix.config.os }}
          tag: ${{ matrix.config.tag }}