Sync With Bitbucket
Integrate Amplication with Bitbucket for centralized resource management and smart Git workflows across your organization.
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.
Navigate to Your Amplication Workspace
Access your workspace within the Amplication platform.
Select the 'Projects' Tab
Find and select the “Projects” tab in the navigation bar.
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.
Select the 'Git Settings' Tab
Select the Git Settings tab. If a repository is already connected, click Change Repository
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.
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
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).
Make Changes
Update your resource in Amplication, whether it’s adjusting service settings, adding entities, or refining API specifications.
Generate Code
- Access the pending changes sidebar in your Service Catalog.
- 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.
Was this page helpful?