adds ansible_navigator_run data source

.golangci.yml

@@ -22,4 +22,6 @@ linters:
 
 linters-settings:
   varnamelen:
+    ignore-type-assert-ok: true
     ignore-map-index-ok: true
+    ignore-chan-recv-ok: true

docs/data-sources/navigator_run.md

@@ -0,0 +1,92 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "ansible_navigator_run Data Source - terraform-provider-ansible"
+subcategory: ""
+description: |-
+  Run an Ansible playbook. Recommended to only run playbooks without observable side-effects. Requires ansible-navigator and a container engine to run within an execution environment (EE).
+---
+
+# ansible_navigator_run (Data Source)
+
+Run an Ansible playbook. Recommended to only run playbooks without observable side-effects. Requires `ansible-navigator` and a container engine to run within an execution environment (EE).
+
+
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `inventory` (String) Ansible [inventory](https://docs.ansible.com/ansible/latest/getting_started/get_started_inventory.html) contents.
+- `playbook` (String) Ansible [playbook](https://docs.ansible.com/ansible/latest/playbook_guide/playbooks_intro.html) contents.
+
+### Optional
+
+- `ansible_navigator_binary` (String) Path to the `ansible-navigator` binary. By default `$PATH` is searched.
+- `ansible_options` (Attributes) Ansible [playbook](https://docs.ansible.com/ansible/latest/cli/ansible-playbook.html) run related configuration. (see [below for nested schema](#nestedatt--ansible_options))
+- `artifact_queries` (Attributes Map) Query the playbook artifact with [JSONPath](https://goessner.net/articles/JsonPath/). The [playbook artifact](https://access.redhat.com/documentation/en-us/red_hat_ansible_automation_platform/2.0-ea/html/ansible_navigator_creator_guide/assembly-troubleshooting-navigator_ansible-navigator#proc-review-artifact_troubleshooting-navigator) contains detailed information about every play and task, as well as the stdout from the playbook run. (see [below for nested schema](#nestedatt--artifact_queries))
+- `execution_environment` (Attributes) [Execution environment](https://ansible.readthedocs.io/en/latest/getting_started_ee/index.html) (EE) related configuration. (see [below for nested schema](#nestedatt--execution_environment))
+- `timeouts` (Attributes) (see [below for nested schema](#nestedatt--timeouts))
+- `timezone` (String) IANA time zone, use `local` for the system time zone. Defaults to `UTC`.
+- `working_directory` (String) Directory which `ansible-navigator` is run from. Recommended to be the root Ansible [content directory](https://docs.ansible.com/ansible/latest/tips_tricks/sample_setup.html#sample-directory-layout) (sometimes called the project directory), which is likely to contain `ansible.cfg`, `roles/`, etc.
+
+### Read-Only
+
+- `command` (String) Generated `ansible-navigator` run command. Useful for troubleshooting.
+- `id` (String) UUID.
+
+<a id="nestedatt--ansible_options"></a>
+### Nested Schema for `ansible_options`
+
+Optional:
+
+- `force_handlers` (Boolean) Run handlers even if a task fails.
+- `limit` (List of String) Further limit selected hosts to an additional pattern.
+- `private_keys` (Attributes List) SSH private keys used for authentication in addition to the [automatically mounted](https://ansible.readthedocs.io/projects/navigator/faq/#how-do-i-use-my-ssh-keys-with-an-execution-environment) default named keys and SSH agent socket path. (see [below for nested schema](#nestedatt--ansible_options--private_keys))
+- `skip_tags` (List of String) Only run plays and tasks whose tags do not match these values.
+- `start_at_task` (String) Start the playbook at the task matching this name.
+- `tags` (List of String) Only run plays and tasks tagged with these values.
+
+<a id="nestedatt--ansible_options--private_keys"></a>
+### Nested Schema for `ansible_options.private_keys`
+
+Required:
+
+- `data` (String, Sensitive) Key data.
+- `name` (String) Key name.
+
+
+
+<a id="nestedatt--artifact_queries"></a>
+### Nested Schema for `artifact_queries`
+
+Required:
+
+- `jsonpath` (String) JSONPath expression.
+
+Read-Only:
+
+- `result` (String) Result of the query. Result may be empty if a field or map key cannot be located.
+
+
+<a id="nestedatt--execution_environment"></a>
+### Nested Schema for `execution_environment`
+
+Optional:
+
+- `container_engine` (String) [Container engine](https://ansible.readthedocs.io/projects/navigator/settings/#container-engine) responsible for running the execution environment container image. Options: `podman`, `docker`, `auto`. Defaults to `auto`.
+- `container_options` (List of String) [Extra parameters](https://ansible.readthedocs.io/projects/navigator/settings/#container-options) passed to the container engine command.
+- `enabled` (Boolean) Enable or disable the use of an execution environment. Disabling requires `ansible-playbook` and is only recommended when without a container engine. Defaults to `true`.
+- `environment_variables_pass` (List of String) Existing environment variables to be [passed](https://ansible.readthedocs.io/projects/navigator/settings/#pass-environment-variable) through to and set within the execution environment.
+- `environment_variables_set` (Map of String) Environment variables to be [set](https://ansible.readthedocs.io/projects/navigator/settings/#set-environment-variable) within the execution environment. By default `ANSIBLE_TF_OPERATION` is set to `read`.
+- `image` (String) Name of the execution environment container [image](https://ansible.readthedocs.io/projects/navigator/settings/#execution-environment-image). Defaults to `ghcr.io/ansible/community-ansible-dev-tools:v24.7.2`.
+- `pull_arguments` (List of String) Additional [parameters](https://ansible.readthedocs.io/projects/navigator/settings/#pull-arguments) that should be added to the pull command when pulling an execution environment container image from a container registry.
+- `pull_policy` (String) Container image [pull policy](https://ansible.readthedocs.io/projects/navigator/settings/#pull-policy). Defaults to `tag`.
+
+
+<a id="nestedatt--timeouts"></a>
+### Nested Schema for `timeouts`
+
+Optional:
+
+- `read` (String) A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).