Maven 패키지 관리

이 페이지에서는 자바 패키지 및 패키지 버전의 추가, 보기, 삭제에 대해 설명합니다.

패키지 관리는 알파 버전입니다. 이 기능은 알파 사용자에게만 제공되며 컨테이너 관리에 사용할 수 있는 모든 기능이 포함되지 않을 수 있습니다. 알파 버전을 신청하려면 가입 양식을 작성하세요.

시작하기 전에

  1. 대상 저장소가 없으면 새 저장소를 만듭니다.
  2. 저장소에 필요한 권한이 있는지 확인합니다.
  3. 인증을 구성했는지 확인합니다. 액세스 토큰을 사용하는 경우 저장소에 연결하기 전에 토큰을 새로고침해야 합니다.
  4. (선택사항) gcloud 명령어의 기본값을 구성합니다.

패키지 추가

저장소에 패키지를 추가하려면 다음 안내를 따르세요.

Maven

mvn deploymvn release를 사용하여 저장소에 패키지를 추가합니다.

상위 요소를 참조하는 Maven 프로젝트를 성공적으로 배포하려면 인증 안내에 설명된 대로 프로젝트의 핵심 확장 프로그램 파일에 Artifact Registry Wagon 공급자가 포함되어 있어야 합니다.

Maven 외부에서 빌드된 아티팩트를 업로드하려면 mvn deploy:deploy-file를 사용합니다.

예를 들어 이 예시 명령어는 example/external.jar와 프로젝트 파일 example/pom.xmlus-central1-maven.pkg.dev/my-project/my-repo 저장소에 배포합니다.

mvn deploy:deploy-file \
-Durl=artifactregistry://us-central1-maven.pkg.dev/my-project/my-repo \
-DpomFile=example/pom.xml -Dfile=example/external.jar

Cloud Build와의 통합을 구성하려면 Cloud Build와 통합을 참조하세요.

Gradle

저장소에 성공적으로 게시하려면 build.gradle 파일에 업로드할 파일을 정의하는 게시물 섹션이 있어야 합니다.

gradle publish 명령어를 사용하여 저장소에 패키지를 업로드합니다.

패키지 및 버전 보기

Google Cloud Console 또는 gcloud을 사용하여 패키지 및 패키지 버전을 보려면 다음 안내를 따르세요.

Console

  1. Google Cloud Console에서 저장소 페이지를 엽니다.

    저장소 페이지 열기

  2. 저장소 목록에서 적절한 저장소를 클릭합니다.

    패키지 페이지에 저장소의 패키지가 나열됩니다.

  3. 패키지를 클릭하여 패키지 버전을 확인합니다.

gcloud

저장소에 있는 패키지를 나열하려면 다음 명령어를 실행합니다.

gcloud artifacts packages list [--repository=REPOSITORY] [--location=LOCATION]

각 항목의 의미는 다음과 같습니다.

  • REPOSITORY은 저장소 이름입니다. 기본 저장소를 구성한 경우 이 플래그를 생략하여 기본값을 사용할 수 있습니다.
  • LOCATION은 리전 또는 멀티 리전 위치입니다. 특정 위치의 저장소를 보려면 이 플래그를 사용합니다. 기본 위치를 구성한 경우 이 플래그를 생략하여 기본값을 사용할 수 있습니다.

패키지 버전을 보려면 다음 명령어를 실행합니다.

gcloud artifacts versions list --package=PACKAGE [--repository=REPOSITORY] [--location=LOCATION]

각 항목의 의미는 다음과 같습니다.

  • PACKAGE는 패키지의 ID 또는 패키지의 정규화된 식별자입니다.
  • REPOSITORY은 저장소 이름입니다. 기본 저장소를 구성한 경우 이 플래그를 생략하여 기본값을 사용할 수 있습니다.
  • LOCATION은 리전 또는 멀티 리전 위치입니다. 특정 위치의 저장소를 보려면 이 플래그를 사용합니다. 기본 위치를 구성한 경우 이 플래그를 생략하여 기본값을 사용할 수 있습니다.

일부 패키지에는 WAR 또는 JAR 파일이 여러 개 포함될 수 있습니다. 저장소의 모든 파일을 나열하려면 다음 명령어를 실행합니다.

gcloud auth login
curl -v -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-GFE-SSL: yes" \
https://artifactregistry.googleapis.com/v1beta2/projects/PROJECT/locations/LOCATION/repositories/REPOSITORY/files

다음 값을 바꿉니다.

  • PROJECT는 프로젝트 ID입니다.
  • LOCATION은 리전 또는 멀티 리전 위치입니다. 특정 위치의 저장소를 보려면 이 플래그를 사용합니다. 기본 위치를 구성한 경우 이 플래그를 생략하여 기본값을 사용할 수 있습니다.
  • REPOSITORY은 저장소 이름입니다. 기본 저장소를 구성한 경우 이 플래그를 생략하여 기본값을 사용할 수 있습니다.

패키지 및 버전 삭제

패키지를 삭제하려면 다음 안내를 따르세요.

Console

  1. Google Cloud Console에서 저장소 페이지를 엽니다.

    저장소 페이지 열기

  2. 저장소 목록에서 적절한 저장소를 클릭합니다.

    패키지 페이지에 저장소의 패키지가 나열됩니다.

  3. 삭제할 위젯을 선택합니다.

  4. 삭제를 클릭합니다.

  5. 확인 대화상자에서 삭제를 클릭합니다.

gcloud

다음 명령어를 실행합니다.

gcloud artifacts packages delete PACKAGE \
[--repository=REPOSITORY] [--location=LOCATION] [--async]

각 항목의 의미는 다음과 같습니다.

  • REPOSITORY은 저장소 이름입니다. 기본 저장소를 구성한 경우 이 플래그를 생략하여 기본값을 사용할 수 있습니다.
  • LOCATION은 리전 또는 멀티 리전 위치입니다. 특정 위치의 저장소를 보려면 이 플래그를 사용합니다. 기본 위치를 구성한 경우 이 플래그를 생략하여 기본값을 사용할 수 있습니다.
  • --async는 진행 중인 작업이 완료되기를 기다리지 않고 즉시 반환됩니다.

패키지의 버전을 삭제하려면 다음 안내를 따르세요.

Console

  1. Google Cloud Console에서 저장소 페이지를 엽니다.

    저장소 페이지 열기

  2. 저장소 목록에서 적절한 저장소를 클릭합니다.

    패키지 페이지에 저장소의 패키지가 나열됩니다.

  3. 패키지를 클릭하여 해당 패키지의 버전을 확인합니다.

  4. 삭제할 버전을 선택합니다.

  5. 삭제를 클릭합니다.

  6. 확인 대화상자에서 삭제를 클릭합니다.

gcloud

다음 명령어를 실행합니다.

gcloud artifacts versions delete VERSION \
[--repository=REPOSITORY] [--location=LOCATION] [--async]

각 항목의 의미는 다음과 같습니다.

  • REPOSITORY은 저장소 이름입니다. 기본 저장소를 구성한 경우 이 플래그를 생략하여 기본값을 사용할 수 있습니다.
  • LOCATION은 리전 또는 멀티 리전 위치입니다. 특정 위치의 저장소를 보려면 이 플래그를 사용합니다. 기본 위치를 구성한 경우 이 플래그를 생략하여 기본값을 사용할 수 있습니다.
  • --async는 진행 중인 작업이 완료되기를 기다리지 않고 즉시 반환됩니다.

패키지 다운로드

빌드의 일부로 아티팩트를 다운로드하려면 아티팩트를 종속 항목으로 선언합니다.

Maven

프로젝트 pom.xml 파일에 다운로드할 패키지를 선언합니다. 다음 예시는 artifact 패키지의 버전 1.0을 종속 항목으로 선언합니다.

<dependencies>
    <dependency>
        <groupId>group</groupId>
        <artifactId>artifact</artifactId>
        <version>1.0</version>
    </dependency>
<dependencies>

Maven 종속 항목에 대한 자세한 내용은 Maven 종속 항목 소개종속 항목 참조를 참조하세요.

Gradle

프로젝트 build.gradle 파일에 다운로드할 패키지를 선언합니다. 다음 예시는 artifact 패키지의 버전 1.0을 외부 컴파일 종속 항목으로 선언합니다.

Gradle 종속 항목에 관한 자세한 내용은 Gradle 문서를 참조하세요.

dependencies {
    compile group: 'group', name: 'artifact', version: '1.0'
}

다음 단계