Maven 및 Gradle 빠른 시작

이 빠른 시작에서는 Artifact Registry Maven 저장소를 설정하고 여기에 패키지를 업로드하는 방법을 보여줍니다.

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

시작하기 전에

  1. Google Cloud 계정에 로그인합니다. Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.
  2. Google Cloud Console의 프로젝트 선택기 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.

    프로젝트 선택기로 이동

  3. Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다. 프로젝트에 결제가 사용 설정되어 있는지 확인하는 방법을 알아보세요.

  4. Artifact Registry API를 사용 설정합니다.

    API 사용 설정

  5. Cloud SDK 설치 및 초기화

Maven 저장소 만들기

자바 아티팩트를 위한 저장소를 만듭니다.

  1. 저장소를 만듭니다.

    Console

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

      저장소 페이지 열기

    2. 저장소 만들기를 클릭합니다.

    3. quickstart-maven-repo를 저장소 이름으로 지정합니다.

    4. Maven을 형식으로 선택합니다.

    5. 위치 유형에서 리전을 선택하고 위치 us-central1를 선택합니다.

    6. 만들기를 클릭합니다.

    저장소가 저장소 목록에 추가됩니다.

    gcloud

    1. 다음 명령어를 실행하여 quickstart-maven-repo라는 현재 프로젝트의 새로운 Maven 저장소를 위치 us-central1에 만듭니다.

      gcloud artifacts repositories create quickstart-maven-repo --repository-format=maven \
      --location=us-central1 [--description="Maven repository"]
      
    2. 다음 명령어를 실행하여 저장소가 생성되었는지 확인합니다.

      gcloud artifacts 저장소 목록

    Artifact Registry 명령어에 대한 자세한 내용을 보려면 gcloud artifacts 명령어를 실행하세요.

  2. gcloud 명령어를 간소화하려면 기본 저장소를 quickstart-maven-repo로, 기본 위치를 us-central1로 설정합니다. 값을 설정한 후에는 저장소 또는 위치가 필요한 gcloud 명령어에 이를 지정할 필요가 없습니다.

    저장소를 설정하려면 다음 명령어를 실행합니다.

    gcloud config set artifacts/repository quickstart-maven-repo
    

    위치를 설정하려면 다음 명령어를 실행합니다.

    gcloud config set artifacts/location us-central1
    

    이 명령어에 대한 자세한 내용은 gcloud config set 문서를 참조하세요.

클라이언트의 서비스 계정 설정

  1. 애플리케이션 대신 작동하도록 서비스 계정을 만들거나 자동화에 사용할 기존 서비스 계정을 선택합니다.

    Artifact Registry로 인증을 설정하려면 서비스 계정 키 파일의 위치가 필요합니다. 기존 계정의 경우 서비스 계정 페이지에서 키를 확인하고 새 키를 만들 수 있습니다.

    서비스 계정 페이지로 이동

  2. 서비스 계정에 저장소에 대한 읽기 및 쓰기 액세스 권한을 부여합니다.

    gcloud artifacts repositories add-iam-policy-binding \
    quickstart-maven-repo --location=us-central1 --member='serviceAccount:ACCOUNT' --role='roles/artifactregistry.writer'
    

    여기서 ACCOUNTUSERNAME@PROJECT-ID.iam.gserviceaccount.com 형식의 서비스 계정 ID입니다.

  3. 저장소와 연결할 때 Artifact Registry 사용자 인증 정보 도우미가 키를 가져올 수 있도록 서비스 계정 키 파일 위치를 변수 GOOGLE_APPLICATION_CREDENTIALS에 할당합니다.

    export GOOGLE_APPLICATION_CREDENTIALS=KEY-FILE
    

    여기서 KEY-FILE는 서비스 계정 키 파일의 경로입니다.

    서비스 계정 키 파일로 비밀번호 인증을 설정하는 방법에 대한 자세한 내용은 authentication#auth-password 문서를 참조하세요.

Maven 구성

  1. 사용할 Maven 프로젝트를 선택합니다.

    사용 가능한 간단한 프로젝트가 없으면 5분 안에 Maven 프로젝트를 만들 수 있습니다.

  2. 다음 명령어를 실행하여 기본 quickstart-maven-repo 저장소의 설정을 인쇄합니다.

    gcloud artifacts print-settings mvn
    

    gcloud 명령어의 출력은 다음 스니펫과 같습니다. 여기서 PROJECT는 프로젝트 ID입니다.

    <distributionManagement>
      <snapshotRepository>
        <id>artifact-registry</id>
        <url>artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-maven-repo</url>
      </snapshotRepository>
      <repository>
        <id>artifact-registry</id>
        <url>artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-maven-repo</url>
      </repository>
    </distributionManagement>
    
    <repositories>
      <repository>
        <id>artifact-registry</id>
        <url>artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-maven-repo</url>
        <releases>
          <enabled>true</enabled>
        </releases>
        <snapshots>
          <enabled>true</enabled>
        </snapshots>
      </repository>
    </repositories>
    
    <build>
      <extensions>
        <extension>
          <groupId>com.google.cloud.artifactregistry</groupId>
          <artifactId>artifactregistry-maven-wagon</artifactId>
          <version>2.1.1</version>
        </extension>
      </extensions>
    </build>
    
  3. Maven 프로젝트의 pom.xml 파일에 설정을 추가합니다. 다음 개요에서는 각 기본 요소의 상대적 위치를 보여줍니다. 파일 구조에 대한 자세한 내용은 Maven POM 참조를 확인하세요.

    <project xmlns="http://maven.apache.org/POM/4.0.0"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
                          http://maven.apache.org/xsd/maven-4.0.0.xsd">
    
      <!-- Build Settings -->
      <build>
        ...
        <extensions>...</extensions>
      </build>
    
      <!-- Environment Settings -->
      <repositories>...</repositories>
      <distributionManagement>...</distributionManagement>
    </project>
    

Gradle 구성

  1. 간단한 Gradle 프로젝트를 만들어, 생성한 Artifact Registry 저장소에 패키지를 배포합니다. 테스트 Gradle 빌드가 없는 경우 입문용 Gradle 가이드를 따라 간단한 Gradle 빌드를 만들 수 있습니다.

  2. gcloud 명령어를 간소화하려면 기본 저장소를 quickstart-maven-repo로, 기본 위치를 us-central1로 설정합니다. 값을 설정한 후에는 저장소 또는 위치가 필요한 gcloud 명령어에 이를 지정할 필요가 없습니다.

    저장소를 설정하려면 다음 명령어를 실행합니다.

    gcloud config set artifacts/repository quickstart-maven-repo
    

    위치를 설정하려면 다음 명령어를 실행합니다.

    gcloud config set artifacts/location us-central1
    

    이 명령어에 대한 자세한 내용은 gcloud config set 문서를 참조하세요.

  3. build.gradle 파일에 저장소에 연결할 설정을 추가합니다. 다음 명령어는 기본 quickstart-maven-repo 저장소에 추가할 설정을 출력합니다.

    gcloud artifacts print-settings gradle
    

    gcloud 명령어의 출력은 다음 예시와 같습니다. 여기서 PROJECT는 프로젝트 ID입니다.

    plugins {
      id "maven-publish"
      id "com.google.cloud.artifactregistry.gradle-plugin" version "2.1.1"
    }
    
    publishing {
      repositories {
        maven {
          url "artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-maven-repo"
        }
      }
    }
    
    repositories {
      maven {
        url "artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-maven-repo"
      }
    }
    
  4. build.gradle 파일에 게시물 섹션이 포함되어 있는지 확인합니다. publications 섹션은 다음 예시와 같이 publishing의 하위 요소입니다.

    publishing {
      publications {
           mavenJava(MavenPublication) {
              groupId  'maven.example.id'
              from components.java
           }
      }
      repositories {
        maven {
          url "artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-maven-repo"
        }
      }
    }
    

init.gradle 또는 settings 파일에 저장소 구성을 추가할 수도 있습니다. 이러한 옵션에 대한 자세한 내용은 인증 설정을 참조하세요.

저장소에 패키지 업로드

Maven의 경우 mvn deploymvn release를 사용하여 저장소에 패키지를 추가할 수 있습니다.

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

저장소의 패키지 보기

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

Console

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

    저장소 페이지 열기

  2. 저장소 목록에서 quickstart-maven-repo 저장소를 선택합니다.

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

gcloud

quickstart-maven-repo 저장소의 패키지를 나열하려면 다음 명령어를 실행합니다.

 gcloud artifacts packages list --repository=quickstart-maven-repo

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

gcloud artifacts versions list --package=PACKAGE

여기서 PACKAGE는 패키지 ID입니다.

삭제

이 빠른 시작에서 사용한 리소스의 비용이 Google Cloud 계정에 청구되지 않도록 하려면 다음 단계를 따르세요.

저장소를 삭제하기 전에, 보관할 패키지를 다른 위치에서 사용할 수 있는지 확인합니다.

저장소를 삭제하려면 다음 안내를 따르세요.

Console

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

    저장소 페이지 열기

  2. 저장소 목록에서 quickstart-maven-repo 저장소를 선택합니다.

  3. 삭제를 클릭합니다.

gcloud

  1. quickstart-maven-repo 저장소를 삭제하려면 다음 명령어를 실행합니다.

    gcloud artifacts repositories delete quickstart-maven-repo
    
  2. 활성 gcloud 구성에 지정한 기본 저장소 및 위치 설정을 삭제하려면 다음 명령어를 실행합니다.

    gcloud config unset artifacts/repository
    gcloud config unset artifacts/location
    

다음 단계