패키지용 의존성 프록시

:::EndTabs

권한

의존성 프록시가 파일을 가져올 때 다음이 발생합니다:

1. 의존성 프록시는 프로젝트의 패키지 레지스트리에서 파일을 검색합니다. 이는 읽기 작업입니다.
2. 의존성 프록시는 패키지 파일을 프로젝트의 패키지 레지스트리에 게시할 수도 있습니다. 이는 쓰기 작업입니다.

두 단계 모두를 실행할지는 사용자 권한에 따라 다릅니다. 의존성 프록시는 패키지 레지스트리와 동일한 권한을 사용합니다.

최소한 의존성 프록시를 사용할 수 있는 사용자는 프로젝트의 패키지 레지스트리를 사용할 수 있어야 합니다.

시간이 지남에 따라 캐시가 올바르게 채워지도록하려면, 최소한 개발자 역할을 가진 사용자가 의존성 프록시를 통해 패키지를 가져오도록해야 합니다.

클라이언트 구성

의존성 프록시용 클라이언트를 구성하는 것은패키지 레지스트리용 클라이언트를 구성하는 것과 유사합니다.

Maven 패키지의 경우

Maven 패키지의 경우, 의존성 프록시는 패키지 레지스트리에서 지원하는 모든 클라이언트를 지원합니다:

• mvn
• gradle
• sbt

인증에는 Maven 패키지 레지스트리에서 허용되는 모든 방법을 사용할 수 있습니다. 더욱 복잡하지 않은 Basic HTTP 인증 방법을 사용해야 합니다.

클라이언트를 구성하려면:

1. Basic HTTP 인증의 지침에 따릅니다.

   엔드포인트 URL로 https://gitlab.example.com/api/v4/projects/<project_id>/dependency_proxy/packages/maven을 사용하도록 하세요.

2. 클라이언트 구성을 완료하세요:

::Tabs

Basic HTTP 인증이 허용됩니다. 그러나 mvn이 더 적은 네트워크 요청을 사용하도록 custom HTTP header 인증을 사용해야 합니다.

pom.xml 파일에 repository 요소를 추가하세요:

<repositories>
  <repository>
    <id>gitlab-maven</id>
    <url>https://gitlab.example.com/api/v4/projects/<project_id>/dependency_proxy/packages/maven</url>
  </repository>
</repositories>

여기서:

• <project_id>는 의존성 프록시로 사용할 프로젝트의 ID입니다.
• <id>에는인증 구성에서 사용된 <server>의 이름이 포함됩니다.

기본적으로 Maven Central은Super POM을 통해 먼저 확인됩니다. 그러나 mvn이 GitLab 엔드포인트를 먼저 확인하도록 하려면 request forward에서 지침을 따르세요.

build.gradle 파일에 repositories 섹션을 추가하세요.

• Groovy DSL에서:

  repositories {
      maven {
          url "https://gitlab.example.com/api/v4/projects/<project_id>/dependency_proxy/packages/maven"
          name "GitLab"
          credentials(PasswordCredentials) {
              username = 'REPLACE_WITH_NAME'
              password = gitLabPrivateToken
          }
          authentication {
              basic(BasicAuthentication)
          }
      }
  }
  

• Kotlin DSL에서:

  repositories {
      maven {
          url = uri("https://gitlab.example.com/api/v4/projects/<project_id>/dependency_proxy/packages/maven")
          name = "GitLab"
          credentials(BasicAuthentication::class) {
              username = "REPLACE_WITH_NAME"
              password = findProperty("gitLabPrivateToken") as String?
          }
          authentication {
              create("basic", BasicAuthentication::class)
          }
      }
  }
  

이 예에서:

• <project_id>는 의존성 프록시로 사용할 프로젝트의 ID입니다.
• REPLACE_WITH_NAME은Basic HTTP 인증 섹션에서 설명된 바와 같습니다.

build.sbt에 다음 줄을 추가하세요:

resolvers += ("gitlab" at "https://gitlab.example.com/api/v4/projects/<project_id>/dependency_proxy/packages/maven")

credentials += Credentials("GitLab Packages Registry", "<host>", "<name>", "<token>")

이 예에서:

• <project_id>는 의존성 프록시로 사용할 프로젝트의 ID입니다.
• <host>는 <endpoint url>에서 프로토콜 스키마나 포트 없이 포함된 호스트입니다. 예: gitlab.example.com.
• <name> 및 <token>은Basic HTTP 인증 섹션에서 설명된 바와 같습니다.

어떤 Maven 패키지 레지스트리든 의존성 프록시에 연결할 수 있습니다. Maven 패키지 레지스트리 연결을 Maven 패키지 레지스트리 사용자 이름과 암호로 승인할 수 있습니다.

원격 Maven 패키지 레지스트리를 설정하거나 업데이트하려면 양식의 다음 필드를 업데이트하십시오.

• URL - 원격 레지스트리의 URL.
• Username - 선택 사항. 원격 레지스트리 사용에 필요한 사용자 이름.
• Password - 선택 사항. 원격 레지스트리 사용에 필요한 암호.

사용자 이름과 암호를 모두 설정하거나 두 필드를 모두 비워 두어야 합니다.

curl --verbose "https://<username>:<personal access token>@gitlab.example.com/api/v4/projects/<project_id>/dependency_proxy/packages/maven/<group id and artifact id>/<version>/<file_name>"

• <username>와 <personal access token>은 GitLab 인스턴스의 의존성 프록시에 액세스하는 데 사용되는 자격 증명입니다.
• <project_id>는 프로젝트 ID입니다.
• <group id and artifact id>는 Maven 패키지 그룹 ID 및 아티팩트 ID를 슬래시로 연결한 것입니다.
• <version>은 패키지 버전입니다.
• file_name은 파일의 정확한 이름입니다.

예를 들어 다음과 같은 패키지가 있다고 가정합니다:

• 그룹 ID: com.my_company.
• 아티팩트 ID: my_package.
• 버전: 1.2.3.

패키지를 매뉴얼으로 끌어오기 위한 요청은 다음과 같습니다:

curl --verbose "https://<username>:<personal access token>@gitlab.example.com/api/v4/projects/<project_id>/dependency_proxy/packages/maven/com/my_company/my_package/1.2.3/my_package-1.2.3.pom"