Salted Jira

Salted Jira provides the power of Salt directly from within your Jira workflows.

Salted Jira User Guide

1. Install salt-master and salt-api on your machine

2. Login to your Jira, go to “Jira administration” page, go to “Manage apps”, and install the “Jira Salt API Plugin”.

3. On the left side, under the "Other" section, the "Salted Jira Admin" button will appear.

4. Click on it, or navigate to "jira/plugins/servlets/salted/jira/admin" URL.

5. You will see a Bamboo Salt Configuration page. You should populate the information about your salt-master URL, port, username, and password. See the example below.

6. To test the connection to your salt-master, push the "Test Connection" button. If you passed the right credentials about your salt-master API you will receive a token. You can use that token for salt-master operations. Otherwise, credentials are wrong or the salt-master is not bootstrapped.

7. Click the "Save" button to save credentials to your salt-master. This action is required. You will see a success message if credentials are right and the salt-master is up.

8. Click on the "Settings" button, and open the "Issues" page. On the left side, open the "Workflow" page. Click "Edit" near your workflow. You will see your workflow config page. Click on Transition that you want to add a post-function or create a new Transition.

9. Open the "Post Functions" tab and click "Add Post Function" on the right side of the page.

10. Choose a "Salt API Issue Post Function". Then click "Add".

11. Add parameters to post function. Post function will execute Salt State function, so provide info about Target, Execution Module, and Argument like in the example below. Click "Add" to finish.

12. You will see a “Execute Salt API function” in a list of post-functions. You can edit parameters anytime by clicking the “Edit” (pencil) button.

13. Click “Publish” at the top of the page to finish the configuration of the workflow.

14. Open your project in Jira and choose any issue that has a status that related to your Transition. You will see a button that describes your Transition. To execute the post function, click on the button. In example below, it is a “Done” button.

15. You will see the result of the execution Salt State function in comments of the Jira Issue that you are working with.

16. After Salt Job has finished execution, you will see one more comment with the result of the execution.

17. Open configuration of your workflow, open transition page and choose “Add post function”. In new page, choose the “Run Salt Orchestration”post function.

18. In next page, please provide an Orchestration State like below.

19. Click Update. After that, publish your workflow and visit an issue that you want to test. Please make sure that the issue has a transition that has post function. Click on a transition button so status will be changed and Run Orchestration will be triggered. After some time, you will see a Worklog in your issue with result of orchestration.