Hi @Jason Chayer
To automate the creation of a release in Jira Cloud when a build is created in GitHub, you can use GitHub Actions along with the Jira Cloud REST API. Here’s a detailed guide on how to set this up:
Steps to Integrate GitHub with Jira Cloud
1. **Create an API Token in Jira Cloud**:
- Go to your Jira account settings.
- Navigate to **Security** > **API token**.
- Click on **Create API token**, give it a label, and copy the generated token.
2. **Store the API Token in GitHub Secrets**:
- Go to your GitHub repository.
- Navigate to **Settings** > **Secrets and variables** > **Actions**.
- Click **New repository secret**.
- Name it something like `JIRA_API_TOKEN` and paste the token.
3. **Create a GitHub Actions Workflow**:
- Create a new file in your repository: `.github/workflows/create-jira-release.yml`.
- Add the following content to the workflow file:
name: Create Jira Release
on:
push:
tags:
- 'v*' # Adjust this to your versioning scheme
jobs:
create-release:
runs-on: ubuntu-latest
steps:
- name: Create Release in Jira
run: |
curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Basic $(echo -n 'your-email@example.com:${{ secrets.JIRA_API_TOKEN }}' | base64)" \
--data '{
"name": "${{ github.ref }}",
"description": "Release created from GitHub build.",
"project": "YOUR_PROJECT_KEY",
"released": true
}' \
https://your-domain.atlassian.net/rest/api/3/version
```
**Replace the placeholders**:
- `your-email@example.com`: Your Jira account email.
- `YOUR_PROJECT_KEY`: The key of the Jira project where you want to create the release.
- `your-domain`: Your Jira instance domain.
4. **Test the Workflow**:
- Push a new tag that matches your defined pattern (e.g., `v1.0.0`).
- Check the Actions tab in GitHub to see if the workflow ran successfully.
- Verify in Jira that a new version has been created.
You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.