cmdbsyncer-inventory 0.1.0

Ansible Inventory Plugin for CMDBSyncer

CMDBSyncer Inventory Plugin

An Ansible dynamic inventory plugin that fetches host and group information from CMDBSyncer.

Installation

Via pip (Recommended)

pip install cmdbsyncer-inventory

Via pip from source

pip install git+https://github.com/kuhn-ruess/cmdbsyncer-inventory.git

Usage

After installation, the plugin is automatically available to Ansible. You just need to:

1. Create an inventory configuration file (e.g., inventory.yml):

plugin: cmdbsyncer_inventory
api_url: https://your-cmdbsyncer-instance.com
username: your_username  # Optional if using environment variables
password: your_password  # Optional if using environment variables

2. Set environment variables (recommended for credentials):

export CMDBSYNCER_APIUSER="your_username"
export CMDBSYNCER_APIPASSWORD="your_password"

3. Configure ansible.cfg (optional, for broader plugin availability):

[defaults]
# Optional: specify additional paths if needed

[inventory]
# Enable the plugin (ansible-core 2.12+ auto-enables installed plugins)
enable_plugins = host_list, script, auto, yaml, ini, toml, cmdbsyncer_inventory

4. Use with ansible commands:

# Test the inventory
ansible-inventory -i inventory.yml --list

# Run playbooks
ansible-playbook -i inventory.yml your-playbook.yml

Configuration Options

Option	Required	Type	Description
plugin	Yes	string	Must be cmdbsyncer_inventory
api_url	Yes	string	URL to your CMDBSyncer instance
username	No	string	API username (can use CMDBSYNCER_APIUSER env var)
password	No	string	API password (can use CMDBSYNCER_APIPASSWORD env var)

Example Output

The plugin will create Ansible inventory with hosts and groups based on your CMDBSyncer configuration. Example structure:

{
  "_meta": {
    "hostvars": {
      "server1.example.com": {
        "ansible_host": "10.0.0.1",
        "ansible_user": "admin",
        "environment": "production"
      }
    }
  },
  "production": {
    "hosts": ["server1.example.com"]
  },
  "web": {
    "hosts": ["server1.example.com"]  
  }
}

Requirements

• Python 3.7+
• Ansible Core 2.12+
• CMDBSyncer instance with API access

Development

Local Development Setup

# Clone the repository
git clone https://github.com/kuhn-ruess/cmdbsyncer-inventory.git
cd cmdbsyncer-inventory

# Install in development mode
pip install -e .

# Test the plugin
ansible-inventory -i example-inventory.yml --list

Building for PyPI

# Install build tools
pip install build twine

# Build package
python -m build

# Upload to PyPI (requires credentials)
twine upload dist/*

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

• � Email: [e-mail]
• �🐛 Issues: GitHub Issues
• 📖 Documentation: Wiki