avdteam/action-molecule

GitHub Action for Molecule

镜像概述和主要用途

该GitHub Action允许使用Ansible集合结构运行Molecule，用于AVD（Arista Validated Design）代码验证。此外，支持在Molecule执行后检查Git状态，以跟踪意外文件变更，且可强制执行变更检查并在检测到变更时生成失败结果。

核心功能和特性

• 支持Molecule命令执行，包括check、cleanup、converge等多种操作
• 提供Molecule运行选项配置，如调试模式、基础配置文件、环境变量文件等
• 支持指定场景、驱动程序或执行所有场景
• 可安装自定义Python依赖（通过pip文件）和Ansible Galaxy依赖
• 支持指定Ansible版本
• 执行后检查Git状态，跟踪意外文件变更
• 可强制执行Git状态检查，变更时返回失败

输入参数（Inputs）

使用场景和适用范围

适用于在GitHub Actions工作流中对AVD项目进行Molecule测试，确保Ansible角色/集合的质量和一致性，尤其适合需要自动化验证代码变更的CI/CD流程。

使用方法和配置说明

GitHub Actions工作流配置示例

在仓库的.github/workflows/目录下创建main.yml（或自定义名称）：

yaml
on: push

jobs:
  molecule:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v2

      - name: Run molecule action
        uses: arista-netdevops-community/action-molecule-avd@v1.0
        with:
          molecule_parentdir: 'ansible_collections/arista/cvp'
          molecule_command: 'test'
          molecule_args: '--all'
          ansible: ansible>=2.10
          pip_file: 'requirements.txt'
          check_git: true
          check_git_enforced: false

本地测试

1. 创建环境变量文件（如test.env）：

shell
# cat test.env
INPUT_PIP_FILE=requirements.txt
INPUT_MOLECULE_PARENTDIR=/root/ansible_collections/arista/cvp
INPUT_MOLECULE_COMMAND=test
INPUT_MOLECULE_ARGS=--all

2. 运行Docker容器：

shell
docker run --rm -it \
    -v ${PWD}:/root/ \                              # 本地内容与容器共享
    -v /var/run/docker.sock:/var/run/docker.sock \  # Molecule需要的Docker进程
    --env-file dev.env \                            # 包含变量的文件
    avdteam/action-molecule:v1.0