Working with connections - Developer Tools console

Working with connections

Connections are configurations that you use to connect AWS resources to external code repositories. Each connection is a resource that can be given to services such as AWS CodePipeline to connect to a third-party repository such as Bitbucket. For example, you can add the connection in CodePipeline so that it triggers your pipeline when a code change is made to your third-party code repository. You can also connect your AWS resources to an installed provider type such as GitHub Enterprise Server.

If you want to create a connection to an installed provider type, such as GitHub Enterprise Server, the console creates a host for you. A host is a resource that you create to represent the server where your provider is installed. For more information, see Working with hosts.

When you create a connection, you use a wizard in the console to install the AWS CodeStar app with your third-party provider and associate it with a new connection. If you have already installed the AWS CodeStar app, you can use it.

For more information about connections, see the AWS CodeStar Connections API reference. For more information about the CodePipeline source action for Bitbucket, see CodestarConnectionSource in the AWS CodePipeline User Guide.

To create or attach a policy to your AWS Identity and Access Management (IAM) user or role with the permissions required to use AWS CodeStar connections, see AWS CodeStar Connections permissions reference. Depending on when your CodePipeline service role was created, you might need to update its permissions to support AWS CodeStar connections. For instructions, see Update the service role in the AWS CodePipeline User Guide.