diff --git a/.config/dictionary.txt b/.config/dictionary.txt
index ce6203b0..826c7b92 100644
--- a/.config/dictionary.txt
+++ b/.config/dictionary.txt
@@ -1,9 +1,23 @@
-CAcreateserial
-Djava
+ARGSPEC
+AUTHS
+Abhijeet
+Alina
+Buzachis
+EDAHTTP
+FQCN
GSSAPI
+Kasurde
+Nikhil
OAUTHBEARER
PYTHONUNBUFFERED
+Passw
+akasurde
alertmanager
+alinabuzachis
+antsibull
+auths
basepython
benthomasosn
bindep
@@ -11,6 +25,7 @@ buildx
cafile
capath
caroot
+cliconf
confluentinc
conninfo
containerd
@@ -21,19 +36,25 @@ dynatrace
envlist
extfile
finito
+hdrs
healthcheck
+httpapi
jaas
+jainnikhil
+keygen
keypass
keytool
libsystemd
mydb
myqueue
nada
+netconf
noprompt
parseable
posargs
pythonmain
realworld
+refspec
rulebook
rulebooks
ruleset
@@ -42,24 +63,8 @@ skipsdist
snakeoil
storepass
testenv
+testsecret
+testuser
toxinidir
trustore
truststore
-ARGSPEC
-Nikhil
-jainnikhil
-Abhijeet
-Kasurde
-akasurde
-auths
-Passw
-AUTHS
-EDAHTTP
-refspec
-Alina
-Buzachis
-alinabuzachis
-hdrs
-testuser
-testsecret
-keygen
diff --git a/.github/workflows/tox.yml b/.github/workflows/tox.yml
index 2f08ecfb..1b9bd36d 100644
--- a/.github/workflows/tox.yml
+++ b/.github/workflows/tox.yml
@@ -41,7 +41,7 @@ jobs:
# can be different. Each of them is testing with all supported
# python versions, regardless the tox pyXY name.
other_names: |
- lint-sanity:tox -e lint;tox -e py39-sanity-ansible2.15;tox -e py310-sanity-ansible2.16;tox -e py311-sanity-ansible2.17
+ lint-docs-sanity:tox -e lint;tox -e docs;tox -e py39-sanity-ansible2.15;tox -e py310-sanity-ansible2.16;tox -e py311-sanity-ansible2.17
py39:tox -e py39-unit;tox -e py39-integration;tox -e coverage
py310:tox -e py310-unit; tox -e py310-integration;tox -e coverage
py311:tox -e py311-unit; tox -e py311-integration;tox -e coverage
@@ -57,6 +57,7 @@ jobs:
runs-on: ${{ matrix.os || 'ubuntu-24.04' }}
continue-on-error: ${{ contains(matrix.name, 'integration') && true || false }}
needs:
+ - docs
- prepare
defaults:
run:
@@ -130,6 +131,9 @@ jobs:
- run: ${{ matrix.command4 }}
if: ${{ matrix.command4 }}
+ - run: ${{ matrix.command5 }}
+ if: ${{ matrix.command5 }}
+
- name: Archive logs
uses: actions/upload-artifact@v4
with:
@@ -150,6 +154,15 @@ jobs:
exit 99
fi
# https://github.com/actions/toolkit/issues/193
+ docs:
+ permissions:
+ contents: read
+ name: Validate Ansible Docs
+ uses: ansible-community/github-docs-build/.github/workflows/_shared-docs-build-pr.yml@main
+ with:
+ collection-name: ansible.eda
+ init-lenient: false
+ init-fail-on-error: true
check:
if: always()
environment: check
diff --git a/.gitignore b/.gitignore
index c92c5ef4..88823055 100644
--- a/.gitignore
+++ b/.gitignore
@@ -24,3 +24,7 @@ tests/integration/event_source_kafka/*.jks
# Coverage
.coverage*
*coverage.combined
+# docs/requirements.txt
+docs/build.sh
+docs/antsibull-docs.cfg
+docs/conf.py
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 4e57abdb..a88124a3 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -11,7 +11,11 @@ ci:
- ansible-test-sanity # requires network access
- shellcheck # no docker
- tox # requires network access
-exclude: "^.*\\.md$"
+exclude: >
+ (?x)^(
+ docs/rst/.*.rst$|
+ test/fixtures/formatting-before/.*
+ )$
repos:
- repo: https://github.com/pre-commit/pre-commit-hooks
rev: v4.6.0
diff --git a/.readthedocs.yaml b/.readthedocs.yaml
new file mode 100644
index 00000000..aa38a26d
--- /dev/null
+++ b/.readthedocs.yaml
@@ -0,0 +1,27 @@
+# .readthedocs.yaml
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
+version: 2
+
+# Set the OS, Python version and other tools you might need
+build:
+ os: ubuntu-24.04
+ tools:
+ python: "3.12"
+ # When using commands we canon install apt_package due to
+ # https://github.com/readthedocs/readthedocs.org/issues/11219
+ # https://github.com/readthedocs/readthedocs.org/issues/9599
+ # apt_packages:
+ # - rsync
+ commands:
+ - echo $PATH
+ - curl -o /tmp/rsync.tar.gz https://download.samba.org/pub/rsync/binaries/ubuntu-22.04-x86_64/rsync-3.2.7.tar.gz
+ - tar -xzf /tmp/rsync.tar.gz -C /tmp
+ # Copy executable in the first directory in path, which happens to be writable on RTD
+ - cp /tmp/usr/local/bin/rsync ${PATH%%:*}/
+ - type rsync
+ - pip install --user tox
+ - python3 -m tox -e docs
+ - ln -s docs/build/html . $READTHEDOCS_OUTPUT/html/
diff --git a/bindep.txt b/bindep.txt
index 86a01e48..8e707ff7 100644
--- a/bindep.txt
+++ b/bindep.txt
@@ -3,6 +3,9 @@ libsystemd0 [test platform:debian]
libsystemd-dev [test platform:debian]
pkg-config [test platform:debian]
+# docs
+rsync [test platform:debian]
+
# For sanity testing to pass we need all supported Python versions installed:
python3.9-dev [test platform:ubuntu-noble]
python3.9-venv [test platform:ubuntu-noble]
diff --git a/demos/dynatrace-demo/instructions.md b/demos/dynatrace-demo/instructions.md
index e04d3b70..02db8674 100644
--- a/demos/dynatrace-demo/instructions.md
+++ b/demos/dynatrace-demo/instructions.md
@@ -10,7 +10,7 @@ rulebook CLI runs a remedy playbook to restart the process.
### Nodes or instances
* Rulebook Node: The node where the ansible-rulebook CLI is running
* Client Node: The node where the monitored process is running
-* Dynatrace Console: An active Dyntrace tenant and its web console
+* Dynatrace Console: An active Dynatrace tenant and its web console
### Set up client node
1. Prepare a VM with host name called `lamp`
diff --git a/docs/.gitignore b/docs/.gitignore
new file mode 100644
index 00000000..b143a48a
--- /dev/null
+++ b/docs/.gitignore
@@ -0,0 +1,8 @@
+# Copyright (c) Ansible Project
+# GNU General Public License v3.0+ (see LICENSES/GPL-3.0-or-later.txt or https://www.gnu.org/licenses/gpl-3.0.txt)
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+# Created with antsibull-docs 2.12.0
+
+/temp-rst
+/build
diff --git a/docs/requirements.txt b/docs/requirements.txt
new file mode 100644
index 00000000..7bf076c5
--- /dev/null
+++ b/docs/requirements.txt
@@ -0,0 +1,10 @@
+# Copyright (c) Ansible Project
+# GNU General Public License v3.0+ (see LICENSES/GPL-3.0-or-later.txt or https://www.gnu.org/licenses/gpl-3.0.txt)
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+# Created with antsibull-docs 2.12.0
+
+antsibull-docs >= 2.0.0, < 3.0.0
+ansible-pygments
+sphinx
+sphinx-ansible-theme >= 0.9.0
diff --git a/docs/rst/activation_info_module.rst b/docs/rst/activation_info_module.rst
new file mode 100644
index 00000000..95f4908e
--- /dev/null
+++ b/docs/rst/activation_info_module.rst
@@ -0,0 +1,452 @@
+
+.. Document meta
+
+:orphan:
+
+.. |antsibull-internal-nbsp| unicode:: 0xA0
+ :trim:
+
+.. meta::
+ :antsibull-docs: 2.12.0
+
+.. Anchors
+
+.. _ansible_collections.ansible.eda.activation_info_module:
+
+.. Anchors: short name for ansible.builtin
+
+.. Title
+
+ansible.eda.activation_info module -- List rulebook activations in the EDA Controller
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+.. Collection note
+
+.. note::
+ This module is part of the `ansible.eda collection `_ (version 1.4.7).
+
+ It is not included in ``ansible-core``.
+ To check whether it is installed, run :code:`ansible-galaxy collection list`.
+
+ To install it, use: :code:`ansible-galaxy collection install ansible.eda`.
+
+ To use it in a playbook, specify: :code:`ansible.eda.activation_info`.
+
+.. version_added
+
+.. rst-class:: ansible-version-added
+
+New in ansible.eda 2.0.0
+
+.. contents::
+ :local:
+ :depth: 1
+
+.. Deprecated
+
+
+Synopsis
+--------
+
+.. Description
+
+- List rulebook activations in the EDA controller.
+
+
+.. Aliases
+
+
+.. Requirements
+
+
+
+
+
+
+.. Options
+
+Parameters
+----------
+
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
+
+.. list-table::
+ :width: 100%
+ :widths: auto
+ :header-rows: 1
+ :class: longtable ansible-option-table
+
+ * - Parameter
+ - Comments
+
+ * - .. raw:: html
+
+
+
+ The URL of the EDA controller.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_URL`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+ Password used for authentication.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_PASSWORD`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+ Username used for authentication.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_USERNAME`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+ The name of the rulebook activation.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+ Timeout in seconds for the connection with the EDA controller.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_TIMEOUT`\ environment variable will be used.
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-default-bold:`Default:` :ansible-option-default:`10.0`
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+ Whether to allow insecure connections to Ansible Automation Platform EDA Controller instance.
+
+ If \ :literal:`no`\ , SSL certificates will not be validated.
+
+ This should only be used on personally controlled sites using self-signed certificates.
+
+ If value not set, will try environment variable \ :literal:`CONTROLLER\_VERIFY\_SSL`\
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-choices:`Choices:`
+
+ - :ansible-option-choices-entry:`false`
+ - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)`
+
+
+ .. raw:: html
+
+
+
+
+.. Attributes
+
+
+.. Notes
+
+
+.. Seealso
+
+
+.. Examples
+
+Examples
+--------
+
+.. code-block:: yaml+jinja
+
+
+ - name: Get information about a rulebook activation
+ ansible.eda.activation_info:
+ name: "Example Rulebook Activation"
+
+ - name: List all rulebook activations
+ ansible.eda.activation_info:
+
+
+
+
+.. Facts
+
+
+.. Return values
+
+Return Values
+-------------
+Common return values are documented :ref:`here `, the following are the fields unique to this module:
+
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
+
+.. list-table::
+ :width: 100%
+ :widths: auto
+ :header-rows: 1
+ :class: longtable ansible-option-table
+
+ * - Key
+ - Description
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.activation_info_module__return-activations:
+
+ .. rst-class:: ansible-option-title
+
+ **activations**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Information about rulebook activations.
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-returned-bold:`Returned:` always
+
+ .. rst-class:: ansible-option-line
+ .. rst-class:: ansible-option-sample
+
+ :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`[{"awx\_token\_id": 1, "created\_at": "2024-08-10T14:22:30.123Z", "current\_job\_id": "2", "decision\_environment\_id": 1, "description": "A test activation", "eda\_credentials": [], "event\_streams": [], "extra\_var": "", "id": 1, "is\_enabled": true, "k8s\_service\_name": "", "log\_level": "info", "modified\_at": "2024-08-15T11:45:00.987Z", "name": "Test activation", "organization\_id": 1, "project\_id": 2, "restart\_count": 2, "restart\_policy": "on-failure", "rulebook\_id": 1, "rulebook\_name": "Test rulebook", "rules\_count": 2, "rules\_fired\_count": 2, "status": "running", "status\_message": "Activation is running successfully.", "swap\_single\_source": false, "webhooks": []}]`
+
+
+ .. raw:: html
+
+
+
+
+
+.. Status (Presently only deprecated)
+
+
+.. Authors
+
+Authors
+~~~~~~~
+
+- Alina Buzachis (@alinabuzachis)
+
+
+
+.. Extra links
+
+Collection links
+~~~~~~~~~~~~~~~~
+
+.. ansible-links::
+
+ - title: "Issue Tracker"
+ url: "https://github.com/ansible/event-driven-ansible/issues"
+ external: true
+ - title: "Homepage"
+ url: "http://ansible.com/event-driven"
+ external: true
+ - title: "Repository (Sources)"
+ url: "https://github.com/ansible/event-driven-ansible"
+ external: true
+
+
+.. Parsing errors
+
diff --git a/docs/rst/activation_module.rst b/docs/rst/activation_module.rst
new file mode 100644
index 00000000..b8b668fd
--- /dev/null
+++ b/docs/rst/activation_module.rst
@@ -0,0 +1,1075 @@
+
+.. Document meta
+
+:orphan:
+
+.. |antsibull-internal-nbsp| unicode:: 0xA0
+ :trim:
+
+.. meta::
+ :antsibull-docs: 2.12.0
+
+.. Anchors
+
+.. _ansible_collections.ansible.eda.activation_module:
+
+.. Anchors: short name for ansible.builtin
+
+.. Title
+
+ansible.eda.activation module -- Manage rulebook activations in the EDA Controller
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+.. Collection note
+
+.. note::
+ This module is part of the `ansible.eda collection `_ (version 1.4.7).
+
+ It is not included in ``ansible-core``.
+ To check whether it is installed, run :code:`ansible-galaxy collection list`.
+
+ To install it, use: :code:`ansible-galaxy collection install ansible.eda`.
+
+ To use it in a playbook, specify: :code:`ansible.eda.activation`.
+
+.. version_added
+
+
+.. contents::
+ :local:
+ :depth: 1
+
+.. Deprecated
+
+
+Synopsis
+--------
+
+.. Description
+
+- This module allows the user to create or delete rulebook activations in the EDA Controller.
+
+
+.. Aliases
+
+
+.. Requirements
+
+
+
+
+
+
+.. Options
+
+Parameters
+----------
+
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
+
+.. list-table::
+ :width: 100%
+ :widths: auto
+ :header-rows: 1
+ :class: longtable ansible-option-table
+
+ * - Parameter
+ - Comments
+
+ * - .. raw:: html
+
+
+
+
+
+
+ .. _ansible_collections.ansible.eda.activation_module__parameter-awx_token:
+ .. _ansible_collections.ansible.eda.activation_module__parameter-awx_token_name:
+ .. _ansible_collections.ansible.eda.activation_module__parameter-token:
+
+ .. rst-class:: ansible-option-title
+
+ **awx_token_name**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-aliases:`aliases: awx_token, token`
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The token ID of the AWX controller.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.activation_module__parameter-controller_host:
+
+ .. rst-class:: ansible-option-title
+
+ **controller_host**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string` / :ansible-option-required:`required`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The URL of the EDA controller.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_URL`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.activation_module__parameter-controller_password:
+
+ .. rst-class:: ansible-option-title
+
+ **controller_password**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Password used for authentication.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_PASSWORD`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.activation_module__parameter-controller_username:
+
+ .. rst-class:: ansible-option-title
+
+ **controller_username**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Username used for authentication.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_USERNAME`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+
+ .. _ansible_collections.ansible.eda.activation_module__parameter-decision_environment:
+ .. _ansible_collections.ansible.eda.activation_module__parameter-decision_environment_name:
+
+ .. rst-class:: ansible-option-title
+
+ **decision_environment_name**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-aliases:`aliases: decision_environment`
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The name of the decision environment associated with the rulebook activation.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.activation_module__parameter-description:
+
+ .. rst-class:: ansible-option-title
+
+ **description**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The description of the rulebook activation.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+
+ .. _ansible_collections.ansible.eda.activation_module__parameter-credentials:
+ .. _ansible_collections.ansible.eda.activation_module__parameter-eda_credentials:
+
+ .. rst-class:: ansible-option-title
+
+ **eda_credentials**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-aliases:`aliases: credentials`
+
+ :ansible-option-type:`list` / :ansible-option-elements:`elements=string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ A list of IDs for EDA credentials used by the rulebook activation.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.activation_module__parameter-enabled:
+
+ .. rst-class:: ansible-option-title
+
+ **enabled**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`boolean`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Whether the rulebook activation is enabled or not.
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-choices:`Choices:`
+
+ - :ansible-option-choices-entry:`false`
+ - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)`
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.activation_module__parameter-event_streams:
+
+ .. rst-class:: ansible-option-title
+
+ **event_streams**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`list` / :ansible-option-elements:`elements=integer`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ A list of IDs representing the event streams that this rulebook activation listens to.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.activation_module__parameter-extra_vars:
+
+ .. rst-class:: ansible-option-title
+
+ **extra_vars**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The extra variables for the rulebook activation.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.activation_module__parameter-k8s_service_name:
+
+ .. rst-class:: ansible-option-title
+
+ **k8s_service_name**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The name of the Kubernetes service associated with this rulebook activation.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.activation_module__parameter-log_level:
+
+ .. rst-class:: ansible-option-title
+
+ **log_level**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Allow setting the desired log level.
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-choices:`Choices:`
+
+ - :ansible-option-choices-entry-default:`"debug"` :ansible-option-choices-default-mark:`← (default)`
+ - :ansible-option-choices-entry:`"info"`
+ - :ansible-option-choices-entry:`"error"`
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.activation_module__parameter-name:
+
+ .. rst-class:: ansible-option-title
+
+ **name**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string` / :ansible-option-required:`required`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The name of the rulebook activation.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+
+ .. _ansible_collections.ansible.eda.activation_module__parameter-organization:
+ .. _ansible_collections.ansible.eda.activation_module__parameter-organization_name:
+
+ .. rst-class:: ansible-option-title
+
+ **organization_name**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-aliases:`aliases: organization`
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The name of the organization.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+
+ .. _ansible_collections.ansible.eda.activation_module__parameter-project:
+ .. _ansible_collections.ansible.eda.activation_module__parameter-project_name:
+
+ .. rst-class:: ansible-option-title
+
+ **project_name**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-aliases:`aliases: project`
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The name of the project associated with the rulebook activation.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.activation_module__parameter-request_timeout:
+
+ .. rst-class:: ansible-option-title
+
+ **request_timeout**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`float`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Timeout in seconds for the connection with the EDA controller.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_TIMEOUT`\ environment variable will be used.
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-default-bold:`Default:` :ansible-option-default:`10.0`
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.activation_module__parameter-restart_policy:
+
+ .. rst-class:: ansible-option-title
+
+ **restart_policy**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The restart policy for the rulebook activation.
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-choices:`Choices:`
+
+ - :ansible-option-choices-entry:`"on-failure"`
+ - :ansible-option-choices-entry-default:`"always"` :ansible-option-choices-default-mark:`← (default)`
+ - :ansible-option-choices-entry:`"never"`
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+
+ .. _ansible_collections.ansible.eda.activation_module__parameter-rulebook:
+ .. _ansible_collections.ansible.eda.activation_module__parameter-rulebook_name:
+
+ .. rst-class:: ansible-option-title
+
+ **rulebook_name**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-aliases:`aliases: rulebook`
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The name of the rulebook associated with the rulebook activation.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.activation_module__parameter-state:
+
+ .. rst-class:: ansible-option-title
+
+ **state**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Desired state of the resource.
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-choices:`Choices:`
+
+ - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)`
+ - :ansible-option-choices-entry:`"absent"`
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.activation_module__parameter-swap_single_source:
+
+ .. rst-class:: ansible-option-title
+
+ **swap_single_source**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`boolean`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Allow swapping of single sources in a rulebook without name match.
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-choices:`Choices:`
+
+ - :ansible-option-choices-entry:`false`
+ - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)`
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.activation_module__parameter-validate_certs:
+
+ .. rst-class:: ansible-option-title
+
+ **validate_certs**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`boolean`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Whether to allow insecure connections to Ansible Automation Platform EDA Controller instance.
+
+ If \ :literal:`no`\ , SSL certificates will not be validated.
+
+ This should only be used on personally controlled sites using self-signed certificates.
+
+ If value not set, will try environment variable \ :literal:`CONTROLLER\_VERIFY\_SSL`\
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-choices:`Choices:`
+
+ - :ansible-option-choices-entry:`false`
+ - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)`
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.activation_module__parameter-webhooks:
+
+ .. rst-class:: ansible-option-title
+
+ **webhooks**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`list` / :ansible-option-elements:`elements=string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ A list of webhook IDs associated with the rulebook activation.
+
+
+ .. raw:: html
+
+
+
+
+.. Attributes
+
+
+.. Notes
+
+Notes
+-----
+
+.. note::
+ - Rulebook Activation API does not support PATCH method, due to this reason the module will not perform any modification when an existing rulebook activation is found.
+
+.. Seealso
+
+
+.. Examples
+
+Examples
+--------
+
+.. code-block:: yaml+jinja
+
+
+ - name: Create a rulebook activation
+ ansible.eda.activation:
+ name: "Example Rulebook Activation"
+ description: "Example Rulebook Activation description"
+ project_name: "Example Project"
+ rulebook_name: "hello_controller.yml"
+ decision_environment_name: "Example Decision Environment"
+ enabled: False
+ awx_token_name: "Example Token"
+
+ - name: Delete a rulebook activation
+ ansible.eda.activation:
+ name: "Example Rulebook Activation"
+ state: absent
+
+
+
+
+.. Facts
+
+
+.. Return values
+
+Return Values
+-------------
+Common return values are documented :ref:`here `, the following are the fields unique to this module:
+
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
+
+.. list-table::
+ :width: 100%
+ :widths: auto
+ :header-rows: 1
+ :class: longtable ansible-option-table
+
+ * - Key
+ - Description
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.activation_module__return-id:
+
+ .. rst-class:: ansible-option-title
+
+ **id**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`integer`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ ID of the rulebook activation.
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-returned-bold:`Returned:` when exists
+
+ .. rst-class:: ansible-option-line
+ .. rst-class:: ansible-option-sample
+
+ :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`37`
+
+
+ .. raw:: html
+
+
+
+
+
+.. Status (Presently only deprecated)
+
+
+.. Authors
+
+Authors
+~~~~~~~
+
+- Nikhil Jain (@jainnikhil30)
+- Alina Buzachis (@alinabuzachis)
+
+
+
+.. Extra links
+
+Collection links
+~~~~~~~~~~~~~~~~
+
+.. ansible-links::
+
+ - title: "Issue Tracker"
+ url: "https://github.com/ansible/event-driven-ansible/issues"
+ external: true
+ - title: "Homepage"
+ url: "http://ansible.com/event-driven"
+ external: true
+ - title: "Repository (Sources)"
+ url: "https://github.com/ansible/event-driven-ansible"
+ external: true
+
+
+.. Parsing errors
+
diff --git a/docs/rst/controller_token_module.rst b/docs/rst/controller_token_module.rst
new file mode 100644
index 00000000..394b13a3
--- /dev/null
+++ b/docs/rst/controller_token_module.rst
@@ -0,0 +1,583 @@
+
+.. Document meta
+
+:orphan:
+
+.. |antsibull-internal-nbsp| unicode:: 0xA0
+ :trim:
+
+.. meta::
+ :antsibull-docs: 2.12.0
+
+.. Anchors
+
+.. _ansible_collections.ansible.eda.controller_token_module:
+
+.. Anchors: short name for ansible.builtin
+
+.. Title
+
+ansible.eda.controller_token module -- Manage AWX tokens in EDA controller
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+.. Collection note
+
+.. note::
+ This module is part of the `ansible.eda collection `_ (version 1.4.7).
+
+ It is not included in ``ansible-core``.
+ To check whether it is installed, run :code:`ansible-galaxy collection list`.
+
+ To install it, use: :code:`ansible-galaxy collection install ansible.eda`.
+
+ To use it in a playbook, specify: :code:`ansible.eda.controller_token`.
+
+.. version_added
+
+.. rst-class:: ansible-version-added
+
+New in ansible.eda 2.0.0
+
+.. contents::
+ :local:
+ :depth: 1
+
+.. Deprecated
+
+
+Synopsis
+--------
+
+.. Description
+
+- This module allows the user to manage AWX tokens in a EDA controller.
+
+
+.. Aliases
+
+
+.. Requirements
+
+
+
+
+
+
+.. Options
+
+Parameters
+----------
+
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
+
+.. list-table::
+ :width: 100%
+ :widths: auto
+ :header-rows: 1
+ :class: longtable ansible-option-table
+
+ * - Parameter
+ - Comments
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.controller_token_module__parameter-controller_host:
+
+ .. rst-class:: ansible-option-title
+
+ **controller_host**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string` / :ansible-option-required:`required`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The URL of the EDA controller.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_URL`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.controller_token_module__parameter-controller_password:
+
+ .. rst-class:: ansible-option-title
+
+ **controller_password**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Password used for authentication.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_PASSWORD`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.controller_token_module__parameter-controller_username:
+
+ .. rst-class:: ansible-option-title
+
+ **controller_username**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Username used for authentication.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_USERNAME`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.controller_token_module__parameter-description:
+
+ .. rst-class:: ansible-option-title
+
+ **description**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The description of the project.
+
+ Required when \ :ansopt:`ansible.eda.controller\_token#module:state=present`\ .
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.controller_token_module__parameter-name:
+
+ .. rst-class:: ansible-option-title
+
+ **name**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string` / :ansible-option-required:`required`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The name of the AWX token.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.controller_token_module__parameter-request_timeout:
+
+ .. rst-class:: ansible-option-title
+
+ **request_timeout**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`float`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Timeout in seconds for the connection with the EDA controller.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_TIMEOUT`\ environment variable will be used.
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-default-bold:`Default:` :ansible-option-default:`10.0`
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.controller_token_module__parameter-state:
+
+ .. rst-class:: ansible-option-title
+
+ **state**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Desired state of the resource.
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-choices:`Choices:`
+
+ - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)`
+ - :ansible-option-choices-entry:`"absent"`
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.controller_token_module__parameter-token:
+
+ .. rst-class:: ansible-option-title
+
+ **token**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The AWX token value.
+
+ Required when \ :ansopt:`ansible.eda.controller\_token#module:state=present`\ .
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.controller_token_module__parameter-validate_certs:
+
+ .. rst-class:: ansible-option-title
+
+ **validate_certs**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`boolean`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Whether to allow insecure connections to Ansible Automation Platform EDA Controller instance.
+
+ If \ :literal:`no`\ , SSL certificates will not be validated.
+
+ This should only be used on personally controlled sites using self-signed certificates.
+
+ If value not set, will try environment variable \ :literal:`CONTROLLER\_VERIFY\_SSL`\
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-choices:`Choices:`
+
+ - :ansible-option-choices-entry:`false`
+ - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)`
+
+
+ .. raw:: html
+
+
+
+
+.. Attributes
+
+
+.. Notes
+
+Notes
+-----
+
+.. note::
+ - Controller Token API does not support PATCH method, due to this reason the module deletes and re-creates the token when existing controller token is found. This will cause module to report changed, every time update is called.
+
+.. Seealso
+
+
+.. Examples
+
+Examples
+--------
+
+.. code-block:: yaml+jinja
+
+
+ - name: Create AWX token
+ ansible.eda.controller_token:
+ controller_host: https://my_eda_host/
+ controller_username: admin
+ controller_password: MySuperSecretPassw0rd
+ name: "Example AWX token"
+ description: "Example AWX token description"
+ token: ""
+ state: present
+ no_log: true
+
+ - name: Delete AWX token
+ ansible.eda.controller_token:
+ controller_host: https://my_eda_host/
+ controller_username: admin
+ controller_password: MySuperSecretPassw0rd
+ name: "Example AWX token"
+ state: absent
+
+
+
+
+.. Facts
+
+
+.. Return values
+
+Return Values
+-------------
+Common return values are documented :ref:`here `, the following are the fields unique to this module:
+
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
+
+.. list-table::
+ :width: 100%
+ :widths: auto
+ :header-rows: 1
+ :class: longtable ansible-option-table
+
+ * - Key
+ - Description
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.controller_token_module__return-id:
+
+ .. rst-class:: ansible-option-title
+
+ **id**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ ID of the managed AWX token.
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-returned-bold:`Returned:` when state is 'present' and successful
+
+ .. rst-class:: ansible-option-line
+ .. rst-class:: ansible-option-sample
+
+ :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`"123"`
+
+
+ .. raw:: html
+
+
+
+
+
+.. Status (Presently only deprecated)
+
+
+.. Authors
+
+Authors
+~~~~~~~
+
+- Abhijeet Kasurde (@akasurde)
+
+
+
+.. Extra links
+
+Collection links
+~~~~~~~~~~~~~~~~
+
+.. ansible-links::
+
+ - title: "Issue Tracker"
+ url: "https://github.com/ansible/event-driven-ansible/issues"
+ external: true
+ - title: "Homepage"
+ url: "http://ansible.com/event-driven"
+ external: true
+ - title: "Repository (Sources)"
+ url: "https://github.com/ansible/event-driven-ansible"
+ external: true
+
+
+.. Parsing errors
+
diff --git a/docs/rst/credential_info_module.rst b/docs/rst/credential_info_module.rst
new file mode 100644
index 00000000..30d2b111
--- /dev/null
+++ b/docs/rst/credential_info_module.rst
@@ -0,0 +1,452 @@
+
+.. Document meta
+
+:orphan:
+
+.. |antsibull-internal-nbsp| unicode:: 0xA0
+ :trim:
+
+.. meta::
+ :antsibull-docs: 2.12.0
+
+.. Anchors
+
+.. _ansible_collections.ansible.eda.credential_info_module:
+
+.. Anchors: short name for ansible.builtin
+
+.. Title
+
+ansible.eda.credential_info module -- List credentials in the EDA Controller
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+.. Collection note
+
+.. note::
+ This module is part of the `ansible.eda collection `_ (version 1.4.7).
+
+ It is not included in ``ansible-core``.
+ To check whether it is installed, run :code:`ansible-galaxy collection list`.
+
+ To install it, use: :code:`ansible-galaxy collection install ansible.eda`.
+
+ To use it in a playbook, specify: :code:`ansible.eda.credential_info`.
+
+.. version_added
+
+.. rst-class:: ansible-version-added
+
+New in ansible.eda 2.0.0
+
+.. contents::
+ :local:
+ :depth: 1
+
+.. Deprecated
+
+
+Synopsis
+--------
+
+.. Description
+
+- List credentials in the EDA controller.
+
+
+.. Aliases
+
+
+.. Requirements
+
+
+
+
+
+
+.. Options
+
+Parameters
+----------
+
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
+
+.. list-table::
+ :width: 100%
+ :widths: auto
+ :header-rows: 1
+ :class: longtable ansible-option-table
+
+ * - Parameter
+ - Comments
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_info_module__parameter-controller_host:
+
+ .. rst-class:: ansible-option-title
+
+ **controller_host**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string` / :ansible-option-required:`required`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The URL of the EDA controller.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_URL`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_info_module__parameter-controller_password:
+
+ .. rst-class:: ansible-option-title
+
+ **controller_password**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Password used for authentication.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_PASSWORD`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_info_module__parameter-controller_username:
+
+ .. rst-class:: ansible-option-title
+
+ **controller_username**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Username used for authentication.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_USERNAME`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_info_module__parameter-name:
+
+ .. rst-class:: ansible-option-title
+
+ **name**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The name of the credential.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_info_module__parameter-request_timeout:
+
+ .. rst-class:: ansible-option-title
+
+ **request_timeout**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`float`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Timeout in seconds for the connection with the EDA controller.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_TIMEOUT`\ environment variable will be used.
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-default-bold:`Default:` :ansible-option-default:`10.0`
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_info_module__parameter-validate_certs:
+
+ .. rst-class:: ansible-option-title
+
+ **validate_certs**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`boolean`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Whether to allow insecure connections to Ansible Automation Platform EDA Controller instance.
+
+ If \ :literal:`no`\ , SSL certificates will not be validated.
+
+ This should only be used on personally controlled sites using self-signed certificates.
+
+ If value not set, will try environment variable \ :literal:`CONTROLLER\_VERIFY\_SSL`\
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-choices:`Choices:`
+
+ - :ansible-option-choices-entry:`false`
+ - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)`
+
+
+ .. raw:: html
+
+
+
+
+.. Attributes
+
+
+.. Notes
+
+
+.. Seealso
+
+
+.. Examples
+
+Examples
+--------
+
+.. code-block:: yaml+jinja
+
+
+ - name: Get information about a credential
+ ansible.eda.credential_info:
+ name: "Test"
+
+ - name: List all credentials
+ ansible.eda.credential_info:
+
+
+
+
+.. Facts
+
+
+.. Return values
+
+Return Values
+-------------
+Common return values are documented :ref:`here `, the following are the fields unique to this module:
+
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
+
+.. list-table::
+ :width: 100%
+ :widths: auto
+ :header-rows: 1
+ :class: longtable ansible-option-table
+
+ * - Key
+ - Description
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_info_module__return-credentials:
+
+ .. rst-class:: ansible-option-title
+
+ **credentials**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Information about credentials.
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-returned-bold:`Returned:` always
+
+ .. rst-class:: ansible-option-line
+ .. rst-class:: ansible-option-sample
+
+ :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`[{"created\_at": "2024-08-14T08:57:55.151787Z", "credential\_type": {"id": 1, "kind": "scm", "name": "Source Control", "namespace": "scm"}, "description": "This is a test credential", "id": 24, "inputs": {"password": "$encrypted$", "username": "testuser"}, "managed": false, "modified\_at": "2024-08-14T08:57:56.324925Z", "name": "New Test Credential", "organization": {"description": "The default organization", "id": 1, "name": "Default"}, "references": null}]`
+
+
+ .. raw:: html
+
+
+
+
+
+.. Status (Presently only deprecated)
+
+
+.. Authors
+
+Authors
+~~~~~~~
+
+- Alina Buzachis (@alinabuzachis)
+
+
+
+.. Extra links
+
+Collection links
+~~~~~~~~~~~~~~~~
+
+.. ansible-links::
+
+ - title: "Issue Tracker"
+ url: "https://github.com/ansible/event-driven-ansible/issues"
+ external: true
+ - title: "Homepage"
+ url: "http://ansible.com/event-driven"
+ external: true
+ - title: "Repository (Sources)"
+ url: "https://github.com/ansible/event-driven-ansible"
+ external: true
+
+
+.. Parsing errors
+
diff --git a/docs/rst/credential_module.rst b/docs/rst/credential_module.rst
new file mode 100644
index 00000000..68e9f472
--- /dev/null
+++ b/docs/rst/credential_module.rst
@@ -0,0 +1,675 @@
+
+.. Document meta
+
+:orphan:
+
+.. |antsibull-internal-nbsp| unicode:: 0xA0
+ :trim:
+
+.. meta::
+ :antsibull-docs: 2.12.0
+
+.. Anchors
+
+.. _ansible_collections.ansible.eda.credential_module:
+
+.. Anchors: short name for ansible.builtin
+
+.. Title
+
+ansible.eda.credential module -- Manage credentials in EDA Controller
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+.. Collection note
+
+.. note::
+ This module is part of the `ansible.eda collection `_ (version 1.4.7).
+
+ It is not included in ``ansible-core``.
+ To check whether it is installed, run :code:`ansible-galaxy collection list`.
+
+ To install it, use: :code:`ansible-galaxy collection install ansible.eda`.
+
+ To use it in a playbook, specify: :code:`ansible.eda.credential`.
+
+.. version_added
+
+.. rst-class:: ansible-version-added
+
+New in ansible.eda 2.0.0
+
+.. contents::
+ :local:
+ :depth: 1
+
+.. Deprecated
+
+
+Synopsis
+--------
+
+.. Description
+
+- This module allows the user to create, update or delete a credential in EDA controller.
+
+
+.. Aliases
+
+
+.. Requirements
+
+
+
+
+
+
+.. Options
+
+Parameters
+----------
+
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
+
+.. list-table::
+ :width: 100%
+ :widths: auto
+ :header-rows: 1
+ :class: longtable ansible-option-table
+
+ * - Parameter
+ - Comments
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_module__parameter-controller_host:
+
+ .. rst-class:: ansible-option-title
+
+ **controller_host**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string` / :ansible-option-required:`required`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The URL of the EDA controller.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_URL`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_module__parameter-controller_password:
+
+ .. rst-class:: ansible-option-title
+
+ **controller_password**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Password used for authentication.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_PASSWORD`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_module__parameter-controller_username:
+
+ .. rst-class:: ansible-option-title
+
+ **controller_username**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Username used for authentication.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_USERNAME`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_module__parameter-credential_type_name:
+
+ .. rst-class:: ansible-option-title
+
+ **credential_type_name**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The name of the credential type.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_module__parameter-description:
+
+ .. rst-class:: ansible-option-title
+
+ **description**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Description of the credential.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_module__parameter-inputs:
+
+ .. rst-class:: ansible-option-title
+
+ **inputs**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`dictionary`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Credential inputs where the keys are var names used in templating.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_module__parameter-name:
+
+ .. rst-class:: ansible-option-title
+
+ **name**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string` / :ansible-option-required:`required`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Name of the credential.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_module__parameter-new_name:
+
+ .. rst-class:: ansible-option-title
+
+ **new_name**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Setting this option will change the existing name (lookup via name).
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_module__parameter-org_name:
+ .. _ansible_collections.ansible.eda.credential_module__parameter-organization_name:
+
+ .. rst-class:: ansible-option-title
+
+ **organization_name**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-aliases:`aliases: org_name`
+
+ :ansible-option-type:`integer`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The name of the organization.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_module__parameter-request_timeout:
+
+ .. rst-class:: ansible-option-title
+
+ **request_timeout**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`float`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Timeout in seconds for the connection with the EDA controller.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_TIMEOUT`\ environment variable will be used.
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-default-bold:`Default:` :ansible-option-default:`10.0`
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_module__parameter-state:
+
+ .. rst-class:: ansible-option-title
+
+ **state**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Desired state of the resource.
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-choices:`Choices:`
+
+ - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)`
+ - :ansible-option-choices-entry:`"absent"`
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_module__parameter-validate_certs:
+
+ .. rst-class:: ansible-option-title
+
+ **validate_certs**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`boolean`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Whether to allow insecure connections to Ansible Automation Platform EDA Controller instance.
+
+ If \ :literal:`no`\ , SSL certificates will not be validated.
+
+ This should only be used on personally controlled sites using self-signed certificates.
+
+ If value not set, will try environment variable \ :literal:`CONTROLLER\_VERIFY\_SSL`\
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-choices:`Choices:`
+
+ - :ansible-option-choices-entry:`false`
+ - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)`
+
+
+ .. raw:: html
+
+
+
+
+.. Attributes
+
+
+.. Notes
+
+
+.. Seealso
+
+
+.. Examples
+
+Examples
+--------
+
+.. code-block:: yaml+jinja
+
+
+ - name: Create an EDA Credential
+ ansible.eda.credential:
+ name: "Example Credential"
+ description: "Example credential description"
+ inputs:
+ field1: "field1"
+ credential_type_name: "GitLab Personal Access Token"
+
+ - name: Delete an EDA Credential
+ ansible.eda.credential:
+ name: "Example Credential"
+ state: absent
+
+
+
+
+.. Facts
+
+
+.. Return values
+
+Return Values
+-------------
+Common return values are documented :ref:`here `, the following are the fields unique to this module:
+
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
+
+.. list-table::
+ :width: 100%
+ :widths: auto
+ :header-rows: 1
+ :class: longtable ansible-option-table
+
+ * - Key
+ - Description
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_module__return-id:
+
+ .. rst-class:: ansible-option-title
+
+ **id**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`integer`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ ID of the credential.
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-returned-bold:`Returned:` when exists
+
+ .. rst-class:: ansible-option-line
+ .. rst-class:: ansible-option-sample
+
+ :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`24`
+
+
+ .. raw:: html
+
+
+
+
+
+.. Status (Presently only deprecated)
+
+
+.. Authors
+
+Authors
+~~~~~~~
+
+- Nikhil Jain (@jainnikhil30)
+- Alina Buzachis (@alinabuzachis)
+
+
+
+.. Extra links
+
+Collection links
+~~~~~~~~~~~~~~~~
+
+.. ansible-links::
+
+ - title: "Issue Tracker"
+ url: "https://github.com/ansible/event-driven-ansible/issues"
+ external: true
+ - title: "Homepage"
+ url: "http://ansible.com/event-driven"
+ external: true
+ - title: "Repository (Sources)"
+ url: "https://github.com/ansible/event-driven-ansible"
+ external: true
+
+
+.. Parsing errors
+
diff --git a/docs/rst/credential_type_info_module.rst b/docs/rst/credential_type_info_module.rst
new file mode 100644
index 00000000..c2690d43
--- /dev/null
+++ b/docs/rst/credential_type_info_module.rst
@@ -0,0 +1,452 @@
+
+.. Document meta
+
+:orphan:
+
+.. |antsibull-internal-nbsp| unicode:: 0xA0
+ :trim:
+
+.. meta::
+ :antsibull-docs: 2.12.0
+
+.. Anchors
+
+.. _ansible_collections.ansible.eda.credential_type_info_module:
+
+.. Anchors: short name for ansible.builtin
+
+.. Title
+
+ansible.eda.credential_type_info module -- List credential types in EDA Controller
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+.. Collection note
+
+.. note::
+ This module is part of the `ansible.eda collection `_ (version 1.4.7).
+
+ It is not included in ``ansible-core``.
+ To check whether it is installed, run :code:`ansible-galaxy collection list`.
+
+ To install it, use: :code:`ansible-galaxy collection install ansible.eda`.
+
+ To use it in a playbook, specify: :code:`ansible.eda.credential_type_info`.
+
+.. version_added
+
+.. rst-class:: ansible-version-added
+
+New in ansible.eda 2.0.0
+
+.. contents::
+ :local:
+ :depth: 1
+
+.. Deprecated
+
+
+Synopsis
+--------
+
+.. Description
+
+- List credential types in EDA controller.
+
+
+.. Aliases
+
+
+.. Requirements
+
+
+
+
+
+
+.. Options
+
+Parameters
+----------
+
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
+
+.. list-table::
+ :width: 100%
+ :widths: auto
+ :header-rows: 1
+ :class: longtable ansible-option-table
+
+ * - Parameter
+ - Comments
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_type_info_module__parameter-controller_host:
+
+ .. rst-class:: ansible-option-title
+
+ **controller_host**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string` / :ansible-option-required:`required`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The URL of the EDA controller.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_URL`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_type_info_module__parameter-controller_password:
+
+ .. rst-class:: ansible-option-title
+
+ **controller_password**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Password used for authentication.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_PASSWORD`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_type_info_module__parameter-controller_username:
+
+ .. rst-class:: ansible-option-title
+
+ **controller_username**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Username used for authentication.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_USERNAME`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_type_info_module__parameter-name:
+
+ .. rst-class:: ansible-option-title
+
+ **name**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The name of the credential type.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_type_info_module__parameter-request_timeout:
+
+ .. rst-class:: ansible-option-title
+
+ **request_timeout**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`float`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Timeout in seconds for the connection with the EDA controller.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_TIMEOUT`\ environment variable will be used.
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-default-bold:`Default:` :ansible-option-default:`10.0`
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_type_info_module__parameter-validate_certs:
+
+ .. rst-class:: ansible-option-title
+
+ **validate_certs**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`boolean`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Whether to allow insecure connections to Ansible Automation Platform EDA Controller instance.
+
+ If \ :literal:`no`\ , SSL certificates will not be validated.
+
+ This should only be used on personally controlled sites using self-signed certificates.
+
+ If value not set, will try environment variable \ :literal:`CONTROLLER\_VERIFY\_SSL`\
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-choices:`Choices:`
+
+ - :ansible-option-choices-entry:`false`
+ - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)`
+
+
+ .. raw:: html
+
+
+
+
+.. Attributes
+
+
+.. Notes
+
+
+.. Seealso
+
+
+.. Examples
+
+Examples
+--------
+
+.. code-block:: yaml+jinja
+
+
+ - name: Get information about a credential type
+ ansible.eda.credential_type_info:
+ name: "Test"
+
+ - name: List all credential types
+ ansible.eda.credential_type_info:
+
+
+
+
+.. Facts
+
+
+.. Return values
+
+Return Values
+-------------
+Common return values are documented :ref:`here `, the following are the fields unique to this module:
+
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
+
+.. list-table::
+ :width: 100%
+ :widths: auto
+ :header-rows: 1
+ :class: longtable ansible-option-table
+
+ * - Key
+ - Description
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_type_info_module__return-credential_types:
+
+ .. rst-class:: ansible-option-title
+
+ **credential_types**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Information about the credential types.
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-returned-bold:`Returned:` always
+
+ .. rst-class:: ansible-option-line
+ .. rst-class:: ansible-option-sample
+
+ :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`[{"created\_at": "2024-08-14T08:30:14.806638Z", "description": "A test credential type", "id": 37, "injectors": {"extra\_vars": {"field1": "field1"}}, "inputs": {"fields": [{"id": "field1", "label": "Field 5", "type": "string"}]}, "kind": "cloud", "managed": false, "modified\_at": "2024-08-14T08:30:14.807549Z", "name": "Example", "namespace": null}]`
+
+
+ .. raw:: html
+
+
+
+
+
+.. Status (Presently only deprecated)
+
+
+.. Authors
+
+Authors
+~~~~~~~
+
+- Alina Buzachis (@alinabuzachis)
+
+
+
+.. Extra links
+
+Collection links
+~~~~~~~~~~~~~~~~
+
+.. ansible-links::
+
+ - title: "Issue Tracker"
+ url: "https://github.com/ansible/event-driven-ansible/issues"
+ external: true
+ - title: "Homepage"
+ url: "http://ansible.com/event-driven"
+ external: true
+ - title: "Repository (Sources)"
+ url: "https://github.com/ansible/event-driven-ansible"
+ external: true
+
+
+.. Parsing errors
+
diff --git a/docs/rst/credential_type_module.rst b/docs/rst/credential_type_module.rst
new file mode 100644
index 00000000..e2b799f6
--- /dev/null
+++ b/docs/rst/credential_type_module.rst
@@ -0,0 +1,642 @@
+
+.. Document meta
+
+:orphan:
+
+.. |antsibull-internal-nbsp| unicode:: 0xA0
+ :trim:
+
+.. meta::
+ :antsibull-docs: 2.12.0
+
+.. Anchors
+
+.. _ansible_collections.ansible.eda.credential_type_module:
+
+.. Anchors: short name for ansible.builtin
+
+.. Title
+
+ansible.eda.credential_type module -- Manage credential types in EDA Controller
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+.. Collection note
+
+.. note::
+ This module is part of the `ansible.eda collection `_ (version 1.4.7).
+
+ It is not included in ``ansible-core``.
+ To check whether it is installed, run :code:`ansible-galaxy collection list`.
+
+ To install it, use: :code:`ansible-galaxy collection install ansible.eda`.
+
+ To use it in a playbook, specify: :code:`ansible.eda.credential_type`.
+
+.. version_added
+
+.. rst-class:: ansible-version-added
+
+New in ansible.eda 2.0.0
+
+.. contents::
+ :local:
+ :depth: 1
+
+.. Deprecated
+
+
+Synopsis
+--------
+
+.. Description
+
+- This module allows the user to create, update or delete a credential type in EDA controller.
+
+
+.. Aliases
+
+
+.. Requirements
+
+
+
+
+
+
+.. Options
+
+Parameters
+----------
+
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
+
+.. list-table::
+ :width: 100%
+ :widths: auto
+ :header-rows: 1
+ :class: longtable ansible-option-table
+
+ * - Parameter
+ - Comments
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_type_module__parameter-controller_host:
+
+ .. rst-class:: ansible-option-title
+
+ **controller_host**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string` / :ansible-option-required:`required`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The URL of the EDA controller.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_URL`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_type_module__parameter-controller_password:
+
+ .. rst-class:: ansible-option-title
+
+ **controller_password**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Password used for authentication.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_PASSWORD`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_type_module__parameter-controller_username:
+
+ .. rst-class:: ansible-option-title
+
+ **controller_username**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Username used for authentication.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_USERNAME`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_type_module__parameter-description:
+
+ .. rst-class:: ansible-option-title
+
+ **description**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The description of the credential type to give more detail about it.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_type_module__parameter-injectors:
+
+ .. rst-class:: ansible-option-title
+
+ **injectors**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`dictionary`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Injectors of the credential type.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_type_module__parameter-inputs:
+
+ .. rst-class:: ansible-option-title
+
+ **inputs**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`dictionary`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Inputs of the credential type.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_type_module__parameter-name:
+
+ .. rst-class:: ansible-option-title
+
+ **name**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string` / :ansible-option-required:`required`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The name of the credential type.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_type_module__parameter-new_name:
+
+ .. rst-class:: ansible-option-title
+
+ **new_name**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Setting this option will change the existing name.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_type_module__parameter-request_timeout:
+
+ .. rst-class:: ansible-option-title
+
+ **request_timeout**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`float`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Timeout in seconds for the connection with the EDA controller.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_TIMEOUT`\ environment variable will be used.
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-default-bold:`Default:` :ansible-option-default:`10.0`
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_type_module__parameter-state:
+
+ .. rst-class:: ansible-option-title
+
+ **state**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Desired state of the resource.
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-choices:`Choices:`
+
+ - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)`
+ - :ansible-option-choices-entry:`"absent"`
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_type_module__parameter-validate_certs:
+
+ .. rst-class:: ansible-option-title
+
+ **validate_certs**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`boolean`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Whether to allow insecure connections to Ansible Automation Platform EDA Controller instance.
+
+ If \ :literal:`no`\ , SSL certificates will not be validated.
+
+ This should only be used on personally controlled sites using self-signed certificates.
+
+ If value not set, will try environment variable \ :literal:`CONTROLLER\_VERIFY\_SSL`\
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-choices:`Choices:`
+
+ - :ansible-option-choices-entry:`false`
+ - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)`
+
+
+ .. raw:: html
+
+
+
+
+.. Attributes
+
+
+.. Notes
+
+
+.. Seealso
+
+
+.. Examples
+
+Examples
+--------
+
+.. code-block:: yaml+jinja
+
+
+ - name: Create a credential type
+ ansible.eda.credential_type:
+ name: "Test"
+ state: present
+ description: "A test credential type"
+ inputs:
+ fields:
+ - id: "Field1"
+ type: "string"
+ label: "Label1"
+ injectors:
+ extra_vars:
+ field1: "field1"
+
+ - name: Delete a credential type
+ ansible.eda.credential_type:
+ name: "Test"
+ state: absent
+
+
+
+
+.. Facts
+
+
+.. Return values
+
+Return Values
+-------------
+Common return values are documented :ref:`here `, the following are the fields unique to this module:
+
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
+
+.. list-table::
+ :width: 100%
+ :widths: auto
+ :header-rows: 1
+ :class: longtable ansible-option-table
+
+ * - Key
+ - Description
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.credential_type_module__return-id:
+
+ .. rst-class:: ansible-option-title
+
+ **id**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`integer`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ ID of the credential type.
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-returned-bold:`Returned:` when exists
+
+ .. rst-class:: ansible-option-line
+ .. rst-class:: ansible-option-sample
+
+ :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`37`
+
+
+ .. raw:: html
+
+
+
+
+
+.. Status (Presently only deprecated)
+
+
+.. Authors
+
+Authors
+~~~~~~~
+
+- Alina Buzachis (@alinabuzachis)
+
+
+
+.. Extra links
+
+Collection links
+~~~~~~~~~~~~~~~~
+
+.. ansible-links::
+
+ - title: "Issue Tracker"
+ url: "https://github.com/ansible/event-driven-ansible/issues"
+ external: true
+ - title: "Homepage"
+ url: "http://ansible.com/event-driven"
+ external: true
+ - title: "Repository (Sources)"
+ url: "https://github.com/ansible/event-driven-ansible"
+ external: true
+
+
+.. Parsing errors
+
diff --git a/docs/rst/decision_environment_info_module.rst b/docs/rst/decision_environment_info_module.rst
new file mode 100644
index 00000000..18cc4522
--- /dev/null
+++ b/docs/rst/decision_environment_info_module.rst
@@ -0,0 +1,458 @@
+
+.. Document meta
+
+:orphan:
+
+.. |antsibull-internal-nbsp| unicode:: 0xA0
+ :trim:
+
+.. meta::
+ :antsibull-docs: 2.12.0
+
+.. Anchors
+
+.. _ansible_collections.ansible.eda.decision_environment_info_module:
+
+.. Anchors: short name for ansible.builtin
+
+.. Title
+
+ansible.eda.decision_environment_info module -- List a decision environment in EDA Controller
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+.. Collection note
+
+.. note::
+ This module is part of the `ansible.eda collection `_ (version 1.4.7).
+
+ It is not included in ``ansible-core``.
+ To check whether it is installed, run :code:`ansible-galaxy collection list`.
+
+ To install it, use: :code:`ansible-galaxy collection install ansible.eda`.
+
+ To use it in a playbook, specify: :code:`ansible.eda.decision_environment_info`.
+
+.. version_added
+
+.. rst-class:: ansible-version-added
+
+New in ansible.eda 2.0.0
+
+.. contents::
+ :local:
+ :depth: 1
+
+.. Deprecated
+
+
+Synopsis
+--------
+
+.. Description
+
+- This module allows user to list a decision environment in a EDA controller.
+
+
+.. Aliases
+
+
+.. Requirements
+
+
+
+
+
+
+.. Options
+
+Parameters
+----------
+
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
+
+.. list-table::
+ :width: 100%
+ :widths: auto
+ :header-rows: 1
+ :class: longtable ansible-option-table
+
+ * - Parameter
+ - Comments
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.decision_environment_info_module__parameter-controller_host:
+
+ .. rst-class:: ansible-option-title
+
+ **controller_host**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string` / :ansible-option-required:`required`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The URL of the EDA controller.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_URL`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.decision_environment_info_module__parameter-controller_password:
+
+ .. rst-class:: ansible-option-title
+
+ **controller_password**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Password used for authentication.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_PASSWORD`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.decision_environment_info_module__parameter-controller_username:
+
+ .. rst-class:: ansible-option-title
+
+ **controller_username**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Username used for authentication.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_USERNAME`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.decision_environment_info_module__parameter-name:
+
+ .. rst-class:: ansible-option-title
+
+ **name**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The name of the decision environment.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.decision_environment_info_module__parameter-request_timeout:
+
+ .. rst-class:: ansible-option-title
+
+ **request_timeout**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`float`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Timeout in seconds for the connection with the EDA controller.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_TIMEOUT`\ environment variable will be used.
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-default-bold:`Default:` :ansible-option-default:`10.0`
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.decision_environment_info_module__parameter-validate_certs:
+
+ .. rst-class:: ansible-option-title
+
+ **validate_certs**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`boolean`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Whether to allow insecure connections to Ansible Automation Platform EDA Controller instance.
+
+ If \ :literal:`no`\ , SSL certificates will not be validated.
+
+ This should only be used on personally controlled sites using self-signed certificates.
+
+ If value not set, will try environment variable \ :literal:`CONTROLLER\_VERIFY\_SSL`\
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-choices:`Choices:`
+
+ - :ansible-option-choices-entry:`false`
+ - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)`
+
+
+ .. raw:: html
+
+
+
+
+.. Attributes
+
+
+.. Notes
+
+
+.. Seealso
+
+
+.. Examples
+
+Examples
+--------
+
+.. code-block:: yaml+jinja
+
+
+ - name: List all EDA Decision Environments
+ ansible.eda.decision_environment_info:
+ controller_host: https://my_eda_host/
+ controller_username: admin
+ controller_password: MySuperSecretPassw0rd
+
+ - name: List a particular EDA Decision Environments
+ ansible.eda.decision_environment_info:
+ controller_host: https://my_eda_host/
+ controller_username: admin
+ controller_password: MySuperSecretPassw0rd
+ name: Example
+
+
+
+
+.. Facts
+
+
+.. Return values
+
+Return Values
+-------------
+Common return values are documented :ref:`here `, the following are the fields unique to this module:
+
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
+
+.. list-table::
+ :width: 100%
+ :widths: auto
+ :header-rows: 1
+ :class: longtable ansible-option-table
+
+ * - Key
+ - Description
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.decision_environment_info_module__return-decision_environments:
+
+ .. rst-class:: ansible-option-title
+
+ **decision_environments**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`list` / :ansible-option-elements:`elements=string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ List of dict containing information about decision environments
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-returned-bold:`Returned:` when exists
+
+ .. rst-class:: ansible-option-line
+ .. rst-class:: ansible-option-sample
+
+ :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`[{"created\_at": "2024-08-15T21:12:52.218969Z", "description": "Example decision environment description", "eda\_credential\_id": null, "id": 35, "image\_url": "https://quay.io/repository/ansible/eda-server", "modified\_at": "2024-08-15T21:12:52.218994Z", "name": "Example Decision environment", "organization\_id": 1}]`
+
+
+ .. raw:: html
+
+
+
+
+
+.. Status (Presently only deprecated)
+
+
+.. Authors
+
+Authors
+~~~~~~~
+
+- Abhijeet Kasurde (@akasurde)
+
+
+
+.. Extra links
+
+Collection links
+~~~~~~~~~~~~~~~~
+
+.. ansible-links::
+
+ - title: "Issue Tracker"
+ url: "https://github.com/ansible/event-driven-ansible/issues"
+ external: true
+ - title: "Homepage"
+ url: "http://ansible.com/event-driven"
+ external: true
+ - title: "Repository (Sources)"
+ url: "https://github.com/ansible/event-driven-ansible"
+ external: true
+
+
+.. Parsing errors
+
diff --git a/docs/rst/decision_environment_module.rst b/docs/rst/decision_environment_module.rst
new file mode 100644
index 00000000..d30cc447
--- /dev/null
+++ b/docs/rst/decision_environment_module.rst
@@ -0,0 +1,652 @@
+
+.. Document meta
+
+:orphan:
+
+.. |antsibull-internal-nbsp| unicode:: 0xA0
+ :trim:
+
+.. meta::
+ :antsibull-docs: 2.12.0
+
+.. Anchors
+
+.. _ansible_collections.ansible.eda.decision_environment_module:
+
+.. Anchors: short name for ansible.builtin
+
+.. Title
+
+ansible.eda.decision_environment module -- Create, update or delete decision environment in EDA Controller
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+.. Collection note
+
+.. note::
+ This module is part of the `ansible.eda collection `_ (version 1.4.7).
+
+ It is not included in ``ansible-core``.
+ To check whether it is installed, run :code:`ansible-galaxy collection list`.
+
+ To install it, use: :code:`ansible-galaxy collection install ansible.eda`.
+
+ To use it in a playbook, specify: :code:`ansible.eda.decision_environment`.
+
+.. version_added
+
+.. rst-class:: ansible-version-added
+
+New in ansible.eda 2.0.0
+
+.. contents::
+ :local:
+ :depth: 1
+
+.. Deprecated
+
+
+Synopsis
+--------
+
+.. Description
+
+- This module allows user to create, update or delete decision environment in a EDA controller.
+
+
+.. Aliases
+
+
+.. Requirements
+
+
+
+
+
+
+.. Options
+
+Parameters
+----------
+
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
+
+.. list-table::
+ :width: 100%
+ :widths: auto
+ :header-rows: 1
+ :class: longtable ansible-option-table
+
+ * - Parameter
+ - Comments
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.decision_environment_module__parameter-controller_host:
+
+ .. rst-class:: ansible-option-title
+
+ **controller_host**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string` / :ansible-option-required:`required`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The URL of the EDA controller.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_URL`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.decision_environment_module__parameter-controller_password:
+
+ .. rst-class:: ansible-option-title
+
+ **controller_password**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Password used for authentication.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_PASSWORD`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.decision_environment_module__parameter-controller_username:
+
+ .. rst-class:: ansible-option-title
+
+ **controller_username**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Username used for authentication.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_USERNAME`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.decision_environment_module__parameter-credential:
+
+ .. rst-class:: ansible-option-title
+
+ **credential**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Name of the credential to associate with the decision environment.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.decision_environment_module__parameter-description:
+
+ .. rst-class:: ansible-option-title
+
+ **description**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The description of the decision environment.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.decision_environment_module__parameter-image_url:
+
+ .. rst-class:: ansible-option-title
+
+ **image_url**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Image URL of the decision environment.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.decision_environment_module__parameter-name:
+
+ .. rst-class:: ansible-option-title
+
+ **name**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string` / :ansible-option-required:`required`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The name of the decision environment.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.decision_environment_module__parameter-new_name:
+
+ .. rst-class:: ansible-option-title
+
+ **new_name**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Setting this option will change the existing name.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.decision_environment_module__parameter-request_timeout:
+
+ .. rst-class:: ansible-option-title
+
+ **request_timeout**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`float`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Timeout in seconds for the connection with the EDA controller.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_TIMEOUT`\ environment variable will be used.
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-default-bold:`Default:` :ansible-option-default:`10.0`
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.decision_environment_module__parameter-state:
+
+ .. rst-class:: ansible-option-title
+
+ **state**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Desired state of the resource.
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-choices:`Choices:`
+
+ - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)`
+ - :ansible-option-choices-entry:`"absent"`
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.decision_environment_module__parameter-validate_certs:
+
+ .. rst-class:: ansible-option-title
+
+ **validate_certs**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`boolean`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Whether to allow insecure connections to Ansible Automation Platform EDA Controller instance.
+
+ If \ :literal:`no`\ , SSL certificates will not be validated.
+
+ This should only be used on personally controlled sites using self-signed certificates.
+
+ If value not set, will try environment variable \ :literal:`CONTROLLER\_VERIFY\_SSL`\
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-choices:`Choices:`
+
+ - :ansible-option-choices-entry:`false`
+ - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)`
+
+
+ .. raw:: html
+
+
+
+
+.. Attributes
+
+
+.. Notes
+
+
+.. Seealso
+
+
+.. Examples
+
+Examples
+--------
+
+.. code-block:: yaml+jinja
+
+
+ - name: Create EDA Decision Environment
+ ansible.eda.decision_environment:
+ controller_host: https://my_eda_host/
+ controller_username: admin
+ controller_password: MySuperSecretPassw0rd
+ name: "Example Decision Environment"
+ description: "Example Decision Environment description"
+ image_url: "quay.io/test"
+ credential: "Example Credential"
+ state: present
+
+ - name: Update the name of the Decision Environment
+ ansible.eda.decision_environment:
+ controller_host: https://my_eda_host/
+ controller_username: admin
+ controller_password: MySuperSecretPassw0rd
+ name: "Example Decision Environment"
+ new_name: "Latest Example Decision Environment"
+ state: present
+
+ - name: Delete the the Decision Environment
+ ansible.eda.decision_environment:
+ controller_host: https://my_eda_host/
+ controller_username: admin
+ controller_password: MySuperSecretPassw0rd
+ name: "Example Decision Environment"
+ state: absent
+
+
+
+
+.. Facts
+
+
+.. Return values
+
+Return Values
+-------------
+Common return values are documented :ref:`here `, the following are the fields unique to this module:
+
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
+
+.. list-table::
+ :width: 100%
+ :widths: auto
+ :header-rows: 1
+ :class: longtable ansible-option-table
+
+ * - Key
+ - Description
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.decision_environment_module__return-id:
+
+ .. rst-class:: ansible-option-title
+
+ **id**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`integer`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ ID of the decision environment
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-returned-bold:`Returned:` when exists
+
+ .. rst-class:: ansible-option-line
+ .. rst-class:: ansible-option-sample
+
+ :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`37`
+
+
+ .. raw:: html
+
+
+
+
+
+.. Status (Presently only deprecated)
+
+
+.. Authors
+
+Authors
+~~~~~~~
+
+- Nikhil Jain (@jainnikhil30)
+- Abhijeet Kasurde (@akasurde)
+
+
+
+.. Extra links
+
+Collection links
+~~~~~~~~~~~~~~~~
+
+.. ansible-links::
+
+ - title: "Issue Tracker"
+ url: "https://github.com/ansible/event-driven-ansible/issues"
+ external: true
+ - title: "Homepage"
+ url: "http://ansible.com/event-driven"
+ external: true
+ - title: "Repository (Sources)"
+ url: "https://github.com/ansible/event-driven-ansible"
+ external: true
+
+
+.. Parsing errors
+
diff --git a/docs/rst/environment_variables.rst b/docs/rst/environment_variables.rst
new file mode 100644
index 00000000..3007982b
--- /dev/null
+++ b/docs/rst/environment_variables.rst
@@ -0,0 +1,15 @@
+
+:orphan:
+
+.. meta::
+ :antsibull-docs: 2.12.0
+
+.. _list_of_collection_env_vars:
+
+Index of all Collection Environment Variables
+=============================================
+
+The following index documents all environment variables declared by plugins in collections.
+Environment variables used by the ansible-core configuration are documented in :ref:`ansible_configuration_settings`.
+
+No environment variables have been defined.
diff --git a/docs/rst/index.rst b/docs/rst/index.rst
new file mode 100644
index 00000000..8d6a13d6
--- /dev/null
+++ b/docs/rst/index.rst
@@ -0,0 +1,89 @@
+
+
+.. meta::
+ :antsibull-docs: 2.12.0
+
+
+.. _plugins_in_ansible.eda:
+
+Ansible.Eda
+===========
+
+Collection version 1.4.7
+
+.. contents::
+ :local:
+ :depth: 1
+
+Description
+-----------
+
+Event-Driven Ansible
+
+**Authors:**
+
+* bthomass@redhat.com
+* jpisciot@redhat.com
+
+**Supported ansible-core versions:**
+
+* 2.15.0 or newer
+
+.. ansible-links::
+
+ - title: "Issue Tracker"
+ url: "https://github.com/ansible/event-driven-ansible/issues"
+ external: true
+ - title: "Homepage"
+ url: "http://ansible.com/event-driven"
+ external: true
+ - title: "Repository (Sources)"
+ url: "https://github.com/ansible/event-driven-ansible"
+ external: true
+
+
+
+
+.. toctree::
+ :maxdepth: 1
+
+Plugin Index
+------------
+
+These are the plugins in the ansible.eda collection:
+
+
+Modules
+~~~~~~~
+
+* :ansplugin:`activation module ` -- Manage rulebook activations in the EDA Controller
+* :ansplugin:`activation_info module ` -- List rulebook activations in the EDA Controller
+* :ansplugin:`controller_token module ` -- Manage AWX tokens in EDA controller
+* :ansplugin:`credential module ` -- Manage credentials in EDA Controller
+* :ansplugin:`credential_info module ` -- List credentials in the EDA Controller
+* :ansplugin:`credential_type module ` -- Manage credential types in EDA Controller
+* :ansplugin:`credential_type_info module ` -- List credential types in EDA Controller
+* :ansplugin:`decision_environment module ` -- Create, update or delete decision environment in EDA Controller
+* :ansplugin:`decision_environment_info module ` -- List a decision environment in EDA Controller
+* :ansplugin:`project module ` -- Create, update or delete project in EDA Controller
+* :ansplugin:`project_info module ` -- List projects in EDA Controller
+* :ansplugin:`user module ` -- Manage users in EDA controller
+
+.. toctree::
+ :maxdepth: 1
+ :hidden:
+
+ activation_module
+ activation_info_module
+ controller_token_module
+ credential_module
+ credential_info_module
+ credential_type_module
+ credential_type_info_module
+ decision_environment_module
+ decision_environment_info_module
+ project_module
+ project_info_module
+ user_module
+
+
diff --git a/docs/rst/project_info_module.rst b/docs/rst/project_info_module.rst
new file mode 100644
index 00000000..f8fe8d3e
--- /dev/null
+++ b/docs/rst/project_info_module.rst
@@ -0,0 +1,462 @@
+
+.. Document meta
+
+:orphan:
+
+.. |antsibull-internal-nbsp| unicode:: 0xA0
+ :trim:
+
+.. meta::
+ :antsibull-docs: 2.12.0
+
+.. Anchors
+
+.. _ansible_collections.ansible.eda.project_info_module:
+
+.. Anchors: short name for ansible.builtin
+
+.. Title
+
+ansible.eda.project_info module -- List projects in EDA Controller
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+.. Collection note
+
+.. note::
+ This module is part of the `ansible.eda collection `_ (version 1.4.7).
+
+ It is not included in ``ansible-core``.
+ To check whether it is installed, run :code:`ansible-galaxy collection list`.
+
+ To install it, use: :code:`ansible-galaxy collection install ansible.eda`.
+
+ To use it in a playbook, specify: :code:`ansible.eda.project_info`.
+
+.. version_added
+
+.. rst-class:: ansible-version-added
+
+New in ansible.eda 2.0.0
+
+.. contents::
+ :local:
+ :depth: 1
+
+.. Deprecated
+
+
+Synopsis
+--------
+
+.. Description
+
+- This module allows user to list project in a EDA controller.
+
+
+.. Aliases
+
+
+.. Requirements
+
+
+
+
+
+
+.. Options
+
+Parameters
+----------
+
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
+
+.. list-table::
+ :width: 100%
+ :widths: auto
+ :header-rows: 1
+ :class: longtable ansible-option-table
+
+ * - Parameter
+ - Comments
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.project_info_module__parameter-controller_host:
+
+ .. rst-class:: ansible-option-title
+
+ **controller_host**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string` / :ansible-option-required:`required`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The URL of the EDA controller.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_URL`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.project_info_module__parameter-controller_password:
+
+ .. rst-class:: ansible-option-title
+
+ **controller_password**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Password used for authentication.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_PASSWORD`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.project_info_module__parameter-controller_username:
+
+ .. rst-class:: ansible-option-title
+
+ **controller_username**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Username used for authentication.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_USERNAME`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.project_info_module__parameter-name:
+
+ .. rst-class:: ansible-option-title
+
+ **name**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The name of the project.
+
+ Return information about particular project available on EDA Controller.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.project_info_module__parameter-request_timeout:
+
+ .. rst-class:: ansible-option-title
+
+ **request_timeout**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`float`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Timeout in seconds for the connection with the EDA controller.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_TIMEOUT`\ environment variable will be used.
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-default-bold:`Default:` :ansible-option-default:`10.0`
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.project_info_module__parameter-validate_certs:
+
+ .. rst-class:: ansible-option-title
+
+ **validate_certs**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`boolean`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Whether to allow insecure connections to Ansible Automation Platform EDA Controller instance.
+
+ If \ :literal:`no`\ , SSL certificates will not be validated.
+
+ This should only be used on personally controlled sites using self-signed certificates.
+
+ If value not set, will try environment variable \ :literal:`CONTROLLER\_VERIFY\_SSL`\
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-choices:`Choices:`
+
+ - :ansible-option-choices-entry:`false`
+ - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)`
+
+
+ .. raw:: html
+
+
+
+
+.. Attributes
+
+
+.. Notes
+
+
+.. Seealso
+
+
+.. Examples
+
+Examples
+--------
+
+.. code-block:: yaml+jinja
+
+
+ - name: List a particular project
+ ansible.eda.project_info:
+ controller_host: https://my_eda_host/
+ controller_username: admin
+ controller_password: MySuperSecretPassw0rd
+ name: "Example"
+ register: r
+
+ - name: List all projects
+ ansible.eda.project_info:
+ controller_host: https://my_eda_host/
+ controller_username: admin
+ controller_password: MySuperSecretPassw0rd
+ register: r
+
+
+
+
+.. Facts
+
+
+.. Return values
+
+Return Values
+-------------
+Common return values are documented :ref:`here `, the following are the fields unique to this module:
+
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
+
+.. list-table::
+ :width: 100%
+ :widths: auto
+ :header-rows: 1
+ :class: longtable ansible-option-table
+
+ * - Key
+ - Description
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.project_info_module__return-projects:
+
+ .. rst-class:: ansible-option-title
+
+ **projects**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`list` / :ansible-option-elements:`elements=string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ List of dicts containing information about projects
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-returned-bold:`Returned:` success
+
+ .. rst-class:: ansible-option-line
+ .. rst-class:: ansible-option-sample
+
+ :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`[{"created\_at": "2024-08-12T20:35:28.367702Z", "description": "", "eda\_credential\_id": null, "git\_hash": "417b4dbe9b3472fd64212ef8233b865585e5ade3", "id": 17, "import\_error": null, "import\_state": "completed", "modified\_at": "2024-08-12T20:35:28.367724Z", "name": "Sample Example Project", "organization\_id": 1, "proxy": "", "scm\_branch": "", "scm\_refspec": "", "scm\_type": "git", "signature\_validation\_credential\_id": null, "url": "https://github.com/ansible/ansible-ui", "verify\_ssl": true}]`
+
+
+ .. raw:: html
+
+
+
+
+
+.. Status (Presently only deprecated)
+
+
+.. Authors
+
+Authors
+~~~~~~~
+
+- Abhijeet Kasurde (@akasurde)
+
+
+
+.. Extra links
+
+Collection links
+~~~~~~~~~~~~~~~~
+
+.. ansible-links::
+
+ - title: "Issue Tracker"
+ url: "https://github.com/ansible/event-driven-ansible/issues"
+ external: true
+ - title: "Homepage"
+ url: "http://ansible.com/event-driven"
+ external: true
+ - title: "Repository (Sources)"
+ url: "https://github.com/ansible/event-driven-ansible"
+ external: true
+
+
+.. Parsing errors
+
diff --git a/docs/rst/project_module.rst b/docs/rst/project_module.rst
new file mode 100644
index 00000000..9c2ec27d
--- /dev/null
+++ b/docs/rst/project_module.rst
@@ -0,0 +1,593 @@
+
+.. Document meta
+
+:orphan:
+
+.. |antsibull-internal-nbsp| unicode:: 0xA0
+ :trim:
+
+.. meta::
+ :antsibull-docs: 2.12.0
+
+.. Anchors
+
+.. _ansible_collections.ansible.eda.project_module:
+
+.. Anchors: short name for ansible.builtin
+
+.. Title
+
+ansible.eda.project module -- Create, update or delete project in EDA Controller
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+.. Collection note
+
+.. note::
+ This module is part of the `ansible.eda collection `_ (version 1.4.7).
+
+ It is not included in ``ansible-core``.
+ To check whether it is installed, run :code:`ansible-galaxy collection list`.
+
+ To install it, use: :code:`ansible-galaxy collection install ansible.eda`.
+
+ To use it in a playbook, specify: :code:`ansible.eda.project`.
+
+.. version_added
+
+.. rst-class:: ansible-version-added
+
+New in ansible.eda 2.0.0
+
+.. contents::
+ :local:
+ :depth: 1
+
+.. Deprecated
+
+
+Synopsis
+--------
+
+.. Description
+
+- This module allows user to create, update or delete project in a EDA controller.
+
+
+.. Aliases
+
+
+.. Requirements
+
+
+
+
+
+
+.. Options
+
+Parameters
+----------
+
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
+
+.. list-table::
+ :width: 100%
+ :widths: auto
+ :header-rows: 1
+ :class: longtable ansible-option-table
+
+ * - Parameter
+ - Comments
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.project_module__parameter-controller_host:
+
+ .. rst-class:: ansible-option-title
+
+ **controller_host**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string` / :ansible-option-required:`required`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The URL of the EDA controller.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_URL`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.project_module__parameter-controller_password:
+
+ .. rst-class:: ansible-option-title
+
+ **controller_password**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Password used for authentication.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_PASSWORD`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.project_module__parameter-controller_username:
+
+ .. rst-class:: ansible-option-title
+
+ **controller_username**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Username used for authentication.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_USERNAME`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.project_module__parameter-credential:
+
+ .. rst-class:: ansible-option-title
+
+ **credential**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The name of the credential to associate with the project.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.project_module__parameter-description:
+
+ .. rst-class:: ansible-option-title
+
+ **description**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The description of the project.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.project_module__parameter-name:
+
+ .. rst-class:: ansible-option-title
+
+ **name**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string` / :ansible-option-required:`required`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The name of the project.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.project_module__parameter-new_name:
+
+ .. rst-class:: ansible-option-title
+
+ **new_name**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Setting this option will change the existing name.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.project_module__parameter-request_timeout:
+
+ .. rst-class:: ansible-option-title
+
+ **request_timeout**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`float`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Timeout in seconds for the connection with the EDA controller.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_TIMEOUT`\ environment variable will be used.
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-default-bold:`Default:` :ansible-option-default:`10.0`
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.project_module__parameter-state:
+
+ .. rst-class:: ansible-option-title
+
+ **state**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Desired state of the resource.
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-choices:`Choices:`
+
+ - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)`
+ - :ansible-option-choices-entry:`"absent"`
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.project_module__parameter-url:
+
+ .. rst-class:: ansible-option-title
+
+ **url**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The git URL of the project.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.project_module__parameter-validate_certs:
+
+ .. rst-class:: ansible-option-title
+
+ **validate_certs**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`boolean`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Whether to allow insecure connections to Ansible Automation Platform EDA Controller instance.
+
+ If \ :literal:`no`\ , SSL certificates will not be validated.
+
+ This should only be used on personally controlled sites using self-signed certificates.
+
+ If value not set, will try environment variable \ :literal:`CONTROLLER\_VERIFY\_SSL`\
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-choices:`Choices:`
+
+ - :ansible-option-choices-entry:`false`
+ - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)`
+
+
+ .. raw:: html
+
+
+
+
+.. Attributes
+
+
+.. Notes
+
+
+.. Seealso
+
+
+.. Examples
+
+Examples
+--------
+
+.. code-block:: yaml+jinja
+
+
+ - name: Create EDA Projects
+ ansible.eda.project:
+ controller_host: https://my_eda_host/
+ controller_username: admin
+ controller_password: MySuperSecretPassw0rd
+ name: "Example Project"
+ description: "Example project description"
+ url: "https://example.com/project1"
+ state: present
+
+ - name: Update the name of the project
+ ansible.eda.project:
+ controller_host: https://my_eda_host/
+ controller_username: admin
+ controller_password: MySuperSecretPassw0rd
+ name: "Example Project"
+ new_name: "Latest Example Project"
+ description: "Example project description"
+ url: "https://example.com/project1"
+ state: present
+
+ - name: Delete the project
+ ansible.eda.project:
+ controller_host: https://my_eda_host/
+ controller_username: admin
+ controller_password: MySuperSecretPassw0rd
+ name: "Example Project"
+ state: absent
+
+
+
+
+.. Facts
+
+
+.. Return values
+
+
+.. Status (Presently only deprecated)
+
+
+.. Authors
+
+Authors
+~~~~~~~
+
+- Nikhil Jain (@jainnikhil30)
+- Abhijeet Kasurde (@akasurde)
+
+
+
+.. Extra links
+
+Collection links
+~~~~~~~~~~~~~~~~
+
+.. ansible-links::
+
+ - title: "Issue Tracker"
+ url: "https://github.com/ansible/event-driven-ansible/issues"
+ external: true
+ - title: "Homepage"
+ url: "http://ansible.com/event-driven"
+ external: true
+ - title: "Repository (Sources)"
+ url: "https://github.com/ansible/event-driven-ansible"
+ external: true
+
+
+.. Parsing errors
+
diff --git a/docs/rst/user_module.rst b/docs/rst/user_module.rst
new file mode 100644
index 00000000..b8ec7ccb
--- /dev/null
+++ b/docs/rst/user_module.rst
@@ -0,0 +1,779 @@
+
+.. Document meta
+
+:orphan:
+
+.. |antsibull-internal-nbsp| unicode:: 0xA0
+ :trim:
+
+.. meta::
+ :antsibull-docs: 2.12.0
+
+.. Anchors
+
+.. _ansible_collections.ansible.eda.user_module:
+
+.. Anchors: short name for ansible.builtin
+
+.. Title
+
+ansible.eda.user module -- Manage users in EDA controller
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+.. Collection note
+
+.. note::
+ This module is part of the `ansible.eda collection `_ (version 1.4.7).
+
+ It is not included in ``ansible-core``.
+ To check whether it is installed, run :code:`ansible-galaxy collection list`.
+
+ To install it, use: :code:`ansible-galaxy collection install ansible.eda`.
+
+ To use it in a playbook, specify: :code:`ansible.eda.user`.
+
+.. version_added
+
+.. rst-class:: ansible-version-added
+
+New in ansible.eda 2.0.0
+
+.. contents::
+ :local:
+ :depth: 1
+
+.. Deprecated
+
+
+Synopsis
+--------
+
+.. Description
+
+- This module allows the user to create, update or delete users in a EDA controller.
+
+
+.. Aliases
+
+
+.. Requirements
+
+
+
+
+
+
+.. Options
+
+Parameters
+----------
+
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
+
+.. list-table::
+ :width: 100%
+ :widths: auto
+ :header-rows: 1
+ :class: longtable ansible-option-table
+
+ * - Parameter
+ - Comments
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.user_module__parameter-controller_host:
+
+ .. rst-class:: ansible-option-title
+
+ **controller_host**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string` / :ansible-option-required:`required`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The URL of the EDA controller.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_URL`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.user_module__parameter-controller_password:
+
+ .. rst-class:: ansible-option-title
+
+ **controller_password**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Password used for authentication.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_PASSWORD`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.user_module__parameter-controller_username:
+
+ .. rst-class:: ansible-option-title
+
+ **controller_username**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Username used for authentication.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_USERNAME`\ environment variable will be used.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.user_module__parameter-email:
+
+ .. rst-class:: ansible-option-title
+
+ **email**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Email address of the user.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.user_module__parameter-first_name:
+
+ .. rst-class:: ansible-option-title
+
+ **first_name**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ First name of the user.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.user_module__parameter-is_superuser:
+
+ .. rst-class:: ansible-option-title
+
+ **is_superuser**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`boolean`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Make user as superuser.
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-choices:`Choices:`
+
+ - :ansible-option-choices-entry-default:`false` :ansible-option-choices-default-mark:`← (default)`
+ - :ansible-option-choices-entry:`true`
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.user_module__parameter-last_name:
+
+ .. rst-class:: ansible-option-title
+
+ **last_name**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Last name of the user.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.user_module__parameter-new_username:
+
+ .. rst-class:: ansible-option-title
+
+ **new_username**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Setting this option will change the existing username.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.user_module__parameter-password:
+
+ .. rst-class:: ansible-option-title
+
+ **password**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Write-only field used to change the password.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.user_module__parameter-request_timeout:
+
+ .. rst-class:: ansible-option-title
+
+ **request_timeout**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`float`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Timeout in seconds for the connection with the EDA controller.
+
+ If not set, the value of the \ :literal:`CONTROLLER\_TIMEOUT`\ environment variable will be used.
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-default-bold:`Default:` :ansible-option-default:`10.0`
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.user_module__parameter-state:
+
+ .. rst-class:: ansible-option-title
+
+ **state**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Desired state of the resource.
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-choices:`Choices:`
+
+ - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)`
+ - :ansible-option-choices-entry:`"absent"`
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.user_module__parameter-update_secrets:
+
+ .. rst-class:: ansible-option-title
+
+ **update_secrets**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`boolean`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ \ :ansval:`true`\ will always change password if user specifies password, even if API gives $encrypted$ for password.
+
+ \ :ansval:`false`\ will only set the password if other values change too.
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-choices:`Choices:`
+
+ - :ansible-option-choices-entry:`false`
+ - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)`
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.user_module__parameter-username:
+
+ .. rst-class:: ansible-option-title
+
+ **username**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string` / :ansible-option-required:`required`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ The name of the user.
+
+ 150 characters or fewer.
+
+ Name can contain letters, digits and ('@', '.', '+', '-', '\_') only.
+
+
+ .. raw:: html
+
+
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.user_module__parameter-validate_certs:
+
+ .. rst-class:: ansible-option-title
+
+ **validate_certs**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`boolean`
+
+ :ansible-option-versionadded:`added in ansible.eda 2.0.0`
+
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ Whether to allow insecure connections to Ansible Automation Platform EDA Controller instance.
+
+ If \ :literal:`no`\ , SSL certificates will not be validated.
+
+ This should only be used on personally controlled sites using self-signed certificates.
+
+ If value not set, will try environment variable \ :literal:`CONTROLLER\_VERIFY\_SSL`\
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-choices:`Choices:`
+
+ - :ansible-option-choices-entry:`false`
+ - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)`
+
+
+ .. raw:: html
+
+
+
+
+.. Attributes
+
+
+.. Notes
+
+
+.. Seealso
+
+
+.. Examples
+
+Examples
+--------
+
+.. code-block:: yaml+jinja
+
+
+ - name: Create EDA user
+ ansible.eda.user:
+ controller_host: https://my_eda_host/
+ controller_username: admin
+ controller_password: MySuperSecretPassw0rd
+ username: "test_collection_user"
+ first_name: "Test Collection User"
+ last_name: "Test Collection User"
+ email: "test@test.com"
+ password: "test"
+ is_superuser: True
+ state: present
+ no_log: true
+
+ - name: Delete user
+ ansible.eda.user:
+ controller_host: https://my_eda_host/
+ controller_username: admin
+ controller_password: MySuperSecretPassw0rd
+ username: "test_collection_user"
+ state: absent
+
+ - name: Update the username
+ ansible.eda.user:
+ username: "test_collection_user"
+ new_username: "test_collection_user_updated"
+ first_name: "Test Collection User"
+ last_name: "Test Collection User"
+ email: "test@test.com"
+ password: "test"
+
+
+
+
+.. Facts
+
+
+.. Return values
+
+Return Values
+-------------
+Common return values are documented :ref:`here `, the following are the fields unique to this module:
+
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
+
+.. list-table::
+ :width: 100%
+ :widths: auto
+ :header-rows: 1
+ :class: longtable ansible-option-table
+
+ * - Key
+ - Description
+
+ * - .. raw:: html
+
+
+
+
+ .. _ansible_collections.ansible.eda.user_module__return-id:
+
+ .. rst-class:: ansible-option-title
+
+ **id**
+
+ .. raw:: html
+
+
+
+ .. ansible-option-type-line::
+
+ :ansible-option-type:`string`
+
+ .. raw:: html
+
+
+
+ - .. raw:: html
+
+
+
+ ID of the managed AWX token.
+
+
+ .. rst-class:: ansible-option-line
+
+ :ansible-option-returned-bold:`Returned:` when state is 'present' and successful
+
+ .. rst-class:: ansible-option-line
+ .. rst-class:: ansible-option-sample
+
+ :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`"123"`
+
+
+ .. raw:: html
+
+
+
+
+
+.. Status (Presently only deprecated)
+
+
+.. Authors
+
+Authors
+~~~~~~~
+
+- Nikhil Jain (@jainnikhil30)
+- Abhijeet Kasurde (@akasurde)
+
+
+
+.. Extra links
+
+Collection links
+~~~~~~~~~~~~~~~~
+
+.. ansible-links::
+
+ - title: "Issue Tracker"
+ url: "https://github.com/ansible/event-driven-ansible/issues"
+ external: true
+ - title: "Homepage"
+ url: "http://ansible.com/event-driven"
+ external: true
+ - title: "Repository (Sources)"
+ url: "https://github.com/ansible/event-driven-ansible"
+ external: true
+
+
+.. Parsing errors
+
diff --git a/tox.ini b/tox.ini
index e899acc6..fcdef096 100644
--- a/tox.ini
+++ b/tox.ini
@@ -4,12 +4,19 @@
# cspell: ignore TOXPYTHON setenv passenv REQPASS PYTHONPYCACHEPREFIX PYTHONIOENCODING PYTHONBREAKPOINT notest envdir envname toxworkdir junitxml
[tox]
-envlist = lint, darglint, unit, sanity, integration, coverage
+envlist =
+ lint
+ darglint
+ docs
+ unit
+ sanity
+ integration
+ coverage
skipsdist = true # this repo is not a python package
isolated_build = true
requires =
tox >= 4.6.3
- tox-extra >= 2.0.0 # bindep check
+ ; tox-extra >= 2.0.0 # bindep check
setuptools >= 65.3.0 # editable installs
[testenv]
@@ -113,3 +120,17 @@ commands =
ansible-test coverage combine --export={envdir}
# produces tests/output/reports/coverage.xml
ansible-test coverage xml --requirements
+
+[testenv:docs]
+description = Generate plugins documentation under /docs directory using antsibull-docs
+deps =
+ ansible-core
+ -r docs/requirements.txt
+commands_pre =
+ ansible-galaxy collection install .
+commands =
+ antsibull-docs sphinx-init --use-current --squash-hierarchy ansible.eda --dest-dir docs
+ bash ./docs/build.sh
+allowlist_externals =
+ mkdir
+ bash