Linking a source repository - Amazon CodeCatalyst

Linking a source repository

When linking a source repository to a project, you can include repositories that have a CodeCatalyst extension for the service that hosts the repository, if that extension is installed for your space. Only users with the Space administrator role can install extensions. Once the extension is installed, you can link to repositories configured for access by that extension. For more information, see Installing and uninstalling extensions in CodeCatalyst or follow Quickstart: Using GitHub repositories in CodeCatalyst.

Note

You can link a repository to only one project in a space. You cannot link an archived repository. While you can link an empty repository, you can't use it in CodeCatalyst until you have initialized it with an initial commit that creates a default branch.

To link a source repository
  1. Navigate to the project where you want to link a repository.

    Note

    Before you can link a repository, a user with the Space administrator role must first install the extension for the provider that hosts the repository. For more information, see Installing an extension.

  2. In the navigation pane, choose Code, and then choose Source repositories.

  3. Choose Add repository, and then choose Link repository.

  4. In Repository provider, choose the name of the provider. In GitHub account, choose the linked account you want to use for working in the repository, and then in Repository, choose the name of the repository.

    Note

    You can only link an active repository. You cannot link an archived repository.

  5. Review the information, and then choose Link.

    Note

    You can only link a repository to one project in a space.

To unlink a repository from a project, you must have the Space administrator role. For more information, see Managing GitHub repositories in CodeCatalyst.