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
de2fffe7
Commit
de2fffe7
authored
Dec 12, 2021
by
John Cai
Committed by
Evan Read
Dec 12, 2021
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Update remove-repository documentation
parent
30878001
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
13 additions
and
3 deletions
+13
-3
doc/administration/gitaly/recovery.md
doc/administration/gitaly/recovery.md
+13
-3
No files found.
doc/administration/gitaly/recovery.md
View file @
de2fffe7
...
...
@@ -295,18 +295,28 @@ sudo /opt/gitlab/embedded/bin/praefect -config /var/opt/gitlab/praefect/config.t
### Manually remove repositories
> [Introduced](https://gitlab.com/gitlab-org/gitaly/-/merge_requests/3767) in GitLab 14.3.
> - [Introduced](https://gitlab.com/gitlab-org/gitaly/-/merge_requests/3767) in GitLab 14.3.
> - [Introduced](https://gitlab.com/gitlab-org/gitaly/-/merge_requests/4054) in GitLab 14.6, support for dry-run mode.
The
`remove-repository`
Praefect sub-command removes repositories from a Gitaly Cluster. It removes
all state associated with a given repository including:
The
`remove-repository`
Praefect sub-command removes a repository from a Gitaly Cluster, and all state associated with a given repository including:
-
On-disk repositories on all relevant Gitaly nodes.
-
Any database state tracked by Praefect.
In GitLab 14.6 and later, by default, the command operates in dry-run mode. In earlier versions, the command didn't support dry-run mode. For example:
```
shell
sudo
/opt/gitlab/embedded/bin/praefect
-config
/var/opt/gitlab/praefect/config.toml remove-repository
-virtual-storage
<virtual-storage>
-repository
<repository>
```
-
Replace
`<virtual-storage>`
with the name of the virtual storage containing the repository.
-
Replace
`<repository>`
with the relative path of the repository to remove.
-
In GitLab 14.6 and later, add
`-apply`
to run the command outside of dry-run mode and remove the repository. For example:
```
shell
sudo
/opt/gitlab/embedded/bin/praefect
-config
/var/opt/gitlab/praefect/config.toml remove-repository
-virtual-storage
<virtual-storage>
-repository
<repository>
-apply
```
-
`-virtual-storage`
is the virtual storage the repository is located in. Virtual storages are configured in
`/etc/gitlab/gitlab.rb`
under
`praefect['virtual_storages]`
and looks like the following:
```
ruby
...
...
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