1. Sign in to your GitLab application as a user with an [Administrator](../../user/permissions.md) role.
1. Sign in to your GitLab application as an [administrator](../../user/permissions.md).
1. Install the GitLab application from your self-managed GitLab instance, as
described in the [Atlassian developer guides](https://developer.atlassian.com/cloud/jira/platform/getting-started-with-connect/#step-3--install-and-test-your-app):
1. In your Jira instance, go to **Apps > Manage Apps** and click**Upload app**:
1. In your Jira instance, go to **Apps > Manage Apps** and select**Upload app**:
1. Disable [development mode](https://developer.atlassian.com/cloud/jira/platform/getting-started-with-connect/#step-2--enable-development-mode) on your Jira instance.
The **GitLab.com for Jira Cloud** app now displays under **Manage apps**. You can also
click**Get started** to open the configuration page rendered from your GitLab instance.
select**Get started** to open the configuration page rendered from your GitLab instance.
NOTE:
If a GitLab update makes changes to the application descriptor, you must uninstall, then reinstall, the
application.
If a GitLab update makes changes to the application descriptor, you must uninstall,
then reinstall the application.
### Create a Marketplace listing
...
...
@@ -120,31 +125,33 @@ If you prefer to not use development mode on your Jira instance, you can create
your own Marketplace listing for your instance. This enables your application
to be installed from the Atlassian Marketplace.
For full instructions, review the Atlassian [guide to creating a marketplace listing](https://developer.atlassian.com/platform/marketplace/installing-cloud-apps/#creating-the-marketplace-listing). To create a
Marketplace listing, you must:
For full instructions, review the Atlassian [guide to creating a marketplace listing](https://developer.atlassian.com/platform/marketplace/installing-cloud-apps/#creating-the-marketplace-listing).
To create a Marketplace listing:
1. Register as a Marketplace vendor.
1. List your application, using the application descriptor URL.
1. List your application using the application descriptor URL.
- Your manifest file is located at: `https://your.domain/your-path/-/jira_connect/app_descriptor.json`
-GitLab recommends you list your application as `private`, because public
-We recommend you list your application as `private`, because public
applications can be viewed and installed by any user.
1. Generate test license tokens for your application.
Using this method, [updates are automated](#update-the-gitlabcom-for-jira-cloud-app)
the same way as when using our GitLab.com Marketplace listing.
This method uses [automated updates](#update-the-gitlabcom-for-jira-cloud-app)
the same way as our GitLab.com Marketplace listing.
## Troubleshoot GitLab.com for Jira Cloud app
The GitLab.com for Jira Cloud app uses an iframe to add namespaces on the
settings page. Some browsers block cross-site cookies, which can lead to a
message saying that the user needs to log in on GitLab.com even though the user
is already logged in.
### Browser displays sign-in message when already signed in
You might get the following message prompting you to sign in to GitLab.com
when you're already signed in:
```plaintext
You need to sign in or sign up before continuing.
```
> "You need to sign in or sign up before continuing."
GitLab.com for Jira Cloud app uses an iframe to add namespaces on the
settings page. Some browsers block cross-site cookies, which can lead to this issue.
In this case, use [Firefox](https://www.mozilla.org/en-US/firefox/), [Google Chrome](https://www.google.com/chrome/), or enable cross-site cookies in your browser.
To resolve this issue, use [Firefox](https://www.mozilla.org/en-US/firefox/),
[Google Chrome](https://www.google.com/chrome/), or enable cross-site cookies in your browser.