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
8d0da0ef
Commit
8d0da0ef
authored
Sep 02, 2021
by
Ben Prescott @bprescott_↙ ☺
Committed by
Achilleas Pipinellis
Sep 02, 2021
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
docs: Go get off Geo secondary
parent
5726de8b
Changes
2
Hide whitespace changes
Inline
Side-by-side
Showing
2 changed files
with
56 additions
and
0 deletions
+56
-0
doc/administration/geo/replication/usage.md
doc/administration/geo/replication/usage.md
+10
-0
doc/user/project/working_with_projects.md
doc/user/project/working_with_projects.md
+46
-0
No files found.
doc/administration/geo/replication/usage.md
View file @
8d0da0ef
...
...
@@ -33,3 +33,13 @@ you can't store credentials in the URL like `user:password@URL`. Instead, you ca
for Unix-like operating systems or
`_netrc`
for Windows. In that case, the credentials
will be stored as a plain text. If you're looking for a more secure way to store credentials,
you can use
[
Git Credential Storage
](
https://git-scm.com/book/en/v2/Git-Tools-Credential-Storage
)
.
## Fetch Go modules from Geo secondary sites
Go modules can be pulled from secondary sites, with a number of limitations:
-
Git configuration (using
`insteadOf`
) is needed to fetch data from the Geo secondary site.
-
For private projects, authentication details need to be specified in
`~/.netrc`
.
Read more in the
[
working with projects `go get` documentation
](
../../../user/project/working_with_projects.md#fetch-go-modules-from-geo-secondary-sites
)
.
doc/user/project/working_with_projects.md
View file @
8d0da0ef
...
...
@@ -334,6 +334,52 @@ git config --global url."https://${user}:${personal_access_token}@gitlab.example
git config
--global
url.
"git@gitlab.example.com"
.insteadOf
"https://gitlab.example.com"
```
### Fetch Go modules from Geo secondary sites
As Go modules are stored in Git repositories, you can use the
[
Geo
](
../../administration/geo/index.md
)
feature that allows Git repositories to be accessed on the secondary Geo servers.
In the following examples, the primary's site domain name is
`gitlab.example.com`
,
and the secondary's is
`gitlab-secondary.example.com`
.
`go get`
will initially generate some HTTP traffic to the primary, but when the module
download commences, the
`insteadOf`
configuration sends the traffic to the secondary.
#### Use SSH to access the Geo secondary
To fetch Go modules from the secondary using SSH:
1.
Reconfigure Git on the client to send traffic for the primary to the secondary:
```
plaintext
git config --global url."git@gitlab-secondary.example.com".insteadOf "https://gitlab.example.com"
git config --global url."git@gitlab-secondary.example.com".insteadOf "http://gitlab.example.com"
```
1.
Ensure the client is set up for SSH access to GitLab repositories. This can be tested on the primary,
and GitLab will replicate the public key to the secondary.
#### Use HTTP to access the Geo secondary
Using HTTP to fetch Go modules does not work with CI/CD job tokens, only with
persistent access tokens that are replicated to the secondary.
To fetch Go modules from the secondary using HTTP:
1.
Put in place a Git
`insteadOf`
redirect on the client:
```
plaintext
git config --global url."https://gitlab-secondary.example.com".insteadOf "https://gitlab.example.com"
```
1.
Generate a
[
personal access token
](
../profile/personal_access_tokens.md
)
and
provide those credentials in the client's
`~/.netrc`
file:
```
plaintext
machine gitlab.example.com login USERNAME password TOKEN
machine gitlab-secondary.example.com login USERNAME password TOKEN
```
## Access project page with project ID
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/53671) in GitLab 11.8.
...
...
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