Event Driven Ansible Controller

This repository contains the source code for the Event Driven Ansible Controller, aka EDA-Controller.

Licensed under Apache Software License 2.0

How to install

Refer to the deployment guide for further information if you want to install and run the application.

Development environment

Refer to the development guide for further information if you want to setup a development environment.

Contributing

We ask all of our community members and contributors to adhere to the Ansible code of conduct. If you have questions or need assistance, please reach out to our community team at codeofconduct@ansible.com

Refer to the Contributing guide for further information.

Communication

See the Communication section of the Contributing guide to find out how to get help and contact us.

For more information about getting in touch, see the Ansible communication guide.

OpenAPI specification

For a comprehensive guide (runtime, development, authentication, code samples, troubleshooting), see docs/openapi-access.md.

You can access the Event Driven Ansible OpenAPI specification from a running instance:

• API docs (browser):
  • http://$HOST:$PORT/api/eda/v1/docs/
• OpenAPI JSON:
  • http://$HOST:$PORT/api/eda/v1/openapi.json Download examples:

# Basic auth (JSON)
curl -u admin:password \
  "http://localhost:8000/api/eda/v1/openapi.json" -o eda.json

# Token auth (JSON)
curl -H "Authorization: Bearer $TOKEN" \
  "http://localhost:8000/api/eda/v1/openapi.json" -o eda.json

Notes:

• Endpoints may require authentication depending on your deployment.
• For HTTPS with self-signed certificates, add -k to curl for local testing.
• The specification's info.version reflects the installed aap-eda package version on the running instance, from pyproject.toml.

Credits

EDA-Controller is sponsored by Red Hat, Inc.