Skip to content

Github Action to check your ansible role or playbook with the ubuntu:bionic docker image

License

Notifications You must be signed in to change notification settings

roles-ansible/check-ansible-ubuntu-bionic-action

Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

69 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Github Marketplace MIT License

Check Ansible Ubuntu bionic

This action allows you to test your ansible role or your playbook in a Docker Container with ubuntu:bionic.

Usage

To use the action simply create an ansible-ubuntu-bionic.yml (or choose custom *.yml name) in the .github/workflows/ directory.

For example:

name: Ansible check ubuntu:bionic  # feel free to pick your own name

on: [push, pull_request]

jobs:
  build:

    runs-on: ubuntu-latest

    steps:
    # Important: This sets up your GITHUB_WORKSPACE environment variable
    - uses: actions/checkout@v2

    - name: ansible check with ubuntu:bionic
      # replace "master" with any valid ref
      uses: roles-ansible/check-ansible-ubuntu-bionic-action@master
      with:
        targets: "./"
        #  [required]
        #   Paths to your ansible role or playboox.yml you want to test
        #   Some Examples:
        #   targets: "role/my_role/"
        #   targets: "site.yml"
        #
        # group: ""
        #  [optional]
        #   When testing playbooks you have to tell ansible
        #   the group you that we write in our hosts file.
        #   example:
        #   group: 'servers'
        #
        # hosts: ""
        #  [optional]
        #   When testing playbooks you have to give one example
        #   host this action should use to test your playbook.
        #   > We only spawn one docker container that mean
        #   > we can only test one host at the time. Sorry
        #   some examples:
        #   hosts: 'localhost'
        #   hosts: 'srv01.example.com'
        #
        # requirements: ""
        #  [optional]
        #   When testing playbooks and you are using ansible galaxy,
        #   you may be interested in installing your requirements
        #   from ansible galaxy.
        #   To do this please provide us either the role name directly
        #   requirements: 'do1jlr.ansible_version'
        #   or your requiements.yml file.
        #   requirements: 'requirements.yml'

Alternatively, you can run the ansible check only on certain branches:

on:
  push:
    branches:
    - stable
    - master
    - release/v*

or on various events


Contributing

If you are missing a feature or see a bug. Please report it. Or - if you like - open a pull-request.

License

The Dockerfile and associated scripts and documentation in this project are released under the MIT License.

Credits

The initial GitHub action has been created by Stefan Stölzle at stoe/actions.
It was used by ansible for lint checks at ansible/ansible-lint-action
It was modified from L3D to check ansible roles and playbooks.