Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/iautom8things/ansible-meta-dynamic-inventory
Naming is hard. This wrapper script allows you to use set notation with dynamic host groups.
https://github.com/iautom8things/ansible-meta-dynamic-inventory
ansible ansible-inventory aws devops devops-tools dynamic-inventory
Last synced: about 1 month ago
JSON representation
Naming is hard. This wrapper script allows you to use set notation with dynamic host groups.
- Host: GitHub
- URL: https://github.com/iautom8things/ansible-meta-dynamic-inventory
- Owner: iautom8things
- License: mit
- Archived: true
- Created: 2016-09-09T10:53:26.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2017-07-23T01:32:12.000Z (about 7 years ago)
- Last Synced: 2024-05-15T12:47:03.334Z (4 months ago)
- Topics: ansible, ansible-inventory, aws, devops, devops-tools, dynamic-inventory
- Language: Python
- Size: 9.77 KB
- Stars: 23
- Watchers: 5
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ansible-meta-dynamic-inventory
This script takes, as input, the output of a dynamic inventory script and reads in another file, called a Groupsfile, that allows the creation of new groups using any of Ansible's Pattern set notations, and then outputs an updated version of the dynamic inventory that it received.
## Who does this help?
Anyone that extensively uses Ansible Patterns.
## What does this give you?
1. The ability to effectively alias your patterns, by creating new groups from your patterns.
2. The ability to define _group_vars_ for your patterned groups.
3. A single source for defining your patterned groups.
4. More reusable playbooks.
## Dependancies
- Python (developed against 2.7.12)
- Parsley v1.3 [[link]](https://pypi.python.org/pypi/Parsley)
## Introduction
Ansible has a concept of _Inventory_, this is your listing/groupings of all of the machines in your infrastructure. Ansible allows for two types of inventories: _static_ and _dynamic_.
Here is an example of a simple static inventory:
```
[web]
10.0.1.2
10.0.1.3
[db]
10.2.0.2
10.2.0.3
[aws_us_east]
[aws_us_east:children]
web
db
```
This static inventory file describes two groups (`web`,`db`) with two hosts each, and a third group (`aws_us_east`) that is the union of web and db. Static inventory works great if you have very few machines that never change, and it becomes virtually useless with the more hosts you have or the more _dynamic_ your inventory is.
### Dynamic inventory to the rescue!
Dynamic inventory is an executable script that inspects your infrastructure and dynamically creates groups out of them. If you're on AWS and using Ansible, then you're likely familiar with `ec2.py` [[link]](https://raw.githubusercontent.com/ansible/ansible/stable-1.9/plugins/inventory/ec2.py), a Python script that uses your AWS credentials to inspect EC2 and dynamically create groups based on VPCs, security groups, tags and much more.
### Ansible Patterns
Ansible also has this great feature that allows you to use set functions like union, intersection and difference on your host groups, called Patterns [[link]](http://docs.ansible.com/ansible/intro_patterns.html). This allows for you to home in on _just the right_ group of hosts to operate on.
#### Examples:
- Union *(All API and WEB nodes)*
tag_Product_api:tag_Product_web
- Intersection *(Production API nodes)*
tag_Product_api:&tag_Env_prod
- Difference *(Non-API nodes)*
tag_Product_api:!tag_Env_prod
- Slicing *(The first two nodes with tag Product=api)*
tag_Product_api[0:2]
*See the Ansible documentation for a complete list of possible patterns.*
### The Rub
Ansible Patterns are limited to being used on the command line:
```
$ ansible tag_Env_prod:&tag_Service_web -m service -a "name=httpd state=restarted"
```
Or they can be used as the host specifier for a play:
```
---
- name: Install SomeService Role
hosts: tag_Env_stg:!tag_Service_elk
become: yes
roles:
- SomeService
```
This means that you _cannot_ use patterns in a static inventory file. So the following **does not work**:
```
[web]
5.5.5.5
10.10.10.10
[prod]
10.10.10.10
[web_prod]
[web_prod:children]
web:&prod
```
This static inventory file attempts to create a `web_prod` group that only consists of machines in _both_ `web` && `prod`.