Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/roles-ansible/check-ansible-fedora-31-action
Github Action to check your ansible role or playbook with the fedora:31 docker image
https://github.com/roles-ansible/check-ansible-fedora-31-action
ansible check-ansible fedora github-action
Last synced: 2 days ago
JSON representation
Github Action to check your ansible role or playbook with the fedora:31 docker image
- Host: GitHub
- URL: https://github.com/roles-ansible/check-ansible-fedora-31-action
- Owner: roles-ansible
- License: mit
- Created: 2020-04-04T23:45:19.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2022-11-03T23:52:49.000Z (about 2 years ago)
- Last Synced: 2024-03-15T04:47:12.516Z (8 months ago)
- Topics: ansible, check-ansible, fedora, github-action
- Language: Shell
- Homepage: https://github.com/marketplace/actions/check-ansible-fedora-31
- Size: 137 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
[](https://github.com/marketplace/actions/check-ansible-fedora-31)
[](https://github.com/roles-ansible/check-ansible-fedora-31-action/blob/master/LICENSE)
Check Ansible Fedora 31
=======================
This action allows you to test your ansible role or your playbook in a Docker Container with ``fedora:31``.
## Usage
To use the action simply create an ``ansible-fedora-31.yml`` *(or choose custom ``*.yml`` name)* in the ``.github/workflows/`` directory.
For example:
```yaml
---
name: Ansible check fedora:31 # feel free to pick your own name
# yamllint disable-line rule:truthy
on: [push, pull_request]
jobs:
build:
runs-on: ubuntu-latest
steps:
# Important: This sets up your GITHUB_WORKSPACE environment variable
- name: checkout git repo
uses: actions/checkout@v3
- name: ansible check with fedora:31
# optionally replace "master" with any valid git ref
uses: roles-ansible/check-ansible-fedora-31-action@v1
with:
targets: "/github/workspace"
# [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'
#
# tags: ""
# [optional]
# If you want to limit the test to some tags, you can use this
# tags or the skiptags option. It will trigger the --tags $tags
# option to ansible.
#
# skiptags: ""
# [optional]
# See tags. This will trigger the --skip-tags $skiptags option
# to ansible.
```
Alternatively, you can run the ansible check only on certain branches:
```yaml
on:
push:
branches:
- stable
- release/v*
```
or on various [events](https://help.github.com/en/articles/events-that-trigger-workflows)
Limitations
-------------
The docker container unfortunately does not support a systemd environment. Therefore, it is currently not possible to test ansible roles that do anything in this direction.
If you have suggestions how to change this, they are welcome!
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](LICENSE).
Credits
--------------
+ The initial GitHub action has been created by [Stefan Stölzle](https://github.com/stoe) at
[stoe/actions](https://github.com/stoe/actions).
+ It was used by ansible for lint checks at [ansible/ansible-lint-action](https://github.com/ansible/ansible-lint-action.git)
+ It was modified from [L3D](https://github.com/do1jlr) to check ansible roles.