Azure Artifacts에서 Maven 패키지 시작

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Maven 패키지는 Apache Maven 빌드 도구를 사용하여 빌드된 Java 이진 파일입니다. Azure Artifacts 피드를 사용하면 여러 패키지 형식을 단일 피드에 저장할 수 있습니다. 그런 다음 저장된 패키지를 복원하여 프로젝트를 빌드하거나 팀 및 고객과 공유할 수 있습니다. Azure Artifacts 피드는 또한 업스트림 원본을 통해 Maven Central, Google Maven 리포지토리, Gradle 플러그 인 및 JitPack과 같은 공용 레지스트리에서 패키지를 사용하는 것을 지원합니다.

이 문서에서는 Maven 프로젝트를 설정하고, Azure Artifacts 피드에 연결하고, Maven 패키지를 게시하고 복원하는 방법을 안내합니다.

필수 조건

피드 만들기

피드가 이미 있는 경우 다음 섹션으로 건너뛸 수 있습니다. 그렇지 않으면 다음과 같이 새 피드를 만듭니다.

1. Azure DevOps 조직에 로그인하고 프로젝트로 이동합니다.

2. 아티팩트,피드 만들기를 선택합니다.

3. 피드의 이름을 제공하고, 표시 유형을 선택하여 패키지를 볼 수 있는 사용자를 정의하고, 피드 범위를 선택합니다. Maven Central 또는 Google Maven 리포지토리와 같은 공용 레지스트리의 패키지를 포함하려면 공통 공용 원본의 패키지 포함을 선택합니다.

4. 완료되면 만들기를 선택합니다.

피드에 연결

피드가 있으므로 피드를 사용하여 인증하도록 구성 파일을 설정해야 하므로 Azure DevOps로 인증하기 위한 개인 액세스 토큰도 만들어야 합니다. 다음 단계에 따라 피드를 인증하고 연결합니다.

1. 패키징읽기 및 쓰기 범위를 사용하여 >을 생성합니다. PAT를 복사하고 다음 단계에서 필요하므로 안전한 위치에 저장합니다.

2. Azure DevOps에 로그인한 다음 프로젝트로 이동합니다.

3. 아티팩트를 선택한 후 드롭다운 메뉴에서 피드를 선택합니다.

4. 피드에 연결을 선택한 다음 왼쪽 탐색 창에서 Maven을 선택합니다.

5. 이 컴퓨터에서 Maven과 함께 Azure Artifacts를 처음 사용하는 경우 필수 구성 요소를 설치했는지 확인합니다.

6. pom.xml 파일을 열고 제공된 코드 조각을 프로젝트 설정 섹션과 <repositories> 섹션 모두에 <distributionManagement> 추가합니다. pom.xml 다음과 유사하게 표시됩니다.

       <repositories>
           <repository>
               <id>FEED_NAME</id>
               <url>https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/maven/v1</url>
               <releases>
               <enabled>true</enabled>
               </releases>
               <snapshots>
               <enabled>true</enabled>
               </snapshots>
           </repository>
       </repositories>
       <distributionManagement>
           <repository>
               <id>FEED_NAME</id>
               <url>https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/maven/v1</url>
               <releases>
               <enabled>true</enabled>
               </releases>
               <snapshots>
               <enabled>true</enabled>
               </snapshots>
           </repository>
       </distributionManagement>
   

7. settings.xml 파일을 사용자 계정 수준에서 열고 <password> 태그에 PAT를 추가합니다. 이 파일은 로컬로 유지되어야 하므로 자격 증명을 노출하지 않도록 소스 코드에 커밋하지 않아야 합니다. settings.xml 파일은 다음과 유사합니다.

       <servers>
           <server>
               <id>MavenDemo</id>
               <username><ORGANIZATION_NAME></username>
               <password>[PERSONAL_ACCESS_TOKEN]</password>
           </server>
       </servers>
   

패키지 게시

이제 피드를 사용하여 인증했으므로 패키지를 게시하고 복원할 준비가 되었습니다.

1. 패키지를 아직 빌드하지 않은 경우 명령 프롬프트 창을 열고 pom.xml 파일이 있는 프로젝트 디렉터리로 이동한 다음, 다음 명령을 실행하여 프로젝트를 패키지합니다. 이 명령은 코드를 컴파일하고, 포함된 테스트를 실행하고, 프로젝트를 배포 가능한 형식(예: JAR 파일)으로 패키지합니다.

   mvn package
   

2. 프로젝트 디렉터리에서 다음 명령을 실행하여 피드에 패키지를 게시합니다.

   mvn deploy
   

3. 패키지를 성공적으로 게시하면 곧 Azure Artifacts 피드에서 사용할 수 있습니다.

   

패키지 복원

패키지를 피드에서 복원하려면, 프로젝트 디렉터리에서 mvn install 명령을 실행하여 pom.xml에 나열된 모든 종속성을 설치합니다. 피드에서 설치하려는 패키지가 pom.xml에 포함되어 있지 않다면, 피드에 추가하고 피드에서 복원하는 방법은 다음과 같습니다.

1. Azure DevOps에 로그인한 다음 프로젝트로 이동합니다.

2. 아티팩트를 선택한 후 드롭다운 메뉴에서 피드를 선택합니다.

3. 설치할 패키지를 선택하고 개요>Maven으로 이동한 다음 종속성 코드 조각을 복사합니다. 다음과 유사하게 표시됩니다.

   <dependency>
     <groupId>MyGroup</groupId>
     <artifactId>MavenQuickStartDemo</artifactId>
     <version>1.0-SNAPSHOT</version>
   </dependency>
   

4. pom.xml 파일을 열고 태그 안에 코드 조각을 붙여넣습니다<dependencies>.

5. pom.xml 파일이 있는 디렉터리에서 다음 명령을 실행하여 패키지를 복원합니다.

   mvn install
   

관련 콘텐츠

• Azure Pipelines를 사용하여 Maven 아티팩트 게시(클래식/YAML)

• Maven Central에서 패키지 사용

• 퍼블릭 피드에서 업스트림 원본 사용