State 2 inventory

An easy way to generate your Ansible inventory from an infrastructure state.

Usage: state2inventory [OPTIONS] COMMAND [ARGS]...

  A CLI tool to generate an Ansible inventory from different infrastructure
  states.

Options:
  --version  Show the version and exit.
  --help     Show this message and exit.

Commands:
  multipass  Command to generate an Ansible inventory from a multipass...
  terraform  Command to generate an Ansible inventory from a terraform...

Multipass

Generate an Ansible inventory from a multipass state file (multipass list) and a configuration file.

Work in progress.

Terraform

Terraform provider, extract data for an Ansible inventory from the terraform command terraform show -json.

Usage

• Install state2inventory, see installation step bellow,
• Generate the file state by running terraform show -json > my_state.json

state2inventory terraform --state my_state.json --output inventory.txt

[^1] All in lower cases, special characters replaced by _, prefix by _ if group begins with a numeric character

Terraform provider options

You can customize the data you want to extract from the state JSON terraform file with the --key option:

Example: --key {"type": "openstack_compute_instance_v2", "ip": "access_ip_v4" }

Some resource type value:

Terraform metadata

The Terraform optional list key/value metadata stores the host groups and the Ansible host variables in the inventory. The key host_groups key has as value the list of groups of the host separated by a semicolon ;. The key host_vars key has as value the list of connection variables of the host separated by a semicolon ;.

Example:

host_groups = "public;bastion;core"
host_vars = "ansible_user=ubuntu;ansible_python_interpreter=/usr/bin/python3"

Terraform provider generation example

resource "openstack_compute_instance_v2" "bastion" {
  name = "bastion01"
  ...
  metadata = {
    host_groups = "public;bastion;core"
    host_vars = "ansible_user=ubuntu;ansible_python_interpreter=/usr/bin/python3"
  }
  ...
}

generates

bastion01 ansible_host=192.168.0.156 ansible_user=ubuntu ansible_python_interpreter=/usr/bin/python3

[public]
bastion01

[bastion]
bastion01

[core]
bastion01

Installation

With Python environment

To use:

• Minimal Python version: 3.10

Installation with Python pip:

python3 -m pip install state2inventory
state2inventory --help

With Docker

Images containing state2inventory:

• jfxs/terraform-inventory
• jfxs/ansible

docker run -it --rm -v $(pwd):/data jfxs/terraform-inventory terraform --state /data/my_state.json --output /data/inventory.txt

Authors

• FX Soubirou - Initial work - GitLab repositories

License

This program is free software: you can redistribute it and/or modify it under the terms of the MIT License (MIT). See the LICENSE for details.