https://github.com/archf/ansible-common
Ansible meta role to perform basic configuration.
https://github.com/archf/ansible-common
ansible
Last synced: 12 months ago
JSON representation
Ansible meta role to perform basic configuration.
- Host: GitHub
- URL: https://github.com/archf/ansible-common
- Owner: archf
- Created: 2016-03-17T00:25:43.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2018-04-19T20:36:25.000Z (about 8 years ago)
- Last Synced: 2025-03-18T14:49:05.038Z (over 1 year ago)
- Topics: ansible
- Size: 5.86 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# ansible-common
A meta role to perform basic configuration.
## Ansible requirements
### Ansible version
Minimum required ansible version is 2.2.
### Ansible role dependencies
* packages
* openssh-server
* accounts
* ntpd
## Installation
### Install with Ansible Galaxy
```shell
ansible-galaxy install archf.common
```
Basic usage is:
```yaml
- hosts: all
roles:
- role: archf.common
```
### Install with git
If you do not want a global installation, clone it into your `roles_path`.
```shell
git clone git@github.com:archf/ansible-common.git /path/to/roles_path
```
But I often add it as a submdule in a given `playbook_dir` repository.
```shell
git submodule add git@github.com:archf/ansible-common.git /roles/common
```
As the role is not managed by Ansible Galaxy, you do not have to specify the
github user account.
Basic usage is:
```yaml
- hosts: all
roles:
- role: common
```
## User guide
This is a meta role to perform basic configuration. It contains no tasks and
its sole purpose is to tie together the roles listed as dependencies below.
## License
MIT.
## Author Information
Felix Archambault.
---
Please do not edit this file. This role `README.md` was generated using the
'ansidoc' python tool available on pypi!
*Installation:*
```shell
pip3 install ansidoc
```
*Basic usage:*
Validate output by running a dry-run (will output result to stdout)
```shell
ansidoc --dry-run
```
Generate you role readme file. Will write a `README.md` file under
`/README.md`.
```shell
ansidoc
```
Also usable programatically from Sphinx.