Wprowadzenie do pakietów Maven w usłudze Azure Artifacts

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

Pakiety Maven to pliki binarne Języka Java utworzone przy użyciu narzędzia kompilacji Apache Maven. Za pomocą kanałów usługi Azure Artifacts można przechowywać wiele typów pakietów w jednym kanale źródłowym. Następnie można przywrócić przechowywane pakiety w celu skompilowania projektu lub udostępnienia go zespołowi i klientom. Źródła danych usługi Azure Artifacts obsługują również korzystanie z pakietów z publicznych rejestrów, takich jak Maven Central, Google Maven Repository, Gradle Plugins i JitPack za pośrednictwem nadrzędnych źródeł.

Ten artykuł przeprowadzi Cię przez proces konfigurowania projektu Maven, łączenia go z kanałem informacyjnym usługi Azure Artifacts oraz publikowania i przywracania pakietów Maven.

Wymagania wstępne

Tworzenie kanału informacyjnego

Jeśli masz już kanał informacyjny, możesz przejść do następnej sekcji. W przeciwnym razie utwórz nowe źródło danych w następujący sposób:

1. Zaloguj się do organizacji usługi Azure DevOps i przejdź do projektu.

2. Wybierz pozycję Artefakty, a następnie wybierz pozycję Utwórz kanał.

3. Podaj nazwę źródła danych, wybierz widoczność, aby zdefiniować, kto może wyświetlać pakiety, i wybierz zakres źródła danych. Jeśli chcesz uwzględnić pakiety z publicznych rejestrów, takich jak Maven Central lub Google Maven Repository, zaznacz pole wyboru Uwzględnij pakiety z typowych źródeł publicznych.

4. Po zakończeniu wybierz pozycję Utwórz .

Połącz się z kanałem

Teraz, gdy masz kanał informacyjny, musisz skonfigurować plik konfiguracji do uwierzytelniania za pomocą kanału informacyjnego, musisz również utworzyć osobisty token dostępu do uwierzytelniania w usłudze Azure DevOps. Wykonaj poniższe kroki, aby uwierzytelnić się i nawiązać połączenie z kanałem informacyjnym:

1. Wygeneruj osobisty token dostępu z zakresem pakietu>odczytu i zapisu. Skopiuj swój PAT i zapisz go w bezpiecznym miejscu, ponieważ będzie potrzebny w kolejnych krokach.

2. Zaloguj się do usługi Azure DevOps, a następnie przejdź do projektu.

3. Wybierz Artefakty, a następnie wybierz swój kanał informacyjny z menu rozwijanego.

4. Wybierz Połącz z kanałem informacyjnym, a następnie wybierz Maven w panelu nawigacyjnym po lewej stronie.

5. Jeśli po raz pierwszy używasz usługi Azure Artifacts z narzędziem Maven na tym komputerze, upewnij się, że zainstalowano wymagania wstępne.

6. Otwórz plik pom.xml i dodaj podany fragment kodu w sekcji Konfiguracja projektu zarówno w <repositories> jak i <distributionManagement> sekcjach. pom.xml powinien wyglądać podobnie do następującego:

       <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. Otwórz settings.xml na poziomie użytkownika i dodaj swój token dostępu do tagu <password> . Ten plik powinien być przechowywany lokalnie, więc upewnij się, że go nie zatwierdzasz w kodzie źródłowym, aby nie ujawnić poświadczeń. Plik settings.xml powinien wyglądać podobnie do następującego:

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

Publikowanie pakietów

Teraz, po uwierzytelnieniu przy użyciu kanału informacyjnego, możesz przystąpić do publikowania i przywracania pakietów:

1. Jeśli jeszcze nie skompilujesz pakietu, otwórz okno wiersza polecenia i przejdź do katalogu projektu, w którym znajduje się plik pom.xml , a następnie uruchom następujące polecenie, aby spakować projekt. To polecenie kompiluje kod, uruchamia dołączone testy i pakuje projekt do formatu dystrybucyjnego (takiego jak plik JAR).

   mvn package
   

2. Uruchom następujące polecenie z katalogu projektu, aby opublikować pakiet w kanale informacyjnym:

   mvn deploy
   

3. Po pomyślnym opublikowaniu pakietu wkrótce będzie on dostępny w kanale informacyjnym usługi Azure Artifacts.

   

Przywracanie pakietów

Aby przywrócić pakiety ze źródła danych, uruchom mvn install polecenie z katalogu projektu, aby zainstalować wszystkie zależności wymienione w pom.xml. Jeśli pakiet, który chcesz zainstalować z kanału informacyjnego, nie znajduje się w pom.xml, poniżej przedstawiono sposób dodawania go i przywracania z kanału informacyjnego:

1. Zaloguj się do usługi Azure DevOps, a następnie przejdź do projektu.

2. Wybierz Artefakty, a następnie wybierz swój kanał informacyjny z menu rozwijanego.

3. Wybierz pakiet, który chcesz zainstalować, przejdź do Przegląd>Maven, a następnie skopiuj fragment zależności. Powinien wyglądać podobnie do tego:

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

4. Otwórz plik pom.xml i wklej fragment kodu wewnątrz tagu<dependencies>.

5. Uruchom następujące polecenie z katalogu, w którym znajduje się plik pom.xml , aby przywrócić pakiety:

   mvn install
   

Treści powiązane

• Publikowanie artefaktów Maven za pomocą usługi Azure Pipelines (Classic/YAML)

• Korzystanie z pakietów z usługi Maven Central

• Używanie źródeł nadrzędnych w publicznym kanale informacyjnym