{"id":27785994,"url":"https://github.com/ashikkumar23/jira-github-integration","last_synced_at":"2025-06-30T19:35:27.447Z","repository":{"id":290504281,"uuid":"972585157","full_name":"ashikkumar23/jira-github-integration","owner":"ashikkumar23","description":"This repository demonstrates a proof of concept (POC) for integrating Jira with GitHub Actions. The primary goal is to automate the creation of Jira bug tickets when specific conditions are met in GitHub, such as the addition of a bug label to an issue.","archived":false,"fork":false,"pushed_at":"2025-04-29T06:08:58.000Z","size":11,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-30T15:37:40.401Z","etag":null,"topics":["automation","bug-tracking","devops","github","github-actions","github-labels","issue-management","jira-automation","jira-integration","poc","workflow-automation"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ashikkumar23.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-25T10:13:22.000Z","updated_at":"2025-04-29T06:09:00.000Z","dependencies_parsed_at":"2025-04-29T07:27:02.840Z","dependency_job_id":"ec16e926-f65e-49a7-bbfd-fe1d791252a4","html_url":"https://github.com/ashikkumar23/jira-github-integration","commit_stats":null,"previous_names":["ashikkumar23/jira-github-integration"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ashikkumar23/jira-github-integration","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashikkumar23%2Fjira-github-integration","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashikkumar23%2Fjira-github-integration/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashikkumar23%2Fjira-github-integration/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashikkumar23%2Fjira-github-integration/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ashikkumar23","download_url":"https://codeload.github.com/ashikkumar23/jira-github-integration/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashikkumar23%2Fjira-github-integration/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262839330,"owners_count":23372697,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","bug-tracking","devops","github","github-actions","github-labels","issue-management","jira-automation","jira-integration","poc","workflow-automation"],"created_at":"2025-04-30T15:37:27.618Z","updated_at":"2025-06-30T19:35:27.409Z","avatar_url":"https://github.com/ashikkumar23.png","language":null,"readme":"# Jira GitHub Integration\n\nThis repository demonstrates a **Proof of Concept (POC)** for integrating Jira with GitHub Actions. The primary goal is to automate the creation of Jira bug tickets whenever a GitHub issue is labeled as `bug`.\n\n---\n\n## 🛠 Features\n- Automatically sync GitHub issues labeled as `bug` to Jira as bug tickets.\n- Map issue details (e.g., title, description, reporter) directly into Jira tickets.\n- Leverages **GitHub Actions** for seamless workflow automation.\n- Provides a clear audit trail with links back to the original GitHub issue.\n\n---\n\n## 📁 Project Structure\n```\njira-github-integration/\n├── .github/\n│   └── workflows/\n│       └── jira-integration.yml   # GitHub Actions workflow file\n├── LICENSE                        # MIT License file\n└── README.md                      # This documentation\n```\n\n---\n\n## 🔧 Prerequisites\nBefore you begin, ensure you have the following:\n1. **Jira Account**: Access to a Jira instance with admin rights to a project.\n2. **GitHub Repository**: A repository where you have admin permissions to set up Actions.\n3. **API Token**: A Jira API token for authentication. [Learn how to generate one](https://confluence.atlassian.com/cloud/api-tokens-938839638.html).\n4. **GitHub Secrets**:\n   - `JIRA_BASE_URL`: Your Jira instance URL (e.g., `https://your-domain.atlassian.net`).\n   - `JIRA_USER_EMAIL`: The email address associated with your Jira account.\n   - `JIRA_API_TOKEN`: Your Jira API token.\n\n---\n\n## ⚙️ Setup Instructions\n\n#### 1. Clone the Repository\n```bash\ngit clone https://github.com/ashikkumar23/jira-github-integration.git\ncd jira-github-integration\n```\n\n#### 2. Configure Secrets\nGo to your repository's **Settings** \u003e **Secrets and variables** \u003e **Actions**, and add the following secrets:\n- `JIRA_BASE_URL`\n- `JIRA_USER_EMAIL`\n- `JIRA_API_TOKEN`\n\n#### 3. Update the Workflow File\nThe workflow file is located at `.github/workflows/jira-integration.yml`. Ensure the following is set:\n- Replace `JGI` with your Jira project key.\n- Adjust other parameters if needed.\n\n#### 4. Test the Workflow\n- Create a new issue in the repository.\n- Add the `bug` label to the issue.\n- Check your Jira project for a new bug ticket.\n\n---\n\n## 🚀 How It Works\n1. When you add the `bug` label to a GitHub issue, the workflow is triggered.\n2. The workflow uses the [Atlassian Jira Login Action](https://github.com/atlassian/gajira-login) to login to Jira.\n3. The workflow uses the [Atlassian Jira Create Action](https://github.com/atlassian/gajira-create) to create a bug ticket in Jira.\n4. The issue details (title, description, reporter, and URL) are mapped to the Jira ticket.\n\n---\n\n## 🌟 Limitations\n- Currently supports only issues labeled as `bug`.\n- Does not sync updates or status changes from Jira back to GitHub.\n\n---\n\n## 📖 References\n- [Jira API Documentation](https://developer.atlassian.com/cloud/jira/platform/rest/v3/)\n- [GitHub Actions Documentation](https://docs.github.com/en/actions)\n- [Atlassian Jira Login Action](https://github.com/atlassian/gajira-login)\n- [Atlassian Jira Create Action](https://github.com/atlassian/gajira-create)\n\n---\n\n## 🛡 License\nThis project is licensed under the [MIT License](LICENSE).\n\n---\n\n## 🤝 Contributing\nContributions are welcome! Feel free to open issues or submit pull requests.\n\n---\n\n## 📞 Support\nIf you encounter any issues or have questions, please feel free to open an issue in this repository.","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fashikkumar23%2Fjira-github-integration","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fashikkumar23%2Fjira-github-integration","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fashikkumar23%2Fjira-github-integration/lists"}