How to find the Repository ID, Hierarchy ID, Partition ID and Repository location on disk for Mesh Repositories
プラットフォームについて: Data Center - この記事は、Data Center プラットフォームのアトラシアン製品に適用されます。
このナレッジベース記事は製品の Data Center バージョン用に作成されています。Data Center 固有ではない機能の Data Center ナレッジベースは、製品のサーバー バージョンでも動作する可能性はありますが、テストは行われていません。サーバー*製品のサポートは 2024 年 2 月 15 日に終了しました。サーバー製品を利用している場合は、アトラシアンのサーバー製品のサポート終了のお知らせページにて移行オプションをご確認ください。
*Fisheye および Crucible は除く
目的
When a repository is created or migrated to mesh, the location of the repository contents changes. The Repository settings page shows the repository location on disk if the repository is not migrated and is still located in the shared home directory. For migrated and remote Mesh repositories, the Repository settings page no longer will show the full path on disk. The value is updated to show which mesh nodes hold the repository instead.
Bitbucket mesh includes the Hierarchy ID in its path on disk, and includes the Partition ID in its logs. It is valuable to retrieve these details in order to find the repository location on disk and troubleshoot issues with git repositories.
環境
Bitbucket server 8+
Repositories located on Remote mesh nodes
ソリューション
Finding the Repository ID, Hierarchy ID, Partition ID of a mesh repository
- Navigate to the repository in the browser. For example: https://bb.test/projects/PRJ/repos/myrepo/settings
- Insert "/
rest/api/latest" before "projects"in the URL, and trim the "settings" on the end of the URL. The final result should look like: https://bb.test/rest/api/latest/projects/PRJ/repos/myrepo - Open the page REST API to generate a JSON of repository metadata, where you can find the RepositoryId (id), hierarchyId. and partitionId (partition).
The Rest endpoint that is used is
GET <Base-URL>/rest/api/latest/projects/<Project-Key>/repos/<Repo-Slug>Finding the Repository location on disk of a mesh repository
Mesh Repositories will be located on at least 3 remote mesh nodes. To confirm the mesh nodes look at the location field in Repository settings. In order to confirm which mesh nodes are which you can use the following Rest API to get a list of mesh nodes and their URL's:
GET <Base-URL>/rest/api/1.0/admin/git/mesh/nodesAfter you have the Repository ID, Hierarchy ID, partition ID, and the mesh nodes which hold the repository, you can do the following:
- Identify the Home directory for the Mesh node
- Convert the partition ID to its 4-digit hex equivalent
Fill in the path below with Mesh home directory, partition ID in hex, Hierarchy ID and Repository ID:
<Mesh-Home-Directory>/store/data/<Partition-ID-in-Hex>/<Hierarchy-ID>/repos/<Repository-ID>
例:
Mesh-Home-Directory: /home/ec2-user/mesh1-home
Partition ID: 30 (001e in hex)
Hierarchy ID: e1f2cd68cc7f4f58ed7e
Repository ID: 15Becomes:
/home/ec2-user/mesh1-home/store/data/001e/e1f2cd68cc7f4f58ed7e/repos/15