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
Show 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
[
Gitaly
](
https://gitlab.com/gitlab-org/gitaly
)
is the service that
[
Gitaly
](
https://gitlab.com/gitlab-org/gitaly
)
is the service that provides high-level RPC access to
provides high-level RPC access to Git repositories. Without it, no other
Git repositories. Without it, no GitLab components can read or write Git data.
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.
On this page
:
In the Gitaly documentation
:
-
**Gitaly server**
refers to any node that runs Gitaly itself.
-
**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 client**
refers to any node that runs a process that makes requests of the
Gitaly server. Processes include, but are not limited to:
Gitaly server. Processes include, but are not limited to:
-
GitLab Rails application.
-
[
GitLab Rails application
](
https://gitlab.com/gitlab-org/gitlab
)
.
-
GitLab Shell.
-
[
GitLab Shell
](
https://gitlab.com/gitlab-org/gitlab-shell
)
.
-
GitLab Workhorse.
-
[
GitLab Workhorse
](
https://gitlab.com/gitlab-org/gitlab-workhorse
)
.
GitLab end users do not have direct access to Gitaly.
CAUTION:
**Caution:**
CAUTION:
**Caution:**
From GitLab 13.0, using NFS for Git repositories is deprecated. In GitLab 14.0,
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
...
@@ -22,7 +21,7 @@ support for NFS for Git repositories is scheduled to be removed. Upgrade to
## Architecture
## 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
)
![
Gitaly architecture diagram
](
img/architecture_v12_4.png
)
...
@@ -30,7 +29,7 @@ Here's a high-level architecture overview of how Gitaly is used.
...
@@ -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
)
.
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**
**For Omnibus GitLab**
...
@@ -44,12 +43,20 @@ If you want to change any of its settings:
...
@@ -44,12 +43,20 @@ If you want to change any of its settings:
## Running Gitaly on its own server
## Running Gitaly on its own server
This is an optional way to deploy Gitaly which can benefit GitLab
By default, Gitaly is run on the same server as Gitaly clients and is
installations that are larger than a single machine. Most
[
configured as above
](
#configuring-gitaly
)
. Single-server installations are best served by
installations will be better served with the default configuration
this default configuration used by:
used by Omnibus and the GitLab source installation guide.
Following transition to Gitaly on its own server,
-
[
Omnibus GitLab
](
https://docs.gitlab.com/omnibus/
)
.
[
Gitaly servers will need to be upgraded before Gitaly clients in your cluster
](
https://docs.gitlab.com/omnibus/update/#upgrading-gitaly-servers
)
.
-
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
Starting with GitLab 11.4, Gitaly is able to serve all Git requests without
requiring a shared NFS mount for Git repository data.
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