<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Jira apps</title>
    <description>The latest articles on DEV Community by Jira apps (@jira_apps_ee38300412d0922).</description>
    <link>https://dev.to/jira_apps_ee38300412d0922</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4250318%2Fa1083496-75b3-4ce7-a6fd-f0fb2617a4c3.png</url>
      <title>DEV Community: Jira apps</title>
      <link>https://dev.to/jira_apps_ee38300412d0922</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/jira_apps_ee38300412d0922"/>
    <language>en</language>
    <item>
      <title>How to show Argo CD deployments on Jira work items</title>
      <dc:creator>Jira apps</dc:creator>
      <pubDate>Tue, 17 Nov 2026 17:10:43 +0000</pubDate>
      <link>https://dev.to/jira_apps_ee38300412d0922/how-to-show-argo-cd-deployments-on-jira-work-items-4cdd</link>
      <guid>https://dev.to/jira_apps_ee38300412d0922/how-to-show-argo-cd-deployments-on-jira-work-items-4cdd</guid>
      <description>&lt;p&gt;"Is this ticket in production yet?" is easy to answer when a pipeline deploys your code, because Jira's deployment view is filled by tools such as GitHub Actions, Jenkins and Azure DevOps.&lt;/p&gt;

&lt;p&gt;With GitOps it stays empty. Argo CD pulls the change into the cluster, so no pipeline step ever tells Jira that a deployment happened.&lt;/p&gt;

&lt;p&gt;This article shows how to close that gap yourself, using only Argo CD's built-in notifications and Jira's Deployments API. At the end there is a ready-made app, if you would rather not maintain the pieces.&lt;/p&gt;

&lt;h2&gt;
  
  
  What you need
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Argo CD 2.3 or later. The notifications controller is included.&lt;/li&gt;
&lt;li&gt;Jira Cloud, with permission to create OAuth credentials or install an app.&lt;/li&gt;
&lt;li&gt;Commit messages that contain the work item key, for example &lt;code&gt;KAN-12 raise the timeout&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  The idea
&lt;/h2&gt;

&lt;ol&gt;
&lt;li&gt;Argo CD finishes a sync.&lt;/li&gt;
&lt;li&gt;A notification trigger fires and posts a small JSON document to a webhook.&lt;/li&gt;
&lt;li&gt;The receiver turns it into a deployment record and sends it to Jira with &lt;code&gt;POST /rest/deployments/0.1/bulk&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;Jira shows the deployment on every work item whose key appeared in the commit message.&lt;/li&gt;
&lt;/ol&gt;

&lt;h2&gt;
  
  
  Step 1: Send sync events from Argo CD
&lt;/h2&gt;

&lt;p&gt;Add a webhook service, a template and three triggers to &lt;code&gt;argocd-notifications-cm&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight yaml"&gt;&lt;code&gt;&lt;span class="na"&gt;data&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
  &lt;span class="na"&gt;service.webhook.jira&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;|&lt;/span&gt;
    &lt;span class="na"&gt;url&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;$jira-webhook-url&lt;/span&gt;
    &lt;span class="na"&gt;headers&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Authorization&lt;/span&gt;
      &lt;span class="na"&gt;value&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;$jira-webhook-auth&lt;/span&gt;
    &lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Content-Type&lt;/span&gt;
      &lt;span class="na"&gt;value&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;application/json&lt;/span&gt;

  &lt;span class="na"&gt;template.jira-deployment&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;|&lt;/span&gt;
    &lt;span class="na"&gt;webhook&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
      &lt;span class="na"&gt;jira&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
        &lt;span class="na"&gt;method&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;POST&lt;/span&gt;
        &lt;span class="na"&gt;body&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;|&lt;/span&gt;
          &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s"&gt;-&lt;/span&gt; &lt;span class="s"&gt;$rev&lt;/span&gt; &lt;span class="s"&gt;:=&lt;/span&gt; &lt;span class="s"&gt;or&lt;/span&gt; &lt;span class="s"&gt;.app.status.operationState.operation.sync.revision&lt;/span&gt; &lt;span class="s"&gt;.app.status.sync.revision&lt;/span&gt; &lt;span class="s"&gt;-&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
          &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s"&gt;-&lt;/span&gt; &lt;span class="s"&gt;$commit&lt;/span&gt; &lt;span class="s"&gt;:=&lt;/span&gt; &lt;span class="s"&gt;call&lt;/span&gt; &lt;span class="s"&gt;.repo.GetCommitMetadata&lt;/span&gt; &lt;span class="s"&gt;$rev&lt;/span&gt; &lt;span class="s"&gt;-&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
          &lt;span class="p"&gt;{&lt;/span&gt;
            &lt;span class="na"&gt;"app"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="s"&gt;.app.metadata.name&lt;/span&gt; &lt;span class="p"&gt;|&lt;/span&gt; &lt;span class="s"&gt;toJson&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="na"&gt;"project"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="s"&gt;.app.spec.project&lt;/span&gt; &lt;span class="p"&gt;|&lt;/span&gt; &lt;span class="s"&gt;toJson&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="na"&gt;"revision"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="s"&gt;$rev&lt;/span&gt; &lt;span class="p"&gt;|&lt;/span&gt; &lt;span class="s"&gt;toJson&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="na"&gt;"phase"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="s"&gt;.app.status.operationState.phase&lt;/span&gt; &lt;span class="p"&gt;|&lt;/span&gt; &lt;span class="s"&gt;toJson&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="na"&gt;"health"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="s"&gt;.app.status.health.status&lt;/span&gt; &lt;span class="p"&gt;|&lt;/span&gt; &lt;span class="s"&gt;toJson&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="na"&gt;"commitMessage"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="s"&gt;$commit.Message&lt;/span&gt; &lt;span class="p"&gt;|&lt;/span&gt; &lt;span class="s"&gt;toJson&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="na"&gt;"startedAt"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="s"&gt;.app.status.operationState.startedAt&lt;/span&gt; &lt;span class="p"&gt;|&lt;/span&gt; &lt;span class="s"&gt;toJson&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="na"&gt;"finishedAt"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="s"&gt;.app.status.operationState.finishedAt&lt;/span&gt; &lt;span class="p"&gt;|&lt;/span&gt; &lt;span class="s"&gt;toJson&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="na"&gt;"namespace"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="s"&gt;.app.spec.destination.namespace&lt;/span&gt; &lt;span class="p"&gt;|&lt;/span&gt; &lt;span class="s"&gt;toJson&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="na"&gt;"cluster"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="s"&gt;or&lt;/span&gt; &lt;span class="s"&gt;.app.spec.destination.name&lt;/span&gt; &lt;span class="s"&gt;.app.spec.destination.server&lt;/span&gt; &lt;span class="p"&gt;|&lt;/span&gt; &lt;span class="s"&gt;toJson&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="na"&gt;"url"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="s"&gt;printf&lt;/span&gt; &lt;span class="s2"&gt;"%s/applications/%s"&lt;/span&gt; &lt;span class="s"&gt;.context.argocdUrl&lt;/span&gt; &lt;span class="s"&gt;.app.metadata.name&lt;/span&gt; &lt;span class="p"&gt;|&lt;/span&gt; &lt;span class="s"&gt;toJson&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
          &lt;span class="p"&gt;}&lt;/span&gt;

  &lt;span class="na"&gt;trigger.on-sync-running&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;|&lt;/span&gt;
    &lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;when&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;app.status.operationState != nil and app.status.operationState.phase in ['Running']&lt;/span&gt;
      &lt;span class="na"&gt;oncePer&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;app.status.operationState.startedAt&lt;/span&gt;
      &lt;span class="na"&gt;send&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s"&gt;jira-deployment&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
  &lt;span class="na"&gt;trigger.on-sync-succeeded&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;|&lt;/span&gt;
    &lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;when&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;app.status.operationState != nil and app.status.operationState.phase in ['Succeeded']&lt;/span&gt;
      &lt;span class="na"&gt;oncePer&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;app.status.operationState.startedAt&lt;/span&gt;
      &lt;span class="na"&gt;send&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s"&gt;jira-deployment&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
  &lt;span class="na"&gt;trigger.on-sync-failed&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;|&lt;/span&gt;
    &lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;when&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;app.status.operationState != nil and app.status.operationState.phase in ['Error', 'Failed']&lt;/span&gt;
      &lt;span class="na"&gt;oncePer&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;app.status.operationState.startedAt&lt;/span&gt;
      &lt;span class="na"&gt;send&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s"&gt;jira-deployment&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Two details matter here:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Use &lt;code&gt;toJson&lt;/code&gt; on every value.&lt;/strong&gt; A commit message with a quote or a line break otherwise produces invalid JSON.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;repo.GetCommitMetadata&lt;/code&gt; gives you the commit message.&lt;/strong&gt; That is where the work item keys come from, with no extra access to your Git provider.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Then subscribe each Application with annotations:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight yaml"&gt;&lt;code&gt;&lt;span class="na"&gt;metadata&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
  &lt;span class="na"&gt;annotations&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="na"&gt;notifications.argoproj.io/subscribe.on-sync-running.jira&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;""&lt;/span&gt;
    &lt;span class="na"&gt;notifications.argoproj.io/subscribe.on-sync-succeeded.jira&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;""&lt;/span&gt;
    &lt;span class="na"&gt;notifications.argoproj.io/subscribe.on-sync-failed.jira&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;""&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Step 2: Turn the event into a Jira deployment
&lt;/h2&gt;

&lt;p&gt;The receiver has four jobs.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Find the work item keys.&lt;/strong&gt; A pattern such as &lt;code&gt;\b[A-Z][A-Z0-9]{1,9}-[1-9][0-9]*\b&lt;/code&gt; over the commit message finds &lt;code&gt;KAN-12&lt;/code&gt;. It also finds keys in merge commits that include a branch name.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Map the state.&lt;/strong&gt; Argo CD's &lt;code&gt;Running&lt;/code&gt; becomes &lt;code&gt;in_progress&lt;/code&gt;, &lt;code&gt;Succeeded&lt;/code&gt; becomes &lt;code&gt;successful&lt;/code&gt;, and &lt;code&gt;Failed&lt;/code&gt; or &lt;code&gt;Error&lt;/code&gt; becomes &lt;code&gt;failed&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Pick the environment type.&lt;/strong&gt; Jira wants &lt;code&gt;production&lt;/code&gt;, &lt;code&gt;staging&lt;/code&gt;, &lt;code&gt;testing&lt;/code&gt; or &lt;code&gt;development&lt;/code&gt;. The namespace or cluster name usually tells you.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Keep one sync as one deployment.&lt;/strong&gt; Jira identifies a deployment by pipeline, environment and a sequence number. Use the sync's start time as that number, so the "running" and "succeeded" events update the same record.&lt;/p&gt;

&lt;h2&gt;
  
  
  Three things that went wrong for me
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;A missing &lt;code&gt;argocdUrl&lt;/code&gt; rejects the whole deployment.&lt;/strong&gt; Without that setting, the template produces &lt;code&gt;%!s(&amp;lt;nil&amp;gt;)/applications/my-app&lt;/code&gt;. Jira refuses it as an invalid URL, and it refuses the entire record, not just the link. Set &lt;code&gt;context.argocdUrl&lt;/code&gt;, and validate the URL in the receiver.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A 5xx answer makes Argo CD retry.&lt;/strong&gt; If Jira rejects the data, answer with a 4xx. Otherwise Argo CD sends the same rejected data three more times.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The deployment appears after about a minute.&lt;/strong&gt; Jira accepts the call at once and processes it in the background, so do not conclude it failed too early.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  One known limit
&lt;/h2&gt;

&lt;p&gt;Argo CD exposes the message of the commit it synced, not the commits before it. If several merges are synced together, the work items from the earlier commits are missed.&lt;/p&gt;

&lt;h2&gt;
  
  
  If you would rather not build it
&lt;/h2&gt;

&lt;p&gt;I packaged this as a Jira app that runs on Atlassian's Forge platform. It has a setup page that creates the token and fills in the Argo CD config for you, and it needs no agent in the cluster and no inbound access.&lt;/p&gt;

&lt;p&gt;It works today as a prototype, and I am looking for a few teams to test it: &lt;a href="https://jira-apps-dev.bitbucket.io" rel="noopener noreferrer"&gt;https://jira-apps-dev.bitbucket.io&lt;/a&gt;&lt;/p&gt;

</description>
      <category>argocd</category>
      <category>kubernetes</category>
      <category>jira</category>
      <category>devops</category>
    </item>
  </channel>
</rss>
