Seamlessly integrate GitHub with Jira using GitHub Actions for better project management and collaboration.
-
Issue Synchronization: Automatically create a Jira issue when a new GitHub issue is created.
- Convert GitHub markdown to Jira markup for consistent formatting.
- Append a reference to the GitHub issue within the Jira issue.
- Add a reference to the Jira issue in the GitHub issue.
-
Comment Synchronization: Link Jira and GitHub issue comments for better communication and collaboration.
- Convert GitHub markdown to Jira markup for consistent formatting.
- Append a reference to the GitHub comment within the Jira comment.
- Copy the
workflows
directory into your project repository.
-
Add the following secrets to your GitHub project:
JIRA_BASE_URL
: Your Jira instance's URL (e.g.,https://mycompany.atlassian.net
).JIRA_USER_EMAIL
: The email address associated with the Jira user account that will create and post issues (e.g.,john.doe@example.com
).JIRA_API_TOKEN
: The Jira user's API token.
-
Set the
JIRA_PROJECT_KEY
environment variable in your GitHub project (e.g.,MYPROJ
if your Jira tickets are formatted likeMYPROJ-123
).
- Enable "Autolink references" in your GitHub project settings and use your Jira project key (e.g.,
MYPROJ
) as the "Reference prefix".
Now you're all set! Enjoy seamless GitHub and Jira integration with improved collaboration and project management.