Go 패키지로 프로젝트 사용하기

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

Prerequisites:

  • GitLab Go Proxy를 활성화하도록 관리자에게 문의하세요.
  • 서브그룹 안에 있는 개인 프로젝트를 Go 패키지로 사용하려면 Go 요청에 인증해야 합니다. 인증되지 않은 Go 요청은 go get이 실패하게 됩니다. 서브그룹에 속해 있지 않은 프로젝트의 경우 Go 요청을 인증할 필요가 없습니다.

프로젝트를 Go 패키지로 사용하려면 go get 및 godoc.org 검색 요청을 사용합니다. 다음과 같은 메타 태그를 사용할 수 있습니다:

개인 프로젝트에 대한 Go 요청 인증하기

Prerequisites:

  • GitLab 인스턴스가 HTTPS로 접근 가능해야 합니다.
  • read_api 스코프가 포함된 개인 액세스 토큰이 있어야 합니다.

Go 요청을 인증하려면 다음 정보를 포함하여 .netrc 파일을 생성하세요: 

machine gitlab.example.com
login <gitlab_user_name>
password <personal_access_token>

Windows에서는 Go가 ~/.netrc 대신 ~/_netrc를 읽습니다.

go 명령은 자격 증명을 안전하지 않은 연결로 전달하지 않습니다. Go가 만든 HTTPS 요청은 인증되지만 Git을 통해 생성된 요청은 인증되지 않습니다.

개인 프로젝트에 대한 Git 요청 인증하기

Go가 프록시에서 모듈을 가져올 수 없는 경우 Git을 사용합니다. Git은 요청을 인증하기 위해 .netrc 파일을 사용하지만 다른 인증 방법을 구성할 수도 있습니다.

Git을 다음 중 하나로 구성하세요:

  • 요청 URL에 자격 증명 포함: 

    git config --global url."https://${user}:${personal_access_token}@gitlab.example.com".insteadOf "https://gitlab.example.com"

  • HTTPS 대신 SSH 사용: 

    git config --global url."git@gitlab.example.com:".insteadOf "https://gitlab.example.com/"

개인 프로젝트의 Go 모듈 가져오기 비활성화하기

모듈 또는 패키지 가져오기를 위해 Go는 다음 환경 변수를 사용합니다:

  • GOPRIVATE
  • GONOPROXY
  • GONOSUMDB

가져오기를 비활성화하려면:

  1. GOPRIVATE 비활성화:
    • 특정 프로젝트에 대한 쿼리를 비활성화하려면 GOPRIVATE=gitlab.example.com/my/private/project를 비활성화하세요.
    • GitLab.com의 모든 프로젝트에 대한 쿼리를 비활성화하려면 GOPRIVATE=gitlab.example.com를 비활성화하세요.
  2. GONOPROXY에서 프록시 쿼리 비활성화하기.
  3. GONOSUMDB에서 체크섬 쿼리 비활성화하기.
  • 모듈 이름 또는 해당 접두사가 GOPRIVATE 또는 GONOPROXY에 포함되어 있으면 Go는 모듈 프록시에 쿼리하지 않습니다.
  • 모듈 이름 또는 해당 접두사가 GONOPRIVATE 또는 GONOSUMDB에 포함되어 있으면 Go는 체크섬 데이터베이스를 쿼리하지 않습니다.

개인 서브그룹에 대한 Git 요청 인증하기

Go 모듈이 gitlab.com/namespace/subgroup/go-module과 같은 개인 서브그룹에 있는 경우 Git 인증이 작동하지 않습니다. 이는 go get이 인증되지 않은 요청을 만들어 리포지터리 경로를 확인할 때 발생합니다. HTTP 인증이 아닌 .netrc 파일을 통한 요청이 없으므로 GitLab은 인증되지 않은 사용자에게 프로젝트의 존재를 노출시키지 않도록 gitlab.com/namespace/subgroup.git로 응답합니다. 결과적으로, Go 모듈을 다운로드할 수 없습니다.

안타깝게도, .netrc 이외의 다른 요청 인증 수단을 제공하지 않습니다. Go는 장래 버전에서 임의의 인증 헤더를 지원할 수 있습니다. 자세한 내용은 golang/go#26232를 참조하세요.

해결 방법: 모듈 이름에 .git 사용하기

go get 요청을 건너뛰고 Git을 직접 사용하도록 강제하는 방법이 있지만, 모듈 이름을 수정해야 합니다.

모듈 경로에 VCS 한정자(하나의 .bzr, .fossil, .git, .hg, .svn)가 있으면 go 명령은 해당 경로 한정자까지를 리포지터리 URL로 사용합니다. 예를 들어, 모듈 example.com/foo.git/bar의 경우 go 명령은 example.com/foo.git의 리포지터리를 git을 사용하여 다운로드하고, bar 하위 디렉터리에서 모듈을 찾는 것으로 예상합니다.

Go 문서에서 가져옴

  1. 개인 서브그룹에 있는 Go 모듈의 go.mod로 이동하세요.
  2. 모듈 이름에 .git을 추가하세요. 예: module gitlab.com/namespace/subgroup/go-module을 module gitlab.com/namespace/subgroup/go-module.git으로 변경합니다.
  3. 이 변경사항을 커밋하고 푸시하세요.
  4. 이 모듈에 의존하는 Go 프로젝트에 방문하여 그들의 import 호출을 조정하세요. 예: import gitlab.com/namespace/subgroup/go-module.git.

이 변경 후 Go 모듈이 올바르게 가져와집니다. 예: GOPRIVATE=gitlab.com/namespace/* go mod tidy.

Geo 보조 사이트에서 Go 모듈 가져오기

Geo를 사용하여 보조 Geo 서버에서 Go 모듈을 포함하는 Git 리포지터리에 액세스하세요.

SSH 또는 HTTP를 사용하여 Geo 보조 서버에 액세스할 수 있습니다.

SSH를 사용하여 Geo 보조 서버에 액세스하기

SSH를 사용하여 Geo 보조 서버에 액세스하려면:

  1. 클라이언트의 Git을 구성하여 주 서버의 트래픽을 보조 서버로 보내도록 다시 구성합니다: 

    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"
    • gitlab.example.com에는 주 서버 도메인 이름을 사용합니다.
    • gitlab-secondary.example.com에는 보조 서버 도메인 이름을 사용합니다.

  2. 클라이언트가 GitLab 리포지터리에 대한 SSH 액세스를 설정했는지 확인하세요. 이는 주 서버에서 테스트할 수 있으며, GitLab이 공개 키를 보조 서버로 복제합니다.

go get 요청은 주 Geo 서버로 HTTP 트래픽을 생성합니다. 모듈 다운로드가 시작되면 insteadOf 구성은 보조 Geo 서버로 트래픽을 보냅니다.

Geo 보조 서버에 HTTP를 사용하여 액세스

Geo 보조 서버에 액세스하려면 보조 서버로 복제되는 지속적 액세스 토큰을 사용해야 합니다. CI/CD 작업 토큰으로는 HTTP를 통해 Go 모듈을 가져올 수 없습니다.

Geo 보조 서버에 HTTP를 통해 액세스하려면 다음을 수행합니다:

  1. 클라이언트에 Git insteadOf 리디렉션을 추가합니다: 

    git config --global url."https://gitlab-secondary.example.com".insteadOf "https://gitlab.example.com"
    • gitlab.example.com에는 기본 사이트 도메인 이름을 사용합니다.
    • gitlab-secondary.example.com에는 보조 사이트 도메인 이름을 사용합니다.

  2. 개인 액세스 토큰을 생성하고 클라이언트의 ~/.netrc 파일에 자격 증명을 추가합니다: 

    machine gitlab.example.com login USERNAME password TOKEN
machine gitlab-secondary.example.com login USERNAME password TOKEN

go get 요청은 기본 Geo 서버로 HTTP 트래픽을 생성합니다. 모듈 다운로드가 시작되면 insteadOf 구성이 보조 Geo 서버로 트래픽을 보냅니다.