Commit d6841c0e authored by Achilleas Pipinellis's avatar Achilleas Pipinellis

Merge branch...

Merge branch '327539-geo-docs-replace-node-with-site-in-replication-location_aware_git_url-md' into 'master'

Replace node with site in replication/location_aware_git_url.md

See merge request gitlab-org/gitlab!60721
parents 01eeecf3 deafb7bd
...@@ -8,11 +8,11 @@ type: howto ...@@ -8,11 +8,11 @@ type: howto
# Location-aware Git remote URL with AWS Route53 **(PREMIUM SELF)** # Location-aware Git remote URL with AWS Route53 **(PREMIUM SELF)**
You can provide GitLab users with a single remote URL that automatically uses You can provide GitLab users with a single remote URL that automatically uses
the Geo node closest to them. This means users don't need to update their Git the Geo site closest to them. This means users don't need to update their Git
configuration to take advantage of closer Geo nodes as they move. configuration to take advantage of closer Geo sites as they move.
This is possible because, Git push requests can be automatically redirected This is possible because, Git push requests can be automatically redirected
(HTTP) or proxied (SSH) from **secondary** nodes to the **primary** node. (HTTP) or proxied (SSH) from **secondary** sites to the **primary** site.
Though these instructions use [AWS Route53](https://aws.amazon.com/route53/), Though these instructions use [AWS Route53](https://aws.amazon.com/route53/),
other services such as [Cloudflare](https://www.cloudflare.com/) could be used other services such as [Cloudflare](https://www.cloudflare.com/) could be used
...@@ -20,30 +20,30 @@ as well. ...@@ -20,30 +20,30 @@ as well.
NOTE: NOTE:
You can also use a load balancer to distribute web UI or API traffic to You can also use a load balancer to distribute web UI or API traffic to
[multiple Geo **secondary** nodes](../../../user/admin_area/geo_nodes.md#multiple-secondary-nodes-behind-a-load-balancer). [multiple Geo **secondary** sites](../../../user/admin_area/geo_nodes.md#multiple-secondary-nodes-behind-a-load-balancer).
Importantly, the **primary** node cannot yet be included. See the feature request Importantly, the **primary** site 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). [Support putting the **primary** behind a Geo node load balancer](https://gitlab.com/gitlab-org/gitlab/-/issues/10888).
## Prerequisites ## Prerequisites
In this example, we have already set up: In this example, we have already set up:
- `primary.example.com` as a Geo **primary** node. - `primary.example.com` as a Geo **primary** site.
- `secondary.example.com` as a Geo **secondary** node. - `secondary.example.com` as a Geo **secondary** site.
We will create a `git.example.com` subdomain that will automatically direct We will create a `git.example.com` subdomain that will automatically direct
requests: requests:
- From Europe to the **secondary** node. - From Europe to the **secondary** site.
- From all other locations to the **primary** node. - From all other locations to the **primary** site.
In any case, you require: In any case, you require:
- A working GitLab **primary** node that is accessible at its own address. - A working GitLab **primary** site that is accessible at its own address.
- A working GitLab **secondary** node. - A working GitLab **secondary** site.
- A Route53 Hosted Zone managing your domain. - A Route53 Hosted Zone managing your domain.
If you haven't yet set up a Geo _primary_ node and _secondary_ node, see the If you haven't yet set up a Geo _primary_ site and _secondary_ site, see the
[Geo setup instructions](../index.md#setup-instructions). [Geo setup instructions](../index.md#setup-instructions).
## Create a traffic policy ## Create a traffic policy
...@@ -89,7 +89,7 @@ routing configurations. ...@@ -89,7 +89,7 @@ routing configurations.
![Created policy record](img/single_git_created_policy_record.png) ![Created policy record](img/single_git_created_policy_record.png)
You have successfully set up a single host, e.g. `git.example.com` which You have successfully set up a single host, e.g. `git.example.com` which
distributes traffic to your Geo nodes by geolocation! distributes traffic to your Geo sites by geolocation!
## Configure Git clone URLs to use the special Git URL ## Configure Git clone URLs to use the special Git URL
...@@ -114,10 +114,10 @@ You can customize the: ...@@ -114,10 +114,10 @@ You can customize the:
After following the configuration steps above, handling for Git requests is now location aware. After following the configuration steps above, handling for Git requests is now location aware.
For requests: For requests:
- Outside Europe, all requests are directed to the **primary** node. - Outside Europe, all requests are directed to the **primary** site.
- Within Europe, over: - Within Europe, over:
- HTTP: - HTTP:
- `git clone http://git.example.com/foo/bar.git` is directed to the **secondary** node. - `git clone http://git.example.com/foo/bar.git` is directed to the **secondary** site.
- `git push` is initially directed to the **secondary**, which automatically - `git push` is initially directed to the **secondary**, which automatically
redirects to `primary.example.com`. redirects to `primary.example.com`.
- SSH: - SSH:
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment