1. Setup an OAuth consumer¶

To integrate your Bitbucket repositories with SymfonyCloud you will have to create an OAuth consumer for your Workspace.

1. Go to your Bitbucket Workspace and click Settings.
2. Under APPS AND FEATURES click OAuth Consumers.
3. Click the Add consumer button.
4. Fill out the information for the consumer. In order for the integration to work correctly, it’s required that you include:
   • Name: Give the consumer a recognizable name, like SymfonyCloud integration.
   • Callback URL: The URL users will be redirected to after access authorization. It is sufficient to set this value to http://localhost.
   • Set as a private consumer: At the bottom of the Details section, select the This is a private consumer checkbox.
   • Permissions: Sets the integration permissions for SymfonyCloud as follows. These permissions will allow SymfonyCloud to mirror actions from the Bitbucket repositories.
     • Account - Email, Read
     • Repositories - Read, Write
     • Pull requests - Read, Write
5. After you have completed the form, click Save.
6. Once saved, you will see your consumer listed in the OAuth consumers section. Open that item, it will expose two values that you will need to complete the integration using the CLI: Key and Secret.

2. Enable the integration¶

Enable the Bitbucket integration as follows:

1

$ symfony integration:add --type=bitbucket --repository=MY-NAMESPACE/MY-PROJECTNAME

Required configuration options:

• key: The Bitbucket OAuth consumer key
• secret: The Bitbucket OAuth consumer secret

Optional parameters:

• --build-pull-requests: Track and deploy pull-requests (true by default)
• --fetch-branches: Track and deploy branches (true by default)
• --prune-branches: Delete branches that do not exist in the remote BitBucket repository (true by default)
• --resync-pull-requests: Re-sync pull request environment data on every build (true by default)

3. Finish¶

Connect your Bitbucket repository to SymfonyCloud:

1. Copy the Hook URL shown in the summary table.
2. Go to the repository page on Bitbucket, click on the Repository Settings item, choose Webhooks and click Add webhook
3. Paste the Hook URL, choose the following triggers, and click Add webhook:
   • “Repository”
     • “Push”
     • “Updated”
   • “Pull Request”
     • “Created”
     • “Updated”
     • “Merged”
     • “Declined”

You can now start pushing code, creating new branches or opening pull requests directly on your Bitbucket repository. You will see environments get automatically created and updated on the SymfonyCloud side.