|
| 1 | +--- |
| 2 | +title:"Sending the notification to Jira" |
| 3 | +description:"" |
| 4 | +group:yaml-examples |
| 5 | +sub_group:examples |
| 6 | +toc:true |
| 7 | +--- |
| 8 | + |
| 9 | +The plugin marketplace offers several freestyle steps that can be used in your Codefresh pipeline through steps. |
| 10 | + |
| 11 | +One of those steps is the[Jira Issue Manager](https://codefresh.io/steps/step/jira-issue-manager). |
| 12 | + |
| 13 | +Prerequisites |
| 14 | +*[Have a Codefresh Pipeline]({{site.baseurl}}/docs/getting-started/create-a-basic-pipeline/) set-up |
| 15 | +*[Have a Jira Account](https://www.atlassian.com/software/jira) |
| 16 | + |
| 17 | +This documentation is using the following[example](https://github.com/codefresh-contrib/jira-demo-app). You can either use the example provided to try out the Jira integration or follow along with your own application. |
| 18 | + |
| 19 | +1. You need an issue in your Jira account that you want to link to your Codefresh pipeline. If you do not have one yet, please create an issue. (Note that the project type and who is creating the issue etc. does not matter.) Alternatively, you can also create an issue first with the Jira step. However, this is not explained in this example. |
| 20 | + |
| 21 | +2. Next, add the following step to your Codefresh pipeline. In case that you are using the example, the[codefresh.yml](https://github.com/codefresh-contrib/jira-demo-app/blob/master/codefresh.yml) file is already added. |
| 22 | + |
| 23 | +{% highlight yaml %} |
| 24 | + JiraCommentCreate: |
| 25 | + title: "Add Jira Comment" |
| 26 | + type: "codefreshdemo/jira-issue-manager" |
| 27 | + stage: "deploy" |
| 28 | + arguments: |
| 29 | + JIRA_BASE_URL: '${{JIRA_BASE_URL}}' |
| 30 | + JIRA_USERNAME: '${{JIRA_USERNAME}}' |
| 31 | + JIRA_API_KEY: '${{JIRA_API_KEY}}' |
| 32 | + JIRA_ISSUE_SOURCE_FIELD: '${{JIRA_ISSUE_SOURCE_FIELD}}' |
| 33 | + ACTION: "comment_create" |
| 34 | + COMMENT_BODY: "Build number ${{CF_BUILD_URL}} finished in Codefresh" |
| 35 | +{% endhighlight yaml %} |
| 36 | + |
| 37 | +Let's look in detail at this step. |
| 38 | +- Everything up to the arguments is similar to other Codefresh steps. |
| 39 | + |
| 40 | +These arguments are required to use the step: |
| 41 | +-`JIRA_BASE_URL`: This is the url of your organisation e.g. 'https://company-name.atlassian.net' |
| 42 | +-`JIRA_USERNAME`: This is usually the e-mail that you are logged in with at Jira |
| 43 | +-`JIRA_API_KEY`: Note that you will have to create this key. The official[Atlassian documentation](https://confluence.atlassian.com/cloud/api-tokens-938839638.html) details how it can be created. |
| 44 | + |
| 45 | +Then we added these arguments for our specific step: |
| 46 | +-`JIRA_ISSUE_SOURCE_FIELD`: This is the tag that identifies your issue e.g. MKTG-102 |
| 47 | +- Within the comment, we are using a[Codefresh native variable](https://codefresh.io/docs/docs/codefresh-yaml/variables/)`CF_BUILD_URL`, which will reference your pipeline build and will allow you to search for your pipeline. |
| 48 | + |
| 49 | +All variables use the Codefresh specific variable notation ${% raw %}`{{MY_VARIABLE_EXAMPLE}}`{% endraw %}`. |
| 50 | + |
| 51 | +Since it is a new stage in your Codefresh pipeline, you want to add it at the top to your stages, e.g.: |
| 52 | + |
| 53 | +{% highlight yaml %} |
| 54 | + stages: |
| 55 | + - "clone" |
| 56 | + - "build" |
| 57 | + - "JiraCommentCreate" |
| 58 | +{% endhighlight yaml %} |
| 59 | + |
| 60 | +Note that you can[provide the variables]({{site.baseurl}}/docs/configure-ci-cd-pipeline/shared-configuration/) needed for the Jira step directly in the shared configuration. The benefits are: |
| 61 | +* You do not have to post sensitive information, such as the API key, directly in the codefresh.yml. |
| 62 | +* If you use the same step across multiple pipelines, you don't have to copy-paste the same variables. |
| 63 | + |
| 64 | +Once you run the pipeline, you should be able to see the following output or similar |
| 65 | + |
| 66 | +{% include image.html |
| 67 | +lightbox="true" |
| 68 | +file="/images/integrations/jira/codefreshpipeline.png" |
| 69 | +url="/images/integrations/jira/codefreshpipeline.png" |
| 70 | +alt="Pipeline with Jira integration" |
| 71 | +max-width="80%" |
| 72 | +%} |
| 73 | + |
| 74 | +And the comment, including the URL to the pipeline, should be added to your Jira issue: |
| 75 | + |
| 76 | +{% include image.html |
| 77 | +lightbox="true" |
| 78 | +file="/images/integrations/jira/jira-comment.png" |
| 79 | +url="/images/integrations/jira/jira-comment.png" |
| 80 | +alt="Comment in Jira" |
| 81 | +max-width="80%" |
| 82 | +%} |
| 83 | + |
| 84 | +##What to read next |
| 85 | + |
| 86 | +*[Sending notifications to Slack]({{site.baseurl}}/docs/yaml-examples/examples/sending-the-notification-to-slack/) |
| 87 | +* Have a look at other things that you can do with your Codefresh Pipeline in the[example section]({{site.baseurl}}/docs/yaml-examples/examples/) |
| 88 | +*[Create a pipeline]({{site.baseurl}}/docs/configure-ci-cd-pipeline/pipelines/) |