Skip to content

lean-delivery/ansible-development-kit

Repository files navigation

ansible-development-kit

License Build Status Build Status

How to use:

pip install cookiecutter

Create a new role

or

Enter for the role name question a value without the ansible-role- prefix, e.g. example.

Make changes in the corresponding files: copyright section in LICENSE, badge section in README.md (you can get galaxy's role id by running: ansible-galaxy info lean_delivery.example |grep '\bid'), etc.

Update an existing role

  1. cd ansible-role-example
  2. cookiecutter https://github.com/lean-delivery/ansible-development-kit --output-dir .. --overwrite-if-exists
  3. git status
  4. git add . -p
Useful commands:
- y - add this hunk to commit
- n - do not add this hunk to commit
- d - do not add this hunk or any of the later hunks in this file
- s - split the current hunk into smaller hunks
- e - manually edit the hunk
  1. git commit -m "Updated by cookiecutter and ansible-development-kit"

In order not to provide the same answers for cookecutter's questions it makes sense to put in the role's directory a config file .cookiecutter.yml like this:

---
default_context:
  role_name: example

To switch betweens Linux and Windows molecule tests add this variables to .cookiecutter.yml:

---
default_context:
  role_name: example
  linux_tests: "true"
  windows_tests: "false"

To increase root volume size for Linux and Windows platforms in AWS add this variables to .cookiecutter.yml:

---
default_context:
  role_name: example
  customize_vol_size_linux: "true"
  volume_size_linux: 10
  customize_vol_size_windows: "true"
  volume_size_windows: 32

and run cookiecutter the following way:

cookiecutter https://github.com/lean-delivery/ansible-development-kit --output-dir .. --overwrite-if-exists --config-file .cookiecutter.yml --no-input