Maven API

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

이 문서는 Maven Packages에 대한 API 문서입니다.

caution
이 API는 Maven 패키지 관리자 클라이언트에서 사용되며 일반적으로 수동으로 사용하기 위한 것이 아닙니다.

GitLab 패키지 레지스트리에서 Maven 패키지를 업로드하고 설치하는 방법에 대한 지침은 Maven 패키지 레지스트리 문서를 참조하세요.

note
이 엔드포인트는 표준 API 인증 방법을 준수하지 않습니다.
어떤 헤더와 토큰 유형이 지원되는지에 대한 자세한 내용은 Maven 패키지 레지스트리 문서를 참조하세요. 문서화되지 않은 인증 방법은 나중에 제거될 수 있습니다.

인스턴스 수준에서 패키지 파일 다운로드

Maven 패키지 파일을 다운로드합니다:

GET packages/maven/*path/:file_name
속성 유형 필수 설명
path 문자열 예 Maven 패키지 경로, 형식은 <groupId>/<artifactId>/<version>입니다. groupId의 모든 .를 /로 교체하세요.
file_name 문자열 예 Maven 패키지 파일의 이름입니다. 
curl --header "Private-Token: <personal_access_token>" "https://gitlab.example.com/api/v4/packages/maven/foo/bar/mypkg/1.0-SNAPSHOT/mypkg-1.0-SNAPSHOT.jar"

출력을 파일로 저장하려면:

curl --header "Private-Token: <personal_access_token>" "https://gitlab.example.com/api/v4/packages/maven/foo/bar/mypkg/1.0-SNAPSHOT/mypkg-1.0-SNAPSHOT.jar" >> mypkg-1.0-SNAPSHOT.jar

이렇게 하면 다운로드된 파일이 현재 디렉터리의 mypkg-1.0-SNAPSHOT.jar에 저장됩니다.

그룹 수준에서 패키지 파일 다운로드

Maven 패키지 파일을 다운로드합니다:

GET groups/:id/-/packages/maven/*path/:file_name
속성 유형 필수 설명
path 문자열 예 Maven 패키지 경로, 형식은 <groupId>/<artifactId>/<version>입니다. groupId의 모든 .를 /로 교체하세요.
file_name 문자열 예 Maven 패키지 파일의 이름입니다. 
curl --header "Private-Token: <personal_access_token>" "https://gitlab.example.com/api/v4/groups/1/-/packages/maven/foo/bar/mypkg/1.0-SNAPSHOT/mypkg-1.0-SNAPSHOT.jar"

출력을 파일로 저장하려면:

curl --header "Private-Token: <personal_access_token>" "https://gitlab.example.com/api/v4/groups/1/-/packages/maven/foo/bar/mypkg/1.0-SNAPSHOT/mypkg-1.0-SNAPSHOT.jar" >> mypkg-1.0-SNAPSHOT.jar

이렇게 하면 다운로드된 파일이 현재 디렉터리의 mypkg-1.0-SNAPSHOT.jar에 저장됩니다.

프로젝트 수준에서 패키지 파일 다운로드

Maven 패키지 파일을 다운로드합니다:

GET projects/:id/packages/maven/*path/:file_name
속성 유형 필수 설명
path 문자열 예 Maven 패키지 경로, 형식은 <groupId>/<artifactId>/<version>입니다. groupId의 모든 .을 /로 교체하세요.
file_name 문자열 예 Maven 패키지 파일의 이름입니다. 
curl --header "Private-Token: <personal_access_token>" "https://gitlab.example.com/api/v4/projects/1/packages/maven/foo/bar/mypkg/1.0-SNAPSHOT/mypkg-1.0-SNAPSHOT.jar"

출력을 파일로 저장하려면:

curl --header "Private-Token: <personal_access_token>" "https://gitlab.example.com/api/v4/projects/1/packages/maven/foo/bar/mypkg/1.0-SNAPSHOT/mypkg-1.0-SNAPSHOT.jar" >> mypkg-1.0-SNAPSHOT.jar

이렇게 하면 다운로드된 파일이 현재 디렉터리의 mypkg-1.0-SNAPSHOT.jar에 저장됩니다.

패키지 파일 업로드

Maven 패키지 파일 업로드:

PUT projects/:id/packages/maven/*path/:file_name
속성 유형 필수 설명
path string yes Maven 패키지 경로로, 형식은 <groupId>/<artifactId>/<version>입니다. groupId의 .을 /로 대체하세요.
file_name string yes Maven 패키지 파일의 이름입니다. 
curl --request PUT \
     --upload-file path/to/mypkg-1.0-SNAPSHOT.pom \
     --header "Private-Token: <personal_access_token>" \
     "https://gitlab.example.com/api/v4/projects/1/packages/maven/foo/bar/mypkg/1.0-SNAPSHOT/mypkg-1.0-SNAPSHOT.pom"