Skip to content

NoFussComputing/ansible-roles

Repository files navigation

No Fuss Computing Ansible Roles

Project Status - Active

Gitlab build status - stable Gitlab build status - development Open Issues

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:

  • prepare tasks that require work, doesn't make any changes. example: build docker image, pull docker image

  • configure add any configuration files, users, groups etc. Does make changes

  • install install the feature of the role

  • remove uninstall the feature of the role. Does not remove items added by the role

  • clean removes all items added by the role.

Branches

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*.

⁉️ Release Versioning
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

Using our Ansible roles

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.



Changelog

The master changelog is available in the repo. Every time we create a release including for alpha releases, the changelog is updated.

Contributing

All contributions for this project must conducted from Gitlab.

For further details on contributing please refer to the contribution guide.

Other

This repo is release under this license