4c42d0971f
* suppress exceptions for optional env variables * Options handling switched to "get_option" approach * Put back _raw option for documentation purposes * Fix url option description * remove ini section * Docs fixed * force rebuild to fix aix tests * Point returned in order to have full sentence in description * Add general arguments fix information to changelog fragments * Add PR link to changelog fragments Co-authored-by: Felix Fontein <felix@fontein.de> * Fix port/scheme handlng in case they weren't provided in URL argument * Add argument type for url Co-authored-by: Felix Fontein <felix@fontein.de> Co-authored-by: Denis Savenko <denis.savenko@tonicforhealth.com> Co-authored-by: Felix Fontein <felix@fontein.de> |
||
---|---|---|
.github | ||
changelogs | ||
meta | ||
plugins | ||
scripts | ||
tests | ||
.gitignore | ||
CHANGELOG.rst | ||
COPYING | ||
galaxy.yml | ||
README.md | ||
shippable.yml |
Ansible Collection: community.general
This repo contains the community.general
Ansible Collection.
The collection includes the modules and plugins supported by Ansible community.
Installation and Usage
Installing the Collection from Ansible Galaxy
Before using the General community collection, you need to install the collection with the ansible-galaxy
CLI:
ansible-galaxy collection install community.general
You can also include it in a requirements.yml
file and install it via ansible-galaxy collection install -r requirements.yml
using the format:
collections:
- name: community.general
Testing and Development
If you want to develop new content for this collection or improve what is already here, the easiest way to work on the collection is to clone it into one of the configured COLLECTIONS_PATHS
, and work on it there.
You can find more information in the developer guide for collections
Testing with ansible-test
See here.
Release notes
See here.
Publishing New Version
Basic instructions without release branches:
- Create
changelogs/fragments/<version>.yml
withrelease_summary:
section (which must be a string, not a list). - Run
antsibull-changelog release --collection-flatmap yes
- Make sure
CHANGELOG.rst
andchangelogs/changelog.yaml
are added to git, and the deleted fragments have been removed. - Tag the commit with
<version>
. Push changes and tag to the main repository.
More Information
TBD
Communication
We have a dedicated Working Group for Ansible development.
You can find other people interested on the following Freenode IRC channels -
#ansible
- For general use questions and support.#ansible-devel
- For discussions on developer topics and code related to features or bugs.#ansible-community
- For discussions on community topics and community meetings.
For more information about communities, meetings and agendas see Community Wiki.
For more information about communication
License
GNU General Public License v3.0 or later
See LICENSE to see the full text.