An Amplication-generated Bitbucket Pull Request

Amplication seamlessly integrates with Bitbucket, Atlassian’s platform for code collaboration. By connecting Amplication to your Bitbucket workspace, you automate the synchronization of updates using Smart Git Sync, significantly reducing code drift and the accumulation of technical debt.

​
Connect Your Bitbucket Workspace

Begin by linking your Bitbucket workspace to Amplication. This connection allows Amplication to manage repositories, branches, and pull requests directly within your Bitbucket environment, streamlining your workflow.
1

Navigate to Your Amplication Workspace

Access your workspace within the Amplication platform.
2

Select the 'Projects' Tab

Find and select the “Projects” tab in the navigation bar.
3

Select a specific project's 'Software Catalog'

Click on your desired project to access its Software Catalog, where you can manage all services and resources.
4

Select the 'Git Settings' Tab

Select the Git Settings tab. If a repository is already connected, click Change Repository
5

Select Git Organization

After clicking “Change Repository”, select “Select Git Organization” to choose a new Bitbucket workspace for your repository.

Adding a Bitbucket workspace

​
Authorization and Repository Selection

When you choose to integrate with Bitbucket, Amplication will request necessary permissions to access and manage your repositories. This ensures automated, consistent synchronization across your organization’s codebase.
1

Authorize Amplication's Bitbucket Integration

You’ll be redirected to Bitbucket to authorize Amplication to access your workspace. Grant the necessary permissions to enable seamless integration.

Authorize Amplication to access your Bitbucket workspace

2

Choose or Create a Repository

Once your workspace is selected, configure your repository:

Use Existing Repository

Select an existing repository from your Bitbucket workspace to connect to Amplication.

Create a New Repository

Create a new Bitbucket repository directly through Amplication to house your generated code.

Select your repository

You can connect multiple Bitbucket workspaces if your organization uses more than one. Simply repeat the steps above for each workspace you need to integrate.

​
Working with Pull Requests

Any changes you make to your resources within Amplication, such as adding a new entity, modifying configurations, or updating API endpoints, are automatically compiled into commits on a dedicated amplication branch. If a pull request is not already open, Amplication will automatically generate a new pull request from the amplication branch to your designated base branch (e.g., main or develop).
1

Make Changes

Update your resource in Amplication, whether it’s adjusting service settings, adding entities, or refining API specifications.
2

Generate Code

  1. Access the pending changes sidebar in your Service Catalog.
  2. Click “Generate the code” to initiate the build process and prepare the code changes.
To learn how to update the base branch, visit the Smart Git Sync page.

​
Next Steps

Your Bitbucket integration is now active. For a broader understanding of Amplication’s automated synchronization, visit the Smart Git Sync page.

Generate Code

Learn more about generating and building your service code using Amplication.

Smart Git Sync

Explore how Amplication automates the synchronization of your changes with Git.

Resource-Level Git Setup

Discover how to configure Git settings at the individual resource level within your project.