Create a connection to Bitbucket - Developer Tools console

Create a connection to Bitbucket

You can use the AWS Management Console or the AWS Command Line Interface (AWS CLI) to create a connection to a third-party code repository.

Before you begin:

  • You must have already created an account with Bitbucket.

  • You must have already created a Bitbucket code repository..

Note

Connections only provide access to repositories owned by the account that was used to create the connection.

Create a connection to Bitbucket (console)

Step 1: Create your connection

  1. Sign in to the AWS Management Console, and open the AWS Developer Tools console at https://console.aws.amazon.com/codesuite/settings/connections.

  2. Choose Settings > Connections, and then choose Create connection.

  3. To create a connection to a Bitbucket repository, under Select a provider, choose Bitbucket. In Connection name, enter the name for the connection that you want to create. Choose Connect to Bitbucket, and proceed to Step 2.

    
                        Console screenshot showing connection option selected for
                            Bitbucket.

Step 2: Connect to Bitbucket

  1. On the Connect to Bitbucket settings page, your connection name displays.

    Under Bitbucket apps, choose an app installation or choose Install a new app to create one.

    Note

    You install one app for all of your connections to a particular provider. If you have already installed the Bitbucket app, choose it and move to the last step in this section.

    
                        Console screenshot showing the Connect to Bitbucket dialog box, with
                            the install new app button.
  2. If the login page for Bitbucket displays, log in with your credentials and then choose to continue.

  3. On the app installation page, a message shows that the AWS CodeStar app is trying to connect to your Bitbucket account. Choose Grant access.

    
                        Console screenshot showing AWS CodeStar requests access.
  4. In Bitbucket apps, the connection ID for your new installation is displayed. Choose Connect. The created connection displays in the connections list.

    
                        Console screenshot showing AWS CodeStar requests access.

Create a connection to Bitbucket (CLI)

You can use the AWS Command Line Interface (AWS CLI) to create a connection.

To do this, use the create-connection command.

Important

A connection created through the AWS CLI or AWS CloudFormation is in PENDING status by default. After you create a connection with the CLI or AWS CloudFormation, use the console to edit the connection to make its status AVAILABLE.

To create a connection to Bitbucket

  1. Open a terminal (Linux, macOS, or Unix) or command prompt (Windows). Use the AWS CLI to run the create-connection command, specifying the --provider-type and --connection-name for your connection. In this example, the third-party provider name is Bitbucket and the specified connection name is MyConnection.

    aws codestar-connections create-connection --provider-type Bitbucket --connection-name MyConnection

    If successful, this command returns the connection ARN information similar to the following.

    { "ConnectionArn": "arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f" }
  2. Use the console to complete the connection. For more information, see Update a pending connection.