Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
G
gitlab-ce
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
1
Merge Requests
1
Analytics
Analytics
Repository
Value Stream
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Commits
Issue Boards
Open sidebar
nexedi
gitlab-ce
Commits
715e195a
Commit
715e195a
authored
Apr 29, 2021
by
Lee Matos
Committed by
Ben Prescott
Apr 29, 2021
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Docs: Clarify where repository pools are stored vs. hashed storage
parent
35dda511
Changes
2
Hide whitespace changes
Inline
Side-by-side
Showing
2 changed files
with
8 additions
and
8 deletions
+8
-8
doc/administration/repository_storage_types.md
doc/administration/repository_storage_types.md
+3
-3
doc/development/git_object_deduplication.md
doc/development/git_object_deduplication.md
+5
-5
No files found.
doc/administration/repository_storage_types.md
View file @
715e195a
...
...
@@ -131,7 +131,7 @@ forks use the object pool for shared objects. For more information, see
[
How Git object deduplication works in GitLab
](
../development/git_object_deduplication.md
)
.
Objects are moved from the source project to the object pool when housekeeping is run on the source
project. Object pool repositories are stored similarly to regular repositories
:
project. Object pool repositories are stored similarly to regular repositories
in a directory called
`@pools`
instead of
`@hashed`
```
ruby
# object pool paths
...
...
@@ -139,8 +139,8 @@ project. Object pool repositories are stored similarly to regular repositories:
```
WARNING:
Do not run
`git prune`
or
`git gc`
in object pool repositories
. This can cause data loss in the
regular repositories that depend on the object pool.
Do not run
`git prune`
or
`git gc`
in object pool repositories
, which are stored in the
`@pools`
directory.
This can cause data loss in the
regular repositories that depend on the object pool.
### Object storage support
...
...
doc/development/git_object_deduplication.md
View file @
715e195a
...
...
@@ -35,9 +35,9 @@ to work, it is of course critical that **no objects ever get deleted from
B
**
because A might need them.
WARNING:
Do not run
`git prune`
or
`git gc`
in
pool repositories! This can
cause data loss in "real" repositories that depend on the pool in
question
.
Do not run
`git prune`
or
`git gc`
in
object pool repositories, which are
stored in the
`@pools`
directory. This can cause data loss in the regular
repositories that depend on the object pool
.
The danger lies in
`git prune`
, and
`git gc`
calls
`git prune`
. The
problem is that
`git prune`
, when running in a pool repository, cannot
...
...
@@ -45,8 +45,8 @@ reliable decide if an object is no longer needed.
### Git alternates in GitLab: pool repositories
GitLab organizes this object borrowing by creating special
**
pool
repositories
**
which are hidden from the user. We then use Git
GitLab organizes this object borrowing by
[
creating special **pool
repositories**
](
../administration/repository_storage_types.md
)
which are hidden from the user. We then use Git
alternates to let a collection of project repositories borrow from a
single pool repository. We call such a collection of project
repositories a pool. Pools form star-shaped networks of repositories
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment