Jira Integration with GitHub Actions

Integrating Jira with GitHub Actions allows teams to automate their workflows and keep track of issues directly from their CI/CD pipelines. This lesson covers the process of setting up this integration, key concepts, and best practices.

Step 1: Generate a Jira API Token

To authenticate your GitHub Actions with Jira, you will need to generate an API token from your Jira account.

1. Log in to your Jira account.
2. Navigate to Account settings.
3. Under Security, select API token.
4. Click Create API token.
5. Save the generated token securely.

Step 2: Create a GitHub Secrets

Store your Jira token in GitHub Secrets to securely use it in your workflows.

1. Go to your GitHub repository.
2. Click on Settings.
3. Select Secrets and variables > Actions.
4. Click on New repository secret.
5. Name it JIRA_API_TOKEN and paste your token.

Step 3: Configure GitHub Actions Workflow

Now, create a workflow file to integrate Jira in your GitHub Actions.

name: Jira Integration

on: [push]

jobs:
  update-jira:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v2

      - name: Update Jira Issue
        env:
          JIRA_API_TOKEN: ${{ secrets.JIRA_API_TOKEN }}
          JIRA_URL: 'https://your-domain.atlassian.net'
        run: |
          curl -X PUT --user your-email@example.com:${JIRA_API_TOKEN} \
          --data '{ "fields": { "status": { "name": "In Progress" } } }' \
          -H "Content-Type: application/json" \
          ${JIRA_URL}/rest/api/2/issue/ISSUE-123
          echo "Jira issue updated!"