Skip to content

Latest commit

 

History

History
59 lines (40 loc) · 3.75 KB

CONTRIBUTING.md

File metadata and controls

59 lines (40 loc) · 3.75 KB
Raw

How to Contribute

We welcome contributions from the community. Here are a few ways you can help us improve.

Open an Issue

If you see something you'd like changed, but aren't sure how to change it, submit an issue describing what you'd like to see.

Working Locally

Python's pre-commit tool can be installed, and hooks installed, to cleanup whitespace, newlines, and run yamllint and ansible-lint against your local changes before committing. This will help you avoid failures in the github workflows.

  1. Create a local virtual environment for galaxy_configurations (suggested, its your system!)
  2. Use pip to install pre-commit in your environment of choice: pip install pre-commit
  3. Install pre-commit hooks with pre-commit install --install-hooks -c .github/workflow-config/.pre-commit-config.yml
  4. With hooks installed, they will be run automatically when you call git commit, blocking commit if any hooks fail.
  5. [Optional] If you want to ignore hook failures and commit anyway, use git commit -n
  6. [Optional] Run pre-commit checks at any time with pre-commit run --all -c .github/workflow-config/.pre-commit-config.yml.

Please see pre-commit documentation for further explanation: Pre-commit

Submit a Pull Request

If you feel like getting your hands dirty, feel free to make the change yourself. Here's how:

  1. Fork the repo on Github, and then clone it locally.
  2. Create a branch named appropriately for the change you are going to make.
  3. Make your code change.
  4. If you are creating a new role, please add a test for it in our testing playbooks. by adding a new role entry and adding the appropriate yaml file with test data in the eda_configs directory.
  5. Add a changelog fragment in changelogs/fragments as per https://docs.ansible.com/ansible/latest/community/development_process.html#changelogs
  6. Push your code change up to your forked repo.
  7. Open a Pull Request to merge your changes to this repo. The comment box will be filled in automatically via a template.
  8. All Pull Requests will be subject to Ansible and Yaml Linting checks. Please make sure that your code complies and fix any warnings that arise. These are checks that appear at the bottom of your Pull Request.
  9. All Pull requests are subject to Testing against being used in eda controller As above there is a check at the bottom of your pull request for this named integration.

See Using Pull Requests got more information on how to use GitHub PRs.

For an in depth guide on how to contribute see this article

Note that we follow the Automation Good Practices and so are you expected to do.

Try our Matrix room #aap_config_as_code:ansible.com.

For the full list of Ansible IRC and Mailing list, please see the [Ansible Communication] page. Release announcements will be made to the [Ansible Announce] list.

Possible security bugs should be reported via email to mailto:security@ansible.com.

Code of Conduct

As with all Ansible projects, we have a [Code of Conduct].

ansible announce ansible communication code of conduct creating your fork on github supported ansible versions