This repository is hosted on gitlab.com and has a read-only copy hosted on github.com.
links:
NOTE: this repository is undr going a restructure. the existing roles are intended to move to their own repo, if they're still useful. This repository will be restructured to have each of No Fuss Computings Roles included in the root of this repo as submodules. this is being done, so there is one location with all of our roles that can easily be included in other projects.
README - Pre-Restructure
This repository contains ansible roles. Within each role directory, you will find a readme that explains the role in question.
Each of the roles are designed in a way that they can be used as dependencies for your own roles. They are also designed to run them over and over so that you can determine if anything has changed.
It is possible to use tags for our roles. This will enable you to do a staging prior to a deployment. The available tags are as follows:
-
preparetasks that require work, doesn't make any changes. example: build docker image, pull docker image -
configureadd any configuration files, users, groups etc. Does make changes -
installinstall the feature of the role -
removeuninstall the feature of the role. Does not remove items added by the role -
cleanremoves all items added by the role.
master: Considered stable. Every merge request creates a release.
development: Considered unstable (might change). any releases on this branch are release-candidates, prefixed as rc*.
| we use semantic versioning. Any change we make that will break an existing setup, we increase the major number within the version. i.e. 1.0.0 -> 2.0.0 |
As this forms part of your configuration management, it is intended that you would add this repository to your ansible root folder, with an update to your ansible.cfg (roles=./roles:./ansible-roles/roles), you can use our roles alongside your roles.
If your ansible roles are not part of a git repository (why?) you can just clone this repo to the root directory of your ansible roles and update ansible.cfg.
For those who have thier ansible roles directory as part of a git repo, it is suggested to add this repository as a sub module. Using this option enables your git history to track what commit of our repository you are using. We encourage keeping the sub-module updated to a git tag for stability.
To utilise our role create your own role, and include our role as a dependency. As our roles will require you to configure them to suit your environment. For example, create a role {rolename}_configuration then include {rolename} as a dependency of the created role.
The master changelog is available in the repo. Every time we create a release including for alpha releases, the changelog is updated.
All contributions for this project must conducted from Gitlab.
For further details on contributing please refer to the contribution guide.
This repo is release under this license