Skip to content
ansible

GitHub Action

ansible-content-actions

v0.0.1 Pre-release

ansible-content-actions

ansible

ansible-content-actions

A set of GitHub actions for testing Ansible collections

Installation

Copy and paste the following snippet into your .yml file.

              

- name: ansible-content-actions

uses: ansible/ansible-content-actions@v0.0.1

Learn more about this action in ansible/ansible-content-actions

Choose a version

pre-commit

ansible-content-actions

Combine GitHub Actions to create a streamlined workflow for testing Ansible collection repositories on GitHub.

Usage

To use the action add the following step to your workflow file (e.g. ansible/ansible-content-actions/.github/workflows/sanity.yaml@main)

Filename: test.yaml

---
name: "CI"

concurrency:
  group: ${{ github.head_ref || github.run_id }}
  cancel-in-progress: true

on:
  pull_request:
    branches: [main]
  workflow_dispatch:
  schedule:
    - cron: '0 0 * * *'

jobs:
  changelog:
    uses: ansible/ansible-content-actions/.github/workflows/changelog.yaml@main
    if: github.event_name == 'pull_request'
  ansible-lint:
    uses: ansible/ansible-content-actions/.github/workflows/ansible_lint.yaml@main
  sanity:
    uses: ansible/ansible-content-actions/.github/workflows/sanity.yaml@main
  unit-galaxy:
    uses: ansible/ansible-content-actions/.github/workflows/unit.yaml@main
  integration:
    uses: ansible/ansible-content-actions/.github/workflows/integration.yaml@main
  all_green:
    if: ${{ always() }}
    needs:
      - changelog
      - sanity
      - integration
      - unit-galaxy
      - ansible-lint
    runs-on: ubuntu-latest
    steps:
      - run: >-
          python -c "assert 'failure' not in
          set([
          '${{ needs.changelog.result }}',
          '${{ needs.integration.result }}',
          '${{ needs.sanity.result }}',
          '${{ needs.unit-galaxy.result }}'
          '${{ needs.ansible-lint.result }}'
          ])"

Scope

This combined GitHub Action covers the following action workflows:

  • Ansible-lint - Checks playbooks for practices and behavior that could potentially be improved.
  • Sanity - Uses tox-ansible generates a testing matrix and runs sanity checks.
  • Unit - Installs the collection and all its dependencies from Galaxy and runs unit tests against a matrix generated via tox-ansible.
  • Integration - Installs the collection and all its dependencies from Galaxy and runs integration tests against a matrix generated via tox-ansible.
  • Changelog - Checks for a changelog entry with the PR, fails if missing or invalid.
  • Release - Push release to Automation Hub and Ansible Galaxy, requires (token/secrets).
  • Release Galaxy - Push a release to Ansible Galaxy only.
  • Release Automation Hub - Push a release to Ansible Automation Hub only.
  • Draft Release - Generates changelog entries for release, also raises a PR with changelog and galaxy file updated.
  • Check Label - Check if a valid label added to the PR is required by the release drafter.

Licensing

ansible-content-actions is released under the Apache License version 2.

See the LICENSE file for more details.