Version Control
Connecting your version control systems with DevZerp.
Managing Version Control Systems
DevZero integrates with Github, Bitbucket and Gitlab.
After connecting DevZero to your version control system, you will be able to access private repositories in your DevZero workspaces.
Github
- Navigate to Version Control Systems/Github
- Click on "Connect to Github"
- Follow the prompt to connect DevZero to your Github organization or user account
- If you are not an admin of your Github organization, ask your Github organization admin to complete the installation, they should receive an email from Github
You may connect DevZero with multiple Github organizations and/or user accounts.
Bitbucket
First, create a Bitbucket OAuth application with the following values:
- Application Type:
External
orOAuth 2.0
- Direction:
Incoming
- Redirect URL:
https://devzero.io/dashboard/oauth-success
- For self-hosted users, replace
devzero.io
with your self hosted DevZero address
- For self-hosted users, replace
- Scopes:
Repository Read
,Repository Write
Securely note the Client ID and Client Secret values, you will need them in the next step.
Next, provide the oauth application details to DevZero:
- Navigate to Version Control Systems/Bitbucket
- Click on "Connect to Bitbucket"
- Fill out the dialogue with the following values:
- Base Domain:
bitbucket.org
or your Bitbucket datacenter server address - Auth URL:
https://{base_domain}/rest/oauth2/latest/authorize
- Token URL:
https://{base_domain}/rest/oauth2/latest/token
- Redirect URL:
https://devzero.io/dashboard/oauth-success
or your with your self hosted DevZero address - Client ID: the client ID of the Bitbucket OAuth Application
- Client Secret: the client secret of the Bitbucket OAuth Application
- Base Domain:
After creating the integration, be sure the complete the authorization flow for your user by clicking on the authorization notification at the top of the page.
You may connect DevZero with only one Bitbucket application at a time, to re-connect, first revoke the current integration.
Gitlab
First, create a Gitlab OAuth application with the following values:
- Redirect URL:
https://devzero.io/dashboard/oauth-success
- For self-hosted users, replace
devzero.io
with your self hosted DevZero address
- For self-hosted users, replace
- Confidential:
True
- Scopes:
api
,read_api
,read_user
,read_repository
,write_repository
,read_registry
,write_registry
Securely note the Client ID and Client Secret values, you will need them in the next step
Next, provide the oauth application details to DevZero:
- Navigate to Version Control Systems/Gitlab
- Click on "Connect to Gitlab"
- Fill out the dialogue with the following values:
- Base Domain:
gitlab.com
or your self-hosted Gitlab server address - Auth URL:
https://{base_domain}/oauth/authorize
- Token URL:
https://{base_domain}/oauth/token
- Redirect URL:
https://devzero.io/dashboard/oauth-success
or your with your self hosted DevZero address - Client ID: the client ID of the Gitlab OAuth Application
- Client Secret: the client secret of the Gitlab OAuth Application
- Base Domain:
After creating the integration, be sure the complete the authorization flow for your user by clicking on the authorization notification at the top of the page.
You may connect DevZero with only one Gitlab application at a time, to re-connect, first revoke the current integration.