Using Bitbucket Server in the enterprise



アトラシアン コミュニティをご利用ください。


This page describes best practices for using Bitbucket Server in enterprise environments. If you're evaluating Bitbucket Server, we suggest that you begin with Install a Bitbucket Server trial, instead of this page.

Bitbucket Server is the Git code management solution for enterprise teams. It allows everyone in your organization to easily collaborate on your Git repositories, while providing enterprise-grade support for:

  • ユーザー認証
  • リポジトリのセキュリティ
  • integration with existing databases and dev environment.


Atlassian offers two deployment options for Bitbucket Server.

Bitbucket Server

For most organizations, a single instance of Bitbucket Server provides good performance. Continue reading this page for guidance on best practices in setting up a Bitbucket Server instance in a production environment.

Bitbucket Data Center

For larger enterprises that require high availability and greater performance at scale, Bitbucket Data Center resources uses a cluster of Bitbucket Server nodes to provide Active/Active failover, and is the deployment option of choice. 



コア機能 Server ライセンス Data Center ライセンス
変更をマージする前にチームとコード レビューやディスカッションを行います。詳細情報


ユーザーが、リポジトリまたはプロジェクト内の 1 つのブランチ、ブランチ タイプ、またはブランチ パターンで実行できる内容を制御します。詳細情報

一元化された、フォーク、Gitflow、またはフォーク ワークフローを使用します。詳細情報

Git LFS (Large File Storage)
外部オブジェクト ストアなしで大きなファイルを保存します。詳細情報

CI と課題追跡アプリケーションの統合
Bitbucket を Jira、Bamboo、Sourcetree と接続して、より優れた開発者エクスペリエンスを実現します。詳細情報


外部ユーザー ディレクトリ
Active Directory、Crowd、Jira または別の LDAP ディレクトリにユーザーを保存します。詳細情報

SAML シングル サインオン
認証とシングル サインオンに SAML アイデンティティ プロバイダーを使用します。詳細情報


高可用性を実現するため、複数のノードで Bitbucket を実行します。詳細情報

スマート ミラーリング
大規模なリポジトリを使用する分散チームで、Git クローンの速度を大幅に改善することができます。詳細情報

Bitbucket をリモート Elasticsearch インスタンスに接続して、スケーラビリティを向上させます (Data Center サイトで必要)。詳細情報


サードパーティ製アプリ (アドオン) に関する潜在的なパフォーマンスのの問題を含む、サイトの健康状態の概要を取得します。詳細情報

ゼロダウンタイム バックアップのための整合性テスト
データベースとホーム ディレクトリの間の不一致 (バックアップを復元した後など) を見つけて解決します。詳細情報

デプロイメント オプション

Bitbucket を独自の物理サーバー、仮想サーバー、またはお好きなデータセンターで実行します。

AWS クイック スタートおよび Cloud Formation テンプレート
Cloud Formation テンプレートを使用して AWS で Bitbucket をデプロイします。詳細情報

Platform requirements

Although Bitbucket Server can be run on Windows, Linux and Mac systems, for enterprise use we only recommend, and support using Linux. This recommendation is based on our own testing and experience with using Bitbucket Server.

Java、外部データベース、Web ブラウザおよび Git のサポート対象バージョンの詳細については、「サポート対象プラットフォーム」ページを参照してください。

See Installing Bitbucket Data Center for detailed information about Bitbucket Data Center requirements.

Performance considerations

In general, Bitbucket Server is very stable and has low memory consumption. There are no scalability limits other than for Git hosting operations (clone in particular). We know this is the scalability limit of the product; the limit is proportional to the number of cores on the system.

As an example, data collected from an internal Bitbucket Server instance indicate that for a team of approximately 50 developers, with associated continuous integration infrastructure, we see a peak concurrency of 30 simultaneous clone operations and a mean of 2 simultaneous clone operations. We conservatively expect that a customer with similar usage patterns would be capable of supporting 1000 users on a machine with 40 cores and a supporting amount of RAM. While we expect a peak concurrency larger than 40, Bitbucket Server is designed to queue incoming requests so as to avoid overwhelming the server.

Bitbucket Server – see Bitbucket Server production server data for data from the Bitbucket Server production instance we run internally at Atlassian.

Bitbucket Data Center – see Bitbucket Data Center Performance for the results of our performance testing for clusters of different sizes.


If Bitbucket Server is a critical part of your development workflow, maximizing Bitbucket Server availability becomes an important consideration.

Bitbucket Server – see High availability for Bitbucket Server for the background information you need to set up Bitbucket Server in a highly available configuration. 

Bitbucket Data Center – see Failover for Bitbucket Data Center for information about how Bitbucket Data Center provides HA and almost instant failover.


Bitbucket Server is built with enterprise scaling and infrastructure flexibility in mind, giving administrators control over how Bitbucket Server fits into their environment: 

  • For most organizations, a single instance of Bitbucket Server provides good performance. Continue reading this page for guidance on best practice in setting up a Bitbucket Server instance in a production environment.
  • For larger enterprises that require HA and greater performance at scale, Bitbucket Data Center uses a cluster of Bitbucket Server nodes and is the deployment option of choice.

Your single instance of Bitbucket Server can be easily upgraded to Bitbucket Data Center when the time comes.

Bitbucket Server – see Scaling Bitbucket Server for information about how you can tune your Bitbucket Server instance to grow with your organization's needs. See also Scaling Bitbucket Server for Continuous Integration performance for information specific to Bitbucket Server performance when CI tools poll Bitbucket Server for changes.

Bitbucket Data Center – see Adding cluster nodes to Bitbucket Data Center for information about how you can rapidly provision extra capacity without downtime.


Some possible approaches to provisioning Bitbucket Server include:

Setting up a production environment

When setting up Bitbucket Server for a production or enterprise environment, we highly recommend that you configure the following aspects:

Run Bitbucket Server as a dedicated user
Bitbucket Server をサービスとしてインストールする
  • For production environments Bitbucket Server should use an external database, rather than the embedded database. Set up your external DBMS (for example MySQL) before starting Bitbucket Server for the first time. This allows you to connect Bitbucket Server to that DBMS using the Setup Wizard that launches when you first run Bitbucket Server. See Connecting Bitbucket Server to an external database.
Secure the Bitbucket home directory
Secure Bitbucket Server with HTTPS
  • Access to Bitbucket Server should be secured using HTTP over SSL, especially if your data is sensitive and Bitbucket Server is exposed to the internet. See Securing Bitbucket Server with HTTPS.
Git リポジトリへの SSH アクセスを有効にする
  • Enable SSH access for your Bitbucket Server users to Git repositories in Bitbucket Server so that they can add their own SSH keys to Bitbucket Server, and then use those SSH keys to secure Git operations between their computer and the Bitbucket Server instance. See Enabling SSH access to Git repositories in Bitbucket Server.
Change the context path for Bitbucket Server
  • If you are running Bitbucket Server behind a proxy, or you have another Atlassian application (or any Java web application), available at the same hostname and context path as Bitbucket Server, then you should set a unique context path for Bitbucket Server. See Moving Bitbucket Server to a different context path.

Administering a production environment

Upgrading Bitbucket Server
  • For production environments we recommend that you test the Bitbucket Server upgrade on a QA server before deploying to production. See the Bitbucket Server upgrade guide.
  • We highly recommend that you establish a data recovery plan that is aligned with your company's policies. See Data recovery and backups for information about tools and backup strategies for Bitbucket Server.
  • Bitbucket Server instance logs can be found in  <Bitbucket home directory>/log. Logs for the bundled Tomcat webserver can be found in  <Bitbucket Server installation directory>/log. See Bitbucket Server debug logging.
  • Bitbucket Server displays recent audit events for each repository and project (only visible to Bitbucket Server admins and system admins), and also creates full audit log files that can be found in the <Bitbucket home directory >/audit/logs directory. Note that Bitbucket Server has an upper limit to the number of log files it maintains, and deletes the oldest file when a new file is created – we recommend an automated backup of log files. See Audit logging in Bitbucket Server.
最終更新日 2018 年 7 月 20 日


Powered by Confluence and Scroll Viewport.