## Summary Publish the GitLab for Jira Cloud Forge app to the [Atlassian Marketplace](https://marketplace.atlassian.com/apps/1221011/gitlab-for-jira-cloud) as a **major upgrade** of the existing Connect app listing (v1.0.24-AC). ## Background The Forge app has been successfully: - Developed and deployed (#1, #2) - CI/CD configured with Forge CLI authentication (#3) - Tested on staging by multiple reviewers (#4, #6) - Documentation updated (#7) Per Atlassian's [Connect end-of-support timeline](https://www.atlassian.com/blog/developer/announcing-connect-end-of-support-timeline-and-next-steps): - **March 31, 2026**: Connect app updates blocked; private Connect app installs blocked (Phase 2) The app uses the same `app.connect.key` (`gitlab-jira-connect-gitlab.com`) ensuring existing customers' synced development data is preserved during the upgrade. **Current Marketplace Stats:** - Installs: 33,858 - Version: 1.0.24-AC (Connect) - Payment model: Free - Support: Partner Supported ## Prerequisites - [x] **Enable sharing in Developer Console** — Required before Marketplace submission ([docs](https://developer.atlassian.com/platform/forge/distribute-your-apps/)) - [x] **Deploy to production environment** — Run `forge deploy -e production` - [x] **Verify app is deployed and functional** — Install on a test Jira site via sharing link ## Marketplace Listing Requirements ### App Information (from existing listing) - [x] **App name** — "GitLab for Jira Cloud" - [x] **Vendor** — GitLab (vendor ID: 1217142) - [x] **App summary** — "View GitLab activity from Jira Cloud" - [x] **Categories** — Already configured - [x] **Payment model** — Free - [x] **License type** — Commercial ### Marketing Assets (from existing listing) - [x] **App logo** — Already exists (also hosted at `https://gitlab-org.gitlab.io/gitlab-jira-forge/gitlab_logo.png`) - [x] **Banner images** — Already exist (3 feature screenshots) - [x] **Screenshots** — Already exist showing: - "Do more with less" - Development panel in Jira - "Better visibility" - Traceability across systems - "Better software faster" - GitLab integration view ### Legal & Privacy (from existing listing) - [x] **Privacy policy URL** — https://about.gitlab.com/privacy/ - [x] **End User License Agreement (EULA)** — Verify if updates needed for Forge - [x] **Documentation URL** — https://docs.gitlab.com/ee/integration/jira/connect-app.html ### Security Information - [x] **Privacy and Security tab** — Update if needed for Forge-specific information: - Does the app store personal data? - Does the app support data residency? - External hosts the app communicates with (`gitlab.com`) - [x] **Bug Bounty program** — Currently not enrolled (evaluate if needed) ### Scope Justification (required for submission) Provide justification for each API scope: - [x] **`read:connect-jira`** — Read Jira issue data for development panel integration - [x] **`write:connect-jira`** — Sync GitLab development data (commits, branches, MRs, deployments, pipelines, feature flags) to Jira issues - [x] **`delete:connect-jira`** — Clean up data when unlinking GitLab namespaces ### Remote Hostname Disclosure - [x] **Disclose remote hostname** — `gitlab.com` (Forge Remote backend at `https://gitlab.com/-/jira_connect`) - [x] **Explain data sent** — JWT tokens for authentication, issue keys for dev panel queries, development data sync ## Submission Process 1. [x] **Publish Developer Space** — Follow [Publish Developer Space](https://developer.atlassian.com/platform/forge/developer-space/publish-developer-space/) guide 2. [x] **Create new version** — Click "Create version" from the existing app listing to add Forge version 3. [x] **Accept Marketplace Partner Agreement** — Required upon submission 4. [x] **Submit for review** — Atlassian aims to provide a decision within one week 5. [ ] **Address review feedback** — If any changes are requested ## Post-Approval - [ ] **Verify listing is live** on [Atlassian Marketplace](https://marketplace.atlassian.com/apps/1221011/gitlab-for-jira-cloud) - [ ] **Test upgrade path** — Verify existing users see the [major upgrade requiring admin approval](https://developer.atlassian.com/platform/marketplace/upgrading-and-versioning-cloud-apps/#changes-that-require-manual-customer-approval) - [ ] **Test fresh installation** — Install from Marketplace on a new Jira site - [ ] **Monitor for issues** — Watch for customer feedback during rollout ## Pricing This is a **free app** — no licensing configuration needed in `manifest.yml`. ## Related - Parent epic: https://gitlab.com/groups/gitlab-org/-/epics/21004 - Staging reviews: #4, #6 - Docs update: #7 - Existing Marketplace listing: https://marketplace.atlassian.com/apps/1221011/gitlab-for-jira-cloud - Atlassian Marketplace listing guide: https://developer.atlassian.com/platform/marketplace/listing-forge-apps/ - App approval guidelines: https://developer.atlassian.com/platform/marketplace/app-approval-guidelines/