Go Proxy API

Tier: Free, Premium, Ultimate Offering: 자체 관리, GitLab Dedicated

이것은 Go Packages에 대한 API 문서입니다. 이 API는 기본적으로 비활성화된 기능 플래그 뒤에 있습니다. GitLab 관리자로서 GitLab Rails 콘솔에 액세스할 수 있다면 본인의 GitLab 인스턴스에 대해 이 API를 활성화할 수 있습니다.

경고: 이 API는 Go 클라이언트에서 사용되며 일반적으로 수동으로 사용되지 않습니다.

Go Proxy 작업 방법에 대한 지침은 Go Proxy package documentation을 참조하십시오.

참고: 이 엔드포인트들은 표준 API 인증 방법을 준수하지 않습니다. 지원되는 헤더 및 토큰 유형에 대한 자세한 내용은 Go Proxy package documentation을 참조하십시오. 문서화되지 않은 인증 방법은 향후 제거될 수 있습니다.

목록

  • GitLab 13.1에서 도입됨.

주어진 Go 모듈의 모든 태그된 버전을 가져옵니다:

GET projects/:id/packages/go/:module_name/@v/list
속성 유형 필수 설명
id string 프로젝트 ID 또는 프로젝트의 전체 경로.
module_name string Go 모듈의 이름.
curl --header "Private-Token: <personal_access_token>" "https://gitlab.example.com/api/v4/projects/1/packages/go/my-go-module/@v/list"

예시 출력:

"v1.0.0\nv1.0.1\nv1.3.8\n2.0.0\n2.1.0\n3.0.0"

버전 메타데이터

  • GitLab 13.1에서 도입됨.

주어진 Go 모듈의 모든 태그된 버전을 가져옵니다:

GET projects/:id/packages/go/:module_name/@v/:module_version.info
속성 유형 필수 설명
id string 프로젝트 ID 또는 프로젝트의 전체 경로.
module_name string Go 모듈의 이름.
module_version string Go 모듈의 버전.
curl --header "Private-Token: <personal_access_token>" "https://gitlab.example.com/api/v4/projects/1/packages/go/my-go-module/@v/1.0.0.info"

예시 출력:

{
  "Version": "v1.0.0",
  "Time": "1617822312 -0600"
}

모듈 파일 다운로드

  • GitLab 13.1에서 도입됨.

.mod 모듈 파일을 가져옵니다:

GET projects/:id/packages/go/:module_name/@v/:module_version.mod
속성 유형 필수 설명
id string 프로젝트 ID 또는 프로젝트의 전체 경로.
module_name string Go 모듈의 이름.
module_version string Go 모듈의 버전.
curl --header "Private-Token: <personal_access_token>" "https://gitlab.example.com/api/v4/projects/1/packages/go/my-go-module/@v/1.0.0.mod"

파일로 작성:

curl --header "Private-Token: <personal_access_token>" "https://gitlab.example.com/api/v4/projects/1/packages/go/my-go-module/@v/1.0.0.mod" >> foo.mod

이 명령은 현재 디렉토리에 foo.mod라는 파일에 작성합니다.

모듈 소스 다운로드

  • GitLab 13.1에서 도입됨.

모듈 소스의 .zip를 가져옵니다:

GET projects/:id/packages/go/:module_name/@v/:module_version.zip
속성 유형 필수 설명
id string 프로젝트 ID 또는 프로젝트의 전체 경로.
module_name string Go 모듈의 이름.
module_version string Go 모듈의 버전.
curl --header "Private-Token: <personal_access_token>" "https://gitlab.example.com/api/v4/projects/1/packages/go/my-go-module/@v/1.0.0.zip"

파일로 작성:

curl --header "Private-Token: <personal_access_token>" "https://gitlab.example.com/api/v4/projects/1/packages/go/my-go-module/@v/1.0.0.zip" >> foo.zip

이 명령은 현재 디렉토리에 foo.zip라는 파일에 작성합니다.