Add functionality to projects with extensions in CodeCatalyst

Amazon CodeCatalyst includes extensions that help you add functionality and integrate with products outside of CodeCatalyst. With extensions from the CodeCatalyst catalog, teams can customize their experiences in CodeCatalyst.

Topics

• Available third-party extensions
• Extensions concepts
• Quickstart: Installing extensions, connecting providers, and linking resources in CodeCatalyst
• Installing an extension in a space
• Uninstalling an extension in a space
• Connecting GitHub accounts, Bitbucket workspaces, GitLab users, and Jira sites CodeCatalyst
• Disconnecting GitHub accounts, Bitbucket workspaces, GitLab users, and Jira sites CodeCatalyst
• Linking GitHub repositories, Bitbucket repositories, GitLab project repositories, and Jira projects in CodeCatalyst
• Unlinking GitHub repositories, Bitbucket repositories, GitLab project repositories, and Jira projects in CodeCatalyst
• Viewing third-party repositories and searching Jira issues in CodeCatalyst
• Automatically starting a workflow run after third-party repository events
• Restricting IP access with third-party repository providers
• Blocking third-party merges when workflows fail
• Linking Jira issues to CodeCatalyst pull requests
• Viewing CodeCatalyst events in Jira issues

Available third-party extensions

You can add particular functionality to your CodeCatalyst project depending on the extension you choose to integrate resources with.

Integrating GitHub repositories in CodeCatalyst

GitHub is a cloud-based service that helps developers store and manage their code. The GitHub repositories extension lets you use linked GitHub repositories in Amazon CodeCatalyst projects. You can also link GitHub repositories when creating a new CodeCatalyst project. For more information, see Creating a project with a linked third-party repository.

Note

• You can't use empty or archived GitHub repositories with CodeCatalyst projects.

• The GitHub repositories extension isn't compatible with GitHub Enterprise Server repositories.

Once you install and configure the GitHub repositories extension, you will be able to:

• View your GitHub repositories in the list of source repositories in CodeCatalyst

• Store and manage workflow definition files in your GitHub repositories

• Create, read, update, and delete files stored in linked GitHub repositories from CodeCatalyst Dev Environments

• Store and index files from the linked GitHub repositories in CodeCatalyst

• Create CodeCatalyst projects with existing repositories of connected GitHub accounts

• Create a GitHub repository with code generated by a blueprint when creating a project with a blueprint or adding a blueprint

• Start CodeCatalyst workflow runs automatically when code is pushed to linked GitHub repositories, or when pull requests are created, modified, or closed in linked GitHub repositories

• Use linked GitHub repository source files in CodeCatalyst workflows

• Read and execute GitHub actions in CodeCatalyst workflows

• Send CodeCatalyst workflow run statuses to linked GitHub repositories, and block GitHub pull request merges based on commit statuses

Integrating Bitbucket repositories in CodeCatalyst

Bitbucket is a cloud-based service that helps developers store and manage their code. The Bitbucket repositories extension lets you use linked Bitbucket repositories in Amazon CodeCatalyst projects. You can also link Bitbucket repositories when creating a new CodeCatalyst project. For more information, see Creating a project with a linked third-party repository.

Note

• You can't use empty or archived Bitbucket repositories with CodeCatalyst projects.

• The Bitbucket repositories extension isn't compatible with Bitbucket Data Center repositories.

Once you install and configure the Bitbucket repositories extension, you will be able to:

• View your Bitbucket repositories in the list of source repositories in CodeCatalyst

• Store and manage workflow definition files in your Bitbucket repositories.

• Create, read, update, and delete files stored in linked Bitbucket repositories from CodeCatalyst Dev Environments

• Create CodeCatalyst projects with existing repositories of connected Bitbucket accounts

• Store and index files from the linked Bitbucket repositories in CodeCatalyst

• Create a Bitbucket repository with code generated by a blueprint when creating a project with a blueprint or adding a blueprint

• Start CodeCatalyst workflow runs automatically when code is pushed to linked Bitbucket repositories, or when pull requests are created, modified, or closed in linked Bitbucket repositories

• Use your linked Bitbucket repository source files in CodeCatalyst workflows

• Send CodeCatalyst workflow run statuses to linked Bitbucket repositories, and block Bitbucket pull request merges based on commit statuses

Integrating GitLab repositories in CodeCatalyst

GitLab is a cloud-based service that helps developers store and manage their code. The GitLab repositories extension lets you use linked GitLab project repositories in Amazon CodeCatalyst projects. You can also link GitLab project repositories when creating a new CodeCatalyst project. For more information, see Creating a project with a linked third-party repository.

Note

• You can't use empty or archived GitLab project repositories with CodeCatalyst projects.

• The GitLab repositories extension isn't compatible with GitLab self-managed repositories.

Once you install and configure the GitLab repositories extension, you will be able to:

• View your GitLab project repositories in the list of source repositories in CodeCatalyst

• Store and manage workflow definition files in your GitLab project repositories.

• Create, read, update, and delete files stored in linked GitLab project repositories from CodeCatalyst Dev Environments

• Create CodeCatalyst projects with existing repositories of connected GitLab users

• Store and index files from the linked GitLab project repositories in CodeCatalyst

• Create a GitLab project repository with code generated by a blueprint when creating a project with a blueprint or adding a blueprint

• Start CodeCatalyst workflow runs automatically when code is pushed to linked GitLab project repositories, or when pull requests are created, modified, or closed in linked GitLab project repositories

• Use your linked GitLab project repository source files in CodeCatalyst workflows

• Send CodeCatalyst workflow run statuses to linked GitLab project repositories, and block GitLab merge requests based on commit statuses

Integrating Jira issues in CodeCatalyst

Jira is a software application that helps agile development teams plan, assign, track, report, and manage work. The Jira Software extension lets you use Jira projects in Amazon CodeCatalyst projects.

Note

CodeCatalyst is only compatible with Jira Software Cloud.

Once you install and configure the Jira Software extension for an Amazon CodeCatalyst project, you will be able to:

• Access Jira projects from CodeCatalyst by linking them to CodeCatalyst projects

• Update Jira issues with CodeCatalyst pull requests

• View status and workflow runs of linked CodeCatalyst pull requests in Jira issues