Adding additional storage for your repository data

Administering Bitbucket Server

このページの内容

お困りですか?

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

コミュニティに質問

This feature is only compatible with Bitbucket Data Center. It cannot be used by instances running Bitbucket Server. 

As the repository data in your Bitbucket Data Center grows it may become too large to hold in a single storage location. When this happens, you'll need to add additional storage space. There are two ways to do this: 

  1. Increase the storage space allocated to your shared home directory
  2. Add additional data stores

Increasing the storage space allocated to your shared home directory is the most straightforward option, and we recommend it for most customers. If this is not an option for you (for example, because of a company policy limiting the size of disks or partitions), you should add a data store. 

Before adding a data store, read through the considerations below.

On this page:


Data store considerations 

The ability to add data stores is aimed at organizations with limitations on disk partition size. It's not intended as a way to increase disk performance. In addition: 

  • Data stores cannot be moved or removed, once added. 
  • Any nodes that don't have access to the data store won't join the cluster until it's mounted and the node is restarted.
  • Repository data cannot be moved between data stores. Once a repository has been created in the shared home directory or on a data store, all of its data will stay there, including the data in its forks, any pull request attachments, and Git LFS data.

Adding a data store using Storage Management

You don't need to stop your Bitbucket Data Center system to add a data store. 

To add a new data store:

  1. Create a new shared filesystem.
  2. Mount the shared filesystem on all nodes making sure that: 
    • the filesystem is writeable by the user running the Bitbucket Data Center process.
    • the data store is not a subdirectory or parent directory of the shared home or another data store.
    • the data store is mounted on all nodes in the same location using NFS.
  3. In Bitbucket, go to > Storage > Add a data store.
  4. Enter the data store directory path, and click Check path

  5. Click Add data store.
    • If you get an error use the IP address included below the message to find the affected node and fix the problem. 

Shared home use after adding a data store

After one or more data stores have been added to Bitbucket, the system will not use the shared home directory to store new repositories, except in a few situations. 

For example, new forks of repositories stored in the shared home directory will still be created in this directory. This is because Bitbucket stores forks in the same location as their origin repository to save disk space. New attachments and new LFS objects for repository hierarchies stored on the shared home will also continue to be added to the shared home. Lastly, the shared home will continue to hold data that is not related to a single repository, such as user avatars.

最終更新日: 2021 年 2 月 2 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.