Role Name: lookforjira
======================

This role retrieves and displays Jira issue details from a configured Jira instance using the REST API.

Requirements
------------

- Ansible 2.10 or higher
- `community.general` collection (version 3.0.0 or higher)
- Network access to the Jira instance
- Valid Jira API token for authentication

Role Variables
--------------

### Required Variables

- `lookforjira_issue_key`: Jira issue number (e.g., `725` or `ILI-725`)

### Optional Variables

- `lookforjira_host`: Jira URL (default: `https://jira.EXAMPLE-CORP.COM`)
- `lookforjira_validate_certs`: Validate SSL (default: `true`)
- `lookforjira_custom_field_itsm_id`: ITSM field ID (default: `customfield_11414`)

### Vaulted Variables (in vars/main.yml)

- `lookforjira_api_token`: API token (stored encrypted with ansible-vault)

Dependencies
------------

- `community.general`: Required for the `jira` module

Example Playbook
----------------

```yaml
---
- name: Lookup Jira Issue
  hosts: localhost
  gather_facts: false
  
  vars:
    lookforjira_host: https://jira.example.com
    lookforjira_api_token: "{{ vault_jira_token }}"
    lookforjira_issue_key: PROJECT-123
  
  roles:
    - lookforjira
```

License
-------

GPL-2.0-or-later

Author Information
------------------

CCTA Linux Team
