reference deployment

Bitbucket Data Center on AWS

Code collaboration with high availability and scalability

This Partner Solution sets up a flexible, scalable Amazon Web Services (AWS) Cloud environment, and launches Bitbucket Data Center automatically into a configuration of your choice.

Bitbucket Data Center is a Git repository management solution from Atlassian. It provides source code collaboration for enterprises that require high availability and performance at scale. 

This Partner Solution uses the Atlassian Standard Infrastructure (ASI) as a foundation. You can also deploy Jira products and Confluence Data Center within the same ASI.

This Partner Solution was developed by Atlassian in collaboration with AWS. Atlassian is an AWS Partner.


AWS Service Catalog administrators can add this architecture to their own catalog.  

  •  What you'll build
  • Use this Partner Solution to set up the following Bitbucket Data Center environment on AWS:

    • A virtual private cloud (VPC) configured with public and private subnets. This provides the network infrastructure for your Bitbucket Data Center deployment.*
    • Amazon Elastic Load Balancing, which works both as a load balancer and a Secure Sockets Layer (SSL) termination reverse proxy.
    • In the public subnets: 
      • Managed network address translation (NAT) gateways to allow outbound internet access for resources in the private subnets.*
      • A Linux bastion host to allow secure access to your Bitbucket application.*
    • In the private subnets:
      • A Bitbucket Data Center cluster with instances based on Amazon Linux.
      • Amazon Relational Database Service (Amazon RDS) PostgreSQL as the external database for Bitbucket Data Center. You can choose Amazon Aurora PostgreSQL instead.
      • A network file system (NFS) server instance. This provides a shared file system with an attached Amazon Elastic Block Store (Amazon EBS) volume for storing repositories.
    • Amazon Elasticsearch Service (Amazon ES) for Elasticsearch 2.3 indexing and searching functionality.
    • Amazon CloudWatch for basic monitoring of all application and database nodes in your deployment. By default, CloudWatch also collects and stores logs from each monitored node.

    * If you're deploying Bitbucket into an existing Atlassian Standard Infrastructure (ASI), the Partner Solution detects the components marked by asterisks, and provisions Bitbucket into your existing ASI. 

  •  How to deploy
  • Build your Bitbucket Data Center cluster in a few simple steps:

    1. If you don't already have an AWS account, sign up at https://aws.amazon.com.
    2. Launch the Partner Solution. You can choose to build a new Atlassian Standard Infrastructure (ASI) for your deployment or deploy Bitbucket into your existing ASI:
    3. Configure Bitbucket Data Center for multiple nodes.
    4. Add nodes to the cluster.

    To customize your deployment, you can choose different instance types for your resources, configure your cluster nodes, and adjust file server and database settings.

    Amazon may share user-deployment information with the AWS Partner that collaborated with AWS on this solution.  

  •  Costs and licenses
  • You are responsible for the cost of the AWS services used while running this Partner Solution reference deployment. There is no additional cost for using the Partner Solution.

    The AWS CloudFormation template for this Partner Solution includes configuration parameters that you can customize. Some of these settings, such as instance type, affect the cost of deployment. Refer to the pricing pages for each AWS service you will be using for cost estimates. Prices are subject to change.

    Tip: After you deploy the Partner Solution, we recommend that you enable the AWS Cost and Usage Report to track costs associated with the Partner Solution. This report delivers billing metrics to an S3 bucket in your account. It provides cost estimates based on usage throughout each month, and finalizes the data at the end of the month. For more information about the report, refer to the AWS documentation.

    This Partner Solution requires a Bitbucket Data Center license. For information about obtaining a license, refer to the Atlassian pricing page. The Partner Solution can't be used with Bitbucket Server licenses.

    If you want to evaluate Bitbucket Data Center, you can also request an evaluation license when you configure the product after deployment.