Chapter 15. Integrating with Jira

Procedure

1. In the RHACS portal, go to Platform Configuration Integrations.
2. Scroll down to the Notifier Integrations section and select Jira Software.
3. Click New integration.
4. Enter a name for Integration name.
5. Enter the user credentials in the Username and Password or API token fields.
6. For Issue type, enter a valid Jira Issue Type, for example Task, Sub-task, or Bug.
7. Enter the Jira server URL in the Jira URL field.
8. Enter the key of the project in which you want to create issues in the Default project field.

9. Optional: Use the Annotation key for project field to create issues in different Jira projects by completing the following steps. You can use annotations to dynamically create issues.

   1. Add an annotation similar to the following example in your namespace or deployment YAML file, where jira/project-key is the annotation key that you specify in your Jira integration. You can create an annotation for the deployment or the namespace.

      annotations:
      # ...
        jira/project-key: <jira_project_key>
      # ...

   2. Use the annotation key jira/project-key in the Annotation key for project field.
10. If you use custom priorities in your Jira project, use the Priority Mapping toggle to configure custom priorities.

11. If you use mandatory custom fields in your Jira project, enter them as JSON values in the Default Fields JSON field. For example:

    {
      "customfield_10004": 3,
      "customfield_20005": "Alerts",
    }

12. Select Test to test that the integration with Jira is working.
13. Select Create to generate the configuration.

Procedure

1. In the RHACS portal, go to Platform Configuration Policy Management.
2. Select one or more policies for which you want to send alerts.
3. Under Bulk actions, select Enable notification.

4. In the Enable notification window, select the Jira notifier.

   Note

   If you have not configured any other integrations, the system displays a message that no notifiers are configured.

5. Click Enable.

Procedure

1. To get the custom priority values from your JIRA project, run the following command to turn on debug logging for JIRA integration:

   $ roxctl -e "$ROX_CENTRAL_ADDRESS" central debug log --level Debug --modules notifiers/jira

2. Follow the instructions to configure Red Hat Advanced Cluster Security for Kubernetes for Jira integration. When you test the integration, even if the integration test fails, the generated log includes your JIRA project schema and the custom priorities.

3. To save the debugging information as a compressed .zip file, run the following command:

   $ roxctl -e "$ROX_CENTRAL_ADDRESS" central debug dump

4. Unzip the .zip file to retrieve the custom priority values in use in your JIRA project.

5. To turn off debug logging, run the following command:

   $ roxctl -e "$ROX_CENTRAL_ADDRESS" central debug log --level Info

6. Configure Red Hat Advanced Cluster Security for Kubernetes for Jira integration again and use the priority values to configure custom priorities.