GitHub Molecule Actions容器

 !Docker Pulls !GitHub release (latest SemVer)

镜像概述和主要用途

该容器专为GitHub Molecule Actions设计，用于自动化测试Ansible角色和剧本。集成了一系列测试工具，提供标准化的测试环境，支持通过Molecule和tox实现自动化测试流程，确保Ansible代码的质量和兼容性。

核心功能和特性

容器包含以下关键工具：

• docker - 供Molecule使用docker驱动启动实例。
• git - 用于从代码仓库拉取数据。
• molecule 3.x.x版本 - 用于编排测试流程。
• tox - 若存在tox.ini，用于测试多个Ansible版本。
• flake8 - 模块化源代码检查工具。

默认行为

容器默认执行以下流程：

1. 检查是否存在tox.ini：
   • 若存在，则运行tox
   • 若不存在，则运行molecule test
2. 重试上述命令（tox或molecule）3次
3. 若未设置command，默认运行test
4. 若未设置scenario，默认测试default场景

使用场景和适用范围

• 自动化测试Ansible角色和剧本
• 在GitHub Actions中集成Molecule测试流程
• 支持多版本Ansible兼容性测试（通过tox）
• 代码质量检查（通过flake8）
• 本地测试Ansible代码（参考本地测试）

使用方法和配置说明

基本使用

容器默认行为可通过设置环境变量或命令参数调整：

• 设置命令：通过command参数指定要执行的命令（默认：test）
• 设置场景：通过scenario参数指定要测试的场景（默认：default）

示例

在GitHub Actions工作流中使用（参考GitHub Marketplace）：

yaml
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: buluma/molecule-action@v1
        with:
          command: test
          scenario: default

本地测试

如需本地测试容器功能，请参考本地测试文档。