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
deafb7bd
Commit
deafb7bd
authored
Apr 30, 2021
by
Nick Nguyen
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Update terminology in geo/replication/location_aware_git_url.md
parent
d7281e68
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
15 additions
and
15 deletions
+15
-15
doc/administration/geo/replication/location_aware_git_url.md
doc/administration/geo/replication/location_aware_git_url.md
+15
-15
No files found.
doc/administration/geo/replication/location_aware_git_url.md
View file @
deafb7bd
...
...
@@ -8,11 +8,11 @@ type: howto
# Location-aware Git remote URL with AWS Route53 **(PREMIUM SELF)**
You can provide GitLab users with a single remote URL that automatically uses
the Geo
nod
e closest to them. This means users don't need to update their Git
configuration to take advantage of closer Geo
nod
es as they move.
the Geo
sit
e closest to them. This means users don't need to update their Git
configuration to take advantage of closer Geo
sit
es as they move.
This is possible because, Git push requests can be automatically redirected
(HTTP) or proxied (SSH) from
**secondary**
nodes to the
**primary**
nod
e.
(HTTP) or proxied (SSH) from
**secondary**
sites to the
**primary**
sit
e.
Though these instructions use
[
AWS Route53
](
https://aws.amazon.com/route53/
)
,
other services such as
[
Cloudflare
](
https://www.cloudflare.com/
)
could be used
...
...
@@ -20,30 +20,30 @@ as well.
NOTE:
You can also use a load balancer to distribute web UI or API traffic to
[
multiple Geo **secondary**
nod
es
](
../../../user/admin_area/geo_nodes.md#multiple-secondary-nodes-behind-a-load-balancer
)
.
Importantly, the
**primary**
nod
e cannot yet be included. See the feature request
[
multiple Geo **secondary**
sit
es
](
../../../user/admin_area/geo_nodes.md#multiple-secondary-nodes-behind-a-load-balancer
)
.
Importantly, the
**primary**
sit
e cannot yet be included. See the feature request
[
Support putting the **primary** behind a Geo node load balancer
](
https://gitlab.com/gitlab-org/gitlab/-/issues/10888
)
.
## Prerequisites
In this example, we have already set up:
-
`primary.example.com`
as a Geo
**primary**
nod
e.
-
`secondary.example.com`
as a Geo
**secondary**
nod
e.
-
`primary.example.com`
as a Geo
**primary**
sit
e.
-
`secondary.example.com`
as a Geo
**secondary**
sit
e.
We will create a
`git.example.com`
subdomain that will automatically direct
requests:
-
From Europe to the
**secondary**
nod
e.
-
From all other locations to the
**primary**
nod
e.
-
From Europe to the
**secondary**
sit
e.
-
From all other locations to the
**primary**
sit
e.
In any case, you require:
-
A working GitLab
**primary**
nod
e that is accessible at its own address.
-
A working GitLab
**secondary**
nod
e.
-
A working GitLab
**primary**
sit
e that is accessible at its own address.
-
A working GitLab
**secondary**
sit
e.
-
A Route53 Hosted Zone managing your domain.
If you haven't yet set up a Geo _primary_
node and _secondary_ nod
e, see the
If you haven't yet set up a Geo _primary_
site and _secondary_ sit
e, see the
[
Geo setup instructions
](
../index.md#setup-instructions
)
.
## Create a traffic policy
...
...
@@ -89,7 +89,7 @@ routing configurations.
!
[
Created policy record
](
img/single_git_created_policy_record.png
)
You have successfully set up a single host, e.g.
`git.example.com`
which
distributes traffic to your Geo
nod
es by geolocation!
distributes traffic to your Geo
sit
es by geolocation!
## Configure Git clone URLs to use the special Git URL
...
...
@@ -114,10 +114,10 @@ You can customize the:
After following the configuration steps above, handling for Git requests is now location aware.
For requests:
-
Outside Europe, all requests are directed to the
**primary**
nod
e.
-
Outside Europe, all requests are directed to the
**primary**
sit
e.
-
Within Europe, over:
-
HTTP:
-
`git clone http://git.example.com/foo/bar.git`
is directed to the
**secondary**
nod
e.
-
`git clone http://git.example.com/foo/bar.git`
is directed to the
**secondary**
sit
e.
-
`git push`
is initially directed to the
**secondary**
, which automatically
redirects to
`primary.example.com`
.
-
SSH:
...
...
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