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
53e4b127
Commit
53e4b127
authored
Jun 03, 2020
by
Evan Read
Committed by
Amy Qualls
Jun 03, 2020
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Refactor Gitaly introductory text
parent
ab130380
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
24 additions
and
17 deletions
+24
-17
doc/administration/gitaly/index.md
doc/administration/gitaly/index.md
+24
-17
No files found.
doc/administration/gitaly/index.md
View file @
53e4b127
# Gitaly
[
Gitaly
](
https://gitlab.com/gitlab-org/gitaly
)
is the service that
provides high-level RPC access to Git repositories. Without it, no other
components can read or write Git data. GitLab components that access Git
repositories (GitLab Rails, GitLab Shell, GitLab Workhorse, etc.) act as clients
to Gitaly. End users do not have direct access to Gitaly.
[
Gitaly
](
https://gitlab.com/gitlab-org/gitaly
)
is the service that provides high-level RPC access to
Git repositories. Without it, no GitLab components can read or write Git data.
On this page
:
In the Gitaly documentation
:
-
**Gitaly server**
refers to any node that runs Gitaly itself.
-
**Gitaly client**
refers to any node that runs a process that makes requests of the
Gitaly server. Processes include, but are not limited to:
-
GitLab Rails application.
-
GitLab Shell.
-
GitLab Workhorse.
-
[
GitLab Rails application
](
https://gitlab.com/gitlab-org/gitlab
)
.
-
[
GitLab Shell
](
https://gitlab.com/gitlab-org/gitlab-shell
)
.
-
[
GitLab Workhorse
](
https://gitlab.com/gitlab-org/gitlab-workhorse
)
.
GitLab end users do not have direct access to Gitaly.
CAUTION:
**Caution:**
From GitLab 13.0, using NFS for Git repositories is deprecated. In GitLab 14.0,
...
...
@@ -22,7 +21,7 @@ support for NFS for Git repositories is scheduled to be removed. Upgrade to
## Architecture
Here'
s a high-level architecture overview of how Gitaly is used.
The following i
s a high-level architecture overview of how Gitaly is used.
![
Gitaly architecture diagram
](
img/architecture_v12_4.png
)
...
...
@@ -30,7 +29,7 @@ Here's a high-level architecture overview of how Gitaly is used.
The Gitaly service itself is configured via a
[
TOML configuration file
](
reference.md
)
.
If you want to change any of its
settings:
To change Gitaly
settings:
**For Omnibus GitLab**
...
...
@@ -44,12 +43,20 @@ If you want to change any of its settings:
## Running Gitaly on its own server
This is an optional way to deploy Gitaly which can benefit GitLab
installations that are larger than a single machine. Most
installations will be better served with the default configuration
used by Omnibus and the GitLab source installation guide.
Following transition to Gitaly on its own server,
[
Gitaly servers will need to be upgraded before Gitaly clients in your cluster
](
https://docs.gitlab.com/omnibus/update/#upgrading-gitaly-servers
)
.
By default, Gitaly is run on the same server as Gitaly clients and is
[
configured as above
](
#configuring-gitaly
)
. Single-server installations are best served by
this default configuration used by:
-
[
Omnibus GitLab
](
https://docs.gitlab.com/omnibus/
)
.
-
The GitLab
[
source installation guide
](
../../install/installation.md
)
.
However, Gitaly can be deployed to its own server, which can benefit GitLab installations that span
multiple machines.
NOTE:
**Note:**
When configured to run on their own servers, Gitaly servers
[
must be upgraded
](
https://docs.gitlab.com/omnibus/update/#upgrading-gitaly-servers
)
before Gitaly
clients in your cluster.
Starting with GitLab 11.4, Gitaly is able to serve all Git requests without
requiring a shared NFS mount for Git repository data.
...
...
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