gitlab-org--gitlab-foss/doc/administration/geo/replication/usage.md

2 KiB

stage group info type
Enablement Geo To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments howto

Using a Geo Site (PREMIUM SELF)

After you set up the database replication and configure the Geo nodes, use your closest GitLab site as you would do with the primary one.

You can push directly to a secondary site (for both HTTP, SSH including Git LFS), and the request will be proxied to the primary site instead (introduced in GitLab 11.3).

Example of the output you will see when pushing to a secondary site:

$ git push
remote:
remote: This request to a Geo secondary node will be forwarded to the
remote: Geo primary node:
remote:
remote:   ssh://git@primary.geo/user/repo.git
remote:
Everything up-to-date

NOTE: If you're using HTTPS instead of SSH to push to the secondary, you can't store credentials in the URL like user:password@URL. Instead, you can use a .netrc file 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.

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.