Developer
GitLab
Read and manage GitLab issues and merge requests, and check pipeline status, from Atlas.
What this connector does
- Read and change issues, and read and add comments, on your projects.
- Open, approve, and merge merge requests, with a readiness check before any merge.
- Read pipelines, branches, labels, and milestones.
- Search projects and see which account the connection acts as.
Before you begin
- You are an owner or administrator of your Atlas workspace.
- You can sign in to your GitLab account and approve access for Atlas.
- Atlas looks after the GitLab app on its side, so there is nothing for you to create or copy.
How to connect
Open GitLab in Integrations
In Atlas, open Integrations and select GitLab.
Press Connect
Atlas sends you to GitLab to sign in. Sign in with the account you want to connect.
Approve access
Review the permissions that GitLab lists and approve them. Atlas returns you to the connector page, which then shows the connection.
Check the connection
Select Test connection on the connector page. A passing result means Atlas can read from GitLab.
Permissions Atlas asks for
apiread_userread_repositorySetup checklist
- Confirm you are an owner or administrator of your Atlas workspace.
- Open Integrations and select the connector.
- Press Connect and sign in to GitLab.
- Review the permissions that GitLab lists and approve them.
- Select Test connection and read the result.
Troubleshooting
invalid_grant
The sign-in approval expired or was already used. Retry the connection once.
Connect says GitLab is not available yet
Atlas has not enabled GitLab for this deployment, so there is nothing for you to configure. Check again later.
The sign-in was cancelled
If you close the GitLab screen or choose Cancel, Atlas does not connect. Press Connect again and approve the access.
Atlas asks you to reconnect
GitLab can end a connection when access is revoked or a password changes. Press Reconnect on the connector page and approve the access again.
Event notifications
Atlas does not listen for GitLab events yet. Operations run only when someone starts them.
Disconnect and data deletion
- Click Disconnect on the Atlas GitLab connector page.
- Open Applications and remove the Atlas Connector authorization.
When you are ready, open the live connector page and press Connect to finish connecting GitLab.
Open the GitLab connector page