Add external repositories in Cloud Manager external-repositories
Learn how to add an external repository into Cloud Manager. Cloud Manager supports integration with GitHub, GitLab, and Bitbucket repositories.
Configure an external repository
Configuration of an external repository in Cloud Manager consists of three steps:
- Add an external repository to a selected program.
- Provide an access token to the external repository.
- Validate ownership of the external repository.
Add an external repository add-ext-repo
-
Log into Cloud Manager at and select the appropriate organization.
-
On the **My Programs console, select the program to which you want to link an external repository.
-
In the side menu, under Services, select
-
Near the upper-right corner of the Repositories page, click Add Repository.
-
In the Add Repository dialog box, select Private Repository to link an external Git repository to your program.
-
In each respective field, provide the following details about your repository:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 Field Description Repository Name Required. An expressive name for your new repository. Repository URL Required. The URL of the repository.
If you are using a GitHub-hosted repository, the path must end in.git.
For example,https://github.com/org-name/repo-name.git(URL path is for illustration purposes only).
If you are using an external repository, it must use the following URL path format:https://git-vendor-name.com/org-name/repo-name.git
orhttps://self-hosted-domain/org-name/repo-name.git
And match your Git vendor.Select Repository Type Required. Select the repository type that you are using: GitHub, GitLab, or BitBucket. If the repository URL path above includes the Git vendor name, such as GitLab or Bitbucket, the repository type is already pre-selected for you. Description Optional. A detailed description of the repository. -
Select Save to add the repository.
-
In the Private Repository Ownership Validation dialog box, provide an access token to validate ownership of the external repository so you can access it.
Selecting an existing access token for a BitBucket repository.table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 Token type Description Use existing Access Token If you have already provided a repository access token for your organization and have access to multiple repositories, you can select an existing token. Use the Token Name drop-down list to choose the token you want to apply to the repository. Otherwise, add a new access token. Add new Access Token Repository type: GitHub
• In the Token Name text field, type a name for the access token you are creating.
• Create a personal access token by following the instructions in the .
• Permissions required:
ÌýÌý•Read access to metadata.
ÌýÌý•Read and write access to code and pull requests.
• In the Access Token field, paste the token you just created.Repository type: GitLab
• In the Token Name text field, type a name for the access token you are creating.
• Create a personal access token by following the instruction in the .
• Permissions required:
ÌýÌý•api
ÌýÌý•read_api
ÌýÌý•read_repository
ÌýÌý•write_repository
• In the Access Token field, paste the token you just created.Repository type: Bitbucket
• In the Token Name text field, type a name for the access token you are creating.
• Create a repository access token using the .
• Permissions required:
ÌýÌý•Read and write access to code and pull requests.note note NOTE The feature Add new Access Token is currently in the Early Adopters phase. Additional functionalities are being planned. As a result, the required permissions for access tokens may change. Additionally, the user interface for managing tokens may be updated, potentially including features like token expiration dates. And, automated checks to ensure that tokens linked to repositories remain valid. -
Click Validate.
After validation, the external repository is ready to use and link to a pipeline.
Link a validated external repository to a pipeline validate-ext-repo
-
Add or edit a pipeline:
Add Non-Production Pipeline dialog box with selected repository and Git branch, -
When adding or editing a pipeline, to specify the Source Code location for your new or existing pipeline, choose the external repository you want to use from the Repository drop-down list.
-
In the Git Branch drop-down list, select the branch as the source for the pipeline.
-
Click Save.
Limitations
External repositories cannot be linked to Configuration pipelines.