Getting started with Bitbucket Data Center in Azure

Bitbucket Data Center is an excellent fit for the Microsoft Azure environment. Azure provides a number of managed services that work out of the box with Bitbucket Data Center instances, and handle all their configuration and maintenance automatically. You can also choose the number and size of your nodes to suit your organization's needs, and if you need to scale up or down, Azure allows you to do this.

We've set up a reference template that lets you deploy Bitbucket Data Center in Microsoft Azure, and you can then configure it depending on your organization's Azure best practices. We strongly recommend you set up user management, central logging storage, a backup strategy, and monitoring, just as you would for a Bitbucket Data Center installation running on your own hardware.


Here's an architectural overview of what you'll get when deploying Bitbucket Data Center using the template:


  • One or more Azure standard Linux VM instances as cluster nodes, running Bitbucket, in a scale set.
  • A NFS server deployed on a Linux VM, hosting the Bitbucket home directory.
  • One or more Azure standard Linux VM instances as cluster nodes, running Elasticsearch.
  • Azure SQL server database.
  • A jumpbox.
  • A load balancer and an application gateway.

The application gateway receives all the HTTP traffic, while the load balancer receives all of the SSH traffic and load balances them to the Bitbucket nodes.


Azure へのデプロイについて、次の制限事項をご確認ください。

  • 追加のノード監視は提供していません。Azure では、CPU の使用量やネットワーク / ディスク レートを含めた、いくつかの基本的な監視を提供しています。 
  • ログ集約は行われません。ログはセットアップ時にプロビジョニングされた VM 上のローカル ホーム ディレクトリにのみ保存されます。VM が失われると、ログも失われます。
  • You can't use the deployment template to upgrade an existing Bitbucket deployment, or to provision new nodes running a different version to the rest of your cluster.
  • SSL is not enabled.  You'll need to manually configure your application gateway. See the 'Additional steps required for SSL' section below for more information. 

Deploying Bitbucket Data Center to Azure via Azure marketplace

This method uses the Azure Marketplace to deploy Bitbucket Data Center using our deployment templates as a reference. 

You will need Owner permissions on the resource group into which the deployment is planned. This means adding the RBAC role “Owner” to your Azure subscription.

For related information, see What is role-based access control (RBAC) for Azure resources? (from the Azure documentation).

To deploy Bitbucket Data Center to Azure using our Marketplace app:

  1. Azure ポータルにログインします。
  2. Choose Create a resource to start a new deployment from the New menu.
  3. In New, search for Atlassian then select Bitbucket Data Center from the list of Marketplace apps.
  4. [作成] を選択してデプロイの構成を開始します。
  5. ウィザードの指示に従ってデプロイを構成します。詳細は、以下のパラメーター テーブルを参照してください。 
  6. Confirm all the details are correct then click Create to purchase the subscription. Deployment will take about 30 minutes.  
  7. Once deployment is complete, go to the Bitbucket URL listed in the deployment outputs to start using Bitbucket Data Center.  


パラメータ 説明
サブスクリプション Microsoft Azure サブスクリプション タイプ。
リソース グループ 既存のリソース グループがある場合は、それを使用するか、新しく作成できます。
場所 Azure がデプロイメントを格納する領域です。
Bitbucket administrator details

Provide administrator account details.

Number and size of Bitbucket nodes ノードの最初の数と、各ノードのサイズを指定します。これらは、後で再設定することもできます。
File server Specify the size of the file server and the disk size
Database credentials and size Specify a Azure SQL tier and optionally username and password for the database
Elasticsearch details Elasticsearch node size and disk size
Jumpbox 資格情報 ジャンプボックスのユーザー名と SSH パブリック キーを提供します。

A full and current list of parameters is available here.

Deploying Bitbucket Data Center to Azure using the CLI

This method uses the Azure command line interface to deploy Bitbucket Data Center using our deployment templates as a reference. You'll need to install the Azure CLI to do this.

To deploy Bitbucket Data Center to Azure using the command line interface:

  1. Download the azuredeploy.json template file and azuredeploy.parameters.json parameters file from the bitbucket directory on

  2. Edit the azuredeploy.parameters.json  parameters file, and insert values for the following required parameters:
    • Bitbucket admin password, the default username is bbsadmin
    • SSH key used for the jumpbox

    See the table below for more information on each of these required values. 

    The template applies sensible defaults for a number of other parameters, including the size of your VMs and database instance. You can choose to override these defaults if you want to specify particular values. 
  3. Log in to Azure via the command line interface. 
  4. リソース グループを作成します。展開する Confluence リソースのコンテナとなります。

    az group create --name BitbucketDataCenter --location "Central US"
  5. 新しいデプロイメントを作成し、Confluence Data Center テンプレート ファイルとパラメーター ファイルを指定します。

    az group deployment create \
        --name BitbucketDataCenterDeployment \
        --resource-group BitbucketDataCenter \
        --template-file azuredeploy.json \
        --parameters azuredeploy.parameters.json
  6. Log in to the Azure Portal to see the deployment outputs. The Application URL is the URL for your new Bitbucket site.
  7. Go to the Application URL in your browser to start using Bitbucket.


The deployment template requires a number of values to be provided in order to deploy your Bitbucket Data Center instance. 

パラメータ 説明


This is the SSH Key you'll use to access the jumpbox. The default username is bbsadmin


This is the password for your Bitbucket administrator's account. The default username is bbsadmin

A full and current list of parameters is available here.

SSL に必要な追加手順

As noted in limitations above, you'll need to manually configure your application gateway. See Application Gateway with SSL termination in the Microsoft Azure documentation for more information. 

最終更新日 2019 年 6 月 7 日




Powered by Confluence and Scroll Viewport.