패키지용 의존성 프록시

| 패키지 레지스트리 | 고급 캐싱 지원 여부 | |————————————————————————————————————————————–|———————–| | GitLab | Yes| | Maven Central | Yes| | Artifactory | Yes| | Sonatype Nexus | Yes| | GitHub Packages| No| :::EndTabs

권한

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

1. 의존성 프록시는 프로젝트 패키지 레지스트리에서 파일을 찾습니다. 이것은 읽기 작업입니다.
2. 의존성 프록시는 패키지 파일을 프로젝트 패키지 레지스트리에 발행할 수 있습니다. 이것은 쓰기 작업입니다.

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

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

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

클라이언트 구성

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

Maven 패키지의 경우

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

• mvn
• gradle
• sbt

인증에 대해서는 Maven 패키지 레지스트리에서 허용되는 모든 메서드를 사용할 수 있습니다. 덜 복잡하므로 기본 HTTP 인증 방법을 사용해야 합니다.

클라이언트를 구성하려면 다음 단계를 따르십시오.

1. 기본 HTTP 인증 안내에 따라 지침을 따르세요.

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

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

::Tabs

기본 HTTP 인증이 허용됩니다. 그러나 mvn이 더 적은 네트워크 요청을 사용하도록 사용자 정의 HTTP 헤더 인증을 사용해야 합니다.

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은 슈퍼 POM을 통해 먼저 확인됩니다. 그러나 mvn이 GitLab 엔드포인트를 먼저 확인하도록 하려면 요청 전달 지침을 따르세요.

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은 기본 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>은 기본 HTTP 인증 섹션에서 설명되어 있습니다.

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

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

• URL - 원격 레지스트리의 URL
• 사용자 이름 - 선택 사항. 원격 레지스트리와 함께 사용할 사용자 이름
• 비밀번호 - 선택 사항. 원격 레지스트리와 함께 사용할 비밀번호

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

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"