Maven API

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

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

경고: 이 API는 Maven 패키지 관리자 클라이언트에서 사용되며 일반적으로 수동으로 사용할 목적으로 제공되지 않습니다.

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

참고: 이러한 엔드포인트는 표준 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 문자열 예 Maven 패키지 경로, <groupId>/<artifactId>/<version> 형식으로 작성하세요. groupId에 포함된 .은 /으로 바꿉니다.
file_name 문자열 예 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"