Skip to content
This repository has been archived by the owner on May 12, 2023. It is now read-only.
/ playbook Public archive

Example playbook for the ANTS framework. Roles can be installed from ansible galaxy.

License

Notifications You must be signed in to change notification settings

ANTS-Framework/playbook

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Playbook

Generic playbook for the ANTS framework. Roles can be installed from ansible galaxy

Great, what do I do with this?

Install ANTS if you haven't already and go through the first steps.

Once you're done, duplicate the repository (you might want to make it private later on) and update your host configuration to point to it.

Edit main.yml.

Have fun.

How do I make my own playbook?

The ANTS playbook is a git repository structured according to the ansible playbook best practices. You can duplicate it or you can create your own git repo.

Installing roles

You can add roles using ansible-galaxy or write your own. We included a roles.yml in your playbook so you can add roles besides the generic_motd already present.

ansible-galaxy install -r roles.yml --roles-path roles/

Update Roles

When roles get updated in ansible galaxy, you might want to update them in your playbook as well. We recommend adding all your roles to roles.yml.

By adding roles to your ansible_roles.yml file, you can pull the latest version of any role using the following command:

# Notice the -f flag
ansible-galaxy install -r roles.yml -f --roles-path roles/

This will pull the latest version of all roles, that are listed in this file. All our roles in the master branch are stable, but you might want to do this in a testing branch to see how the changes behave in your environment.

You also might want to check out individual roles by tags or branches or to write your own roles.yml file. For more information on the file syntax, have a look at the official docs by ansible.

What is this version file?

It is a file containing the version of your playbook as a single string. E.g.: v1.0

The version file is used to determine which version of your policies is run on which host. This helps in detecting problems early on when a host has difficulties connecting to your git repo or when a host is moved to a different branch with a different version by accident.

The ants client has a -p option that will print the content of the version file or v0.0 if no file has been found.

About

Example playbook for the ANTS framework. Roles can be installed from ansible galaxy.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published