Debian API 활성화
Debian 그룹 API 활성화
- Debian 패키지 저장소에 인증
패키지 파일 업로드
패키지 다운로드
라우트 접두어
- 프로젝트 수준
- 그룹 수준
배포 파일 다운로드
서명된 배포 파일 다운로드
릴리즈 파일 서명 다운로드
패키지 인덱스 다운로드
해시로 패키지 인덱스 다운로드
Debian 설치 프로그램 패키지 인덱스 다운로드
해시로 Debian 설치 프로그램 패키지 인덱스 다운로드
소스 패키지 인덱스 다운로드
해시로 색인된 소스 패키지 다운로드

Debian API

상세 정보: Tier: Free, Premium, Ultimate Offering: Self-managed, GitLab Dedicated

GitLab 13.5에서 Debian API가 소개되었습니다.
GitLab 14.2에서 Debian 그룹 API가 소개되었습니다.
기본적으로 비활성화된 기능 플래그 뒤에 배포되었습니다.

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

경고: 이 API는 dput 및 apt-get과 같은 Debian 관련 패키지 클라이언트에 의해 사용되며, 일반적으로 수동 사용을 위한 것이 아닙니다. 이 API는 개발 중이며 제한된 기능 때문에 프로덕션 환경에 사용하기에 준비되지 않았습니다.

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

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

Debian API 활성화

Debian API는 기본적으로 비활성화된 기능 플래그 뒤에 있습니다. GitLab 레일즈 콘솔에 액세스 권한이 있는 GitLab 관리자는 이를 활성화할 수 있습니다. 활성화하려면 Debian API 활성화 지침을 따르세요.

Debian 그룹 API 활성화

Debian 그룹 API는 기본적으로 비활성화된 기능 플래그 뒤에 있습니다. GitLab 레일즈 콘솔에 액세스 권한이 있는 GitLab 관리자는 이를 활성화할 수 있습니다. 활성화하려면 Debian 그룹 API 활성화 지침을 따르세요.

Debian 패키지 저장소에 인증

Debian 패키지 저장소에 인증을 참조하세요.

패키지 파일 업로드

GitLab 14.0에서 소개되었습니다.
명시적인 배포 및 구성 요소와 함께 업로드하는 기능은 GitLab 15.9에서 소개되었습니다.

Debian 패키지 파일을 업로드합니다:

PUT projects/:id/packages/debian/:file_name

속성	유형	필수	설명
`id`	string	예	프로젝트의 ID 또는 전체 경로.
`file_name`	string	예	Debian 패키지 파일의 이름.
`distribution`	string	아니요	배포 코드명 또는 스위트. 명시적인 배포 및 구성 요소와 함께 사용됩니다.
`component`	string	아니요	패키지 파일 구성 요소. 명시적인 배포 및 구성 요소와 함께 사용됩니다.

curl --request PUT \
     --user "<username>:<personal_access_token>" \
     --upload-file path/to/mypkg.deb \
     "https://gitlab.example.com/api/v4/projects/1/packages/debian/mypkg.deb"

명시적인 배포 및 구성 요소와 함께 업로드:

curl --request PUT \
  --user "<username>:<personal_access_token>" \
  --upload-file  /path/to/myother.deb \
  "https://gitlab.example.com/api/v4/projects/1/packages/debian/myother.deb?distribution=sid&component=main"

패키지 다운로드

GitLab 14.2에서 소개되었습니다.

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

GET projects/:id/packages/debian/pool/:distribution/:letter/:package_name/:package_version/:file_name

속성	유형	필수	설명
`distribution`	string	예	Debian 배포의 코드명이나 스위트.
`letter`	string	예	Debian 분류 (첫 글자 또는 lib-first-letter).
`package_name`	string	예	소스 패키지 이름.
`package_version`	string	예	소스 패키지 버전.
`file_name`	string	예	파일 이름.

curl --header "Private-Token: <personal_access_token>" "https://gitlab.example.com/api/v4/projects/1/packages/debian/pool/my-distro/a/my-pkg/1.0.0/example_1.0.0~alpha2_amd64.deb"

파일을 다운로드하여 출력을 파일에 작성합니다:

curl --header "Private-Token: <personal_access_token>" \
     "https://gitlab.example.com/api/v4/projects/1/packages/debian/pool/my-distro/a/my-pkg/1.0.0/example_1.0.0~alpha2_amd64.deb" \
     --remote-name

이 명령은 현재 디렉터리에 원격 파일 이름을 사용하여 다운로드된 파일을 작성합니다.

라우트 접두어

남은 엔드포인트는 각각 다른 범위에서 요청을 수행하는 두 개의 동일한 라우트 세트입니다.

단일 프로젝트 범위에서 요청을 수행하려면 프로젝트 수준 접두어를 사용합니다.
단일 그룹 범위에서 요청을 수행하려면 그룹 수준 접두어를 사용합니다.

이 문서의 예제는 모두 프로젝트 수준 접두어를 사용합니다.

프로젝트 수준

 /projects/:id/packages/debian`

속성	유형	필수	설명
`id`	string	yes	프로젝트 ID 또는 전체 프로젝트 경로.

그룹 수준

 /groups/:id/-/packages/debian`

속성	유형	필수	설명
`id`	string	yes	프로젝트 ID 또는 전체 그룹 경로.

배포 파일 다운로드

GitLab 14.1에서 도입되었습니다.

Debian 배포 파일을 다운로드합니다.

GET <라우트-접두어>/dists/*distribution/Release

속성	유형	필수	설명
`distribution`	string	yes	Debian 배포의 codename 또는 suite.

curl --header "Private-Token: <개인_액세스_토큰>" "https://gitlab.example.com/api/v4/projects/1/packages/debian/dists/my-distro/Release"

출력을 파일에 작성합니다.

curl --header "Private-Token: <개인_액세스_토큰>" \
     "https://gitlab.example.com/api/v4/projects/1/packages/debian/dists/my-distro/Release" \
     --remote-name

이렇게 하면 현재 디렉토리에 원격 파일 이름을 사용하여 다운로드한 파일이 작성됩니다.

서명된 배포 파일 다운로드

GitLab 14.1에서 도입되었습니다.

서명된 Debian 배포 파일을 다운로드합니다.

GET <라우트-접두어>/dists/*distribution/InRelease

속성	유형	필수	설명
`distribution`	string	yes	Debian 배포의 codename 또는 suite.

curl --header "Private-Token: <개인_액세스_토큰>" "https://gitlab.example.com/api/v4/projects/1/packages/debian/dists/my-distro/InRelease"

출력을 파일에 작성합니다.

curl --header "Private-Token: <개인_액세스_토큰>" \
     "https://gitlab.example.com/api/v4/projects/1/packages/debian/dists/my-distro/InRelease" \
     --remote-name

이렇게 하면 현재 디렉토리에 원격 파일 이름을 사용하여 다운로드한 파일이 작성됩니다.

릴리즈 파일 서명 다운로드

GitLab 14.2에서 도입되었습니다.

Debian 릴리즈 파일 서명을 다운로드합니다.

GET <라우트-접두어>/dists/*distribution/Release.gpg

속성	유형	필수	설명
`distribution`	string	yes	Debian 배포의 codename 또는 suite.

curl --header "Private-Token: <개인_액세스_토큰>" "https://gitlab.example.com/api/v4/projects/1/packages/debian/dists/my-distro/Release.gpg"

출력을 파일에 작성합니다.

curl --header "Private-Token: <개인_액세스_토큰>" \
     "https://gitlab.example.com/api/v4/projects/1/packages/debian/dists/my-distro/Release.gpg" \
     --remote-name

이렇게 하면 현재 디렉토리에 원격 파일 이름을 사용하여 다운로드한 파일이 작성됩니다.

패키지 인덱스 다운로드

GitLab 14.2에서 도입되었습니다.

패키지 인덱스를 다운로드합니다.

GET <라우트-접두어>/dists/*distribution/:component/binary-:architecture/Packages

속성	유형	필수	설명
`distribution`	string	yes	Debian 배포의 codename 또는 suite.
`component`	string	yes	배포 구성 요소 이름.
`architecture`	string	yes	배포 아키텍처 유형.

curl --header "Private-Token: <개인_액세스_토큰>" "https://gitlab.example.com/api/v4/projects/1/packages/debian/dists/my-distro/main/binary-amd64/Packages"

출력을 파일에 작성합니다.

curl --header "Private-Token: <개인_액세스_토큰>" \
     "https://gitlab.example.com/api/v4/projects/1/packages/debian/dists/my-distro/main/binary-amd64/Packages" \
     --remote-name

이렇게 하면 현재 디렉토리에 원격 파일 이름을 사용하여 다운로드한 파일이 작성됩니다.

해시로 패키지 인덱스 다운로드

소개: GitLab 15.4에서 소개되었습니다.

해시로 패키지 인덱스를 다운로드합니다.

GET <route-prefix>/dists/*distribution/:component/binary-:architecture/by-hash/SHA256/:file_sha256

속성	타입	필수여부	설명
`distribution`	string	yes	Debian 배포의 코드명 또는 스위트입니다.
`component`	string	yes	배포 구성 요소의 이름입니다.
`architecture`	string	yes	배포 아키텍처 유형입니다.

curl --header "Private-Token: <personal_access_token>" "https://gitlab.example.com/api/v4/projects/1/packages/debian/dists/my-distro/main/binary-amd64/by-hash/SHA256/66a045b452102c59d840ec097d59d9467e13a3f34f6494e539ffd32c1bb35f18"

파일에 출력 작성:

curl --header "Private-Token: <personal_access_token>" \
     "https://gitlab.example.com/api/v4/projects/1/packages/debian/dists/my-distro/main/binary-amd64/by-hash/SHA256/66a045b452102c59d840ec097d59d9467e13a3f34f6494e539ffd32c1bb35f18" \
     --remote-name

이 명령은 현재 디렉토리에 원격 파일 이름을 사용하여 다운로드한 파일을 작성합니다.

Debian 설치 프로그램 패키지 인덱스 다운로드

소개: GitLab 15.4에서 소개되었습니다.

Debian 설치 프로그램 패키지 인덱스를 다운로드합니다.

GET <route-prefix>/dists/*distribution/:component/debian-installer/binary-:architecture/Packages

속성	타입	필수여부	설명
`distribution`	string	yes	Debian 배포의 코드명 또는 스위트입니다.
`component`	string	yes	배포 구성 요소의 이름입니다.
`architecture`	string	yes	배포 아키텍처 유형입니다.

curl --header "Private-Token: <personal_access_token>" "https://gitlab.example.com/api/v4/projects/1/packages/debian/dists/my-distro/main/debian-installer/binary-amd64/Packages"

파일에 출력 작성:

curl --header "Private-Token: <personal_access_token>" \
     "https://gitlab.example.com/api/v4/projects/1/packages/debian/dists/my-distro/main/debian-installer/binary-amd64/Packages" \
     --remote-name

이 명령은 현재 디렉토리에 원격 파일 이름을 사용하여 다운로드한 파일을 작성합니다.

해시로 Debian 설치 프로그램 패키지 인덱스 다운로드

소개: GitLab 15.4에서 소개되었습니다.

해시로 Debian 설치 프로그램 패키지 인덱스를 다운로드합니다.

GET <route-prefix>/dists/*distribution/:component/debian-installer/binary-:architecture/by-hash/SHA256/:file_sha256

속성	타입	필수여부	설명
`distribution`	string	yes	Debian 배포의 코드명 또는 스위트입니다.
`component`	string	yes	배포 구성 요소의 이름입니다.
`architecture`	string	yes	배포 아키텍처 유형입니다.

curl --header "Private-Token: <personal_access_token>" "https://gitlab.example.com/api/v4/projects/1/packages/debian/dists/my-distro/main/debian-installer/binary-amd64/by-hash/SHA256/66a045b452102c59d840ec097d59d9467e13a3f34f6494e539ffd32c1bb35f18"

파일에 출력 작성:

curl --header "Private-Token: <personal_access_token>" \
     "https://gitlab.example.com/api/v4/projects/1/packages/debian/dists/my-distro/main/debian-installer/binary-amd64/by-hash/SHA256/66a045b452102c59d840ec097d59d9467e13a3f34f6494e539ffd32c1bb35f18" \
     --remote-name

이 명령은 현재 디렉토리에 원격 파일 이름을 사용하여 다운로드한 파일을 작성합니다.

소스 패키지 인덱스 다운로드

소개: GitLab 15.4에서 소개되었습니다.

소스 패키지 인덱스를 다운로드합니다.

GET <route-prefix>/dists/*distribution/:component/source/Sources

속성	타입	필수여부	설명
`distribution`	string	yes	Debian 배포의 코드명 또는 스위트입니다.
`component`	string	yes	배포 구성 요소의 이름입니다.

curl --header "Private-Token: <personal_access_token>" "https://gitlab.example.com/api/v4/projects/1/packages/debian/dists/my-distro/main/source/Sources"

파일에 출력 작성:

curl --header "Private-Token: <personal_access_token>" \
     "https://gitlab.example.com/api/v4/projects/1/packages/debian/dists/my-distro/main/source/Sources" \
     --remote-name

이 명령은 현재 디렉토리에 원격 파일 이름을 사용하여 다운로드한 파일을 작성합니다.

해시로 색인된 소스 패키지 다운로드

GitLab 15.4에서 도입되었습니다.

해시로 색인된 소스 패키지를 다운로드합니다.

GET <route-prefix>/dists/*distribution/:component/source/by-hash/SHA256/:file_sha256

속성	유형	필요	설명
`distribution`	문자열	예	Debian 배포의 코드명 또는 스위트입니다.
`component`	문자열	예	배포 구성 요소 이름입니다.

curl --header "Private-Token: <personal_access_token>" "https://gitlab.example.com/api/v4/projects/1/packages/debian/dists/my-distro/main/source/by-hash/SHA256/66a045b452102c59d840ec097d59d9467e13a3f34f6494e539ffd32c1bb35f18"

파일로 출력을 작성합니다:

curl --header "Private-Token: <personal_access_token>" \
     "https://gitlab.example.com/api/v4/projects/1/packages/debian/dists/my-distro/main/source/by-hash/SHA256/66a045b452102c59d840ec097d59d9467e13a3f34f6494e539ffd32c1bb35f18" \
     --remote-name

이렇게 하면 현재 디렉토리에 원격 파일 이름을 사용하여 다운로드한 파일이 작성됩니다.

Debian API

Debian API 활성화

Debian 그룹 API 활성화

Debian 패키지 저장소에 인증

패키지 파일 업로드

패키지 다운로드

라우트 접두어

프로젝트 수준

그룹 수준

배포 파일 다운로드

서명된 배포 파일 다운로드

릴리즈 파일 서명 다운로드

패키지 인덱스 다운로드

해시로 패키지 인덱스 다운로드

Debian 설치 프로그램 패키지 인덱스 다운로드

해시로 Debian 설치 프로그램 패키지 인덱스 다운로드

소스 패키지 인덱스 다운로드

해시로 색인된 소스 패키지 다운로드

도움말

기능 사용 가능성과 제품 평가판

도움받기