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

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Usługa Azure Artifacts umożliwia deweloperom zarządzanie zależnościami z jednego źródła danych przy jednoczesnym zapewnieniu kontroli nad udostępnianiem pakietów. Za pomocą źródeł danych usługi Azure Artifacts można publikować i przywracać pakiety Maven oraz konfigurować źródła nadrzędne w celu korzystania z pakietów z publicznych rejestrów, takich jak Maven Central, Google Maven Repository, Gradle Plugins i JitPack. Ten artykuł przeprowadzi Cię przez proces konfigurowania projektu Maven, nawiązywania połączenia z kanałem informacyjnym usługi Azure Artifacts oraz publikowania i przywracania pakietów Maven.

Wymagania wstępne

• Utwórz organizację usługi Azure DevOps i projekt, jeśli jeszcze tego nie zrobiono.

• Pobierz i zainstaluj oprogramowanie Apache Maven.

Tworzenie kanału informacyjnego

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

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

3. W polu Nazwa wprowadź opisową nazwę kanału informacyjnego.

   W obszarze Widoczność wybierz opcję, aby wskazać, kto może wyświetlać pakiety w kanale informacyjnym.

   Jeśli chcesz dołączyć pakiety ze źródeł publicznych, zaznacz pole wyboru w obszarze Nadrzędne źródła.

   W polu Zakres określ, czy zakres źródła danych jest projektem, czy organizacją.

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

   

Uwaga

Domyślnie nowo utworzone kanały informacyjne mają wartość usługi kompilacji projektu ustawioną na Wartość Kanał informacyjny i Nadrzędny czytelnik (współpracownik).

Nawiązywanie połączenia z kanałem informacyjnym

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

2. Wybierz pozycję Artefakty, a następnie wybierz źródło danych z menu rozwijanego.

3. Wybierz pozycję Połącz z kanałem informacyjnym, a następnie wybierz pozycję Maven w obszarze nawigacji po lewej stronie.

4. Jeśli po raz pierwszy używasz usługi Azure Artifacts z narzędziem Maven, upewnij się, że zainstalowano wymagania wstępne. W przeciwnym razie wybierz pozycję Pobierz narzędzia w prawym górnym rogu, aby je zainstalować.

5. Postępuj zgodnie z instrukcjami w sekcji Konfiguracja projektu, aby skonfigurować pliki pom.xml i settings.xml . Pliki powinny przypominać następujące przykłady:

   • pom.xml:

       <repositories>
         <repository>
           <id>MavenDemo</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>MavenDemo</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>
     

   • settings.xml:

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

6. Wygeneruj osobisty token dostępu z zakresem odczytu i zapisu pakietu>, a następnie wklej go do tagu<password>.

Publikowanie pakietów

1. 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 wdrożeniu pakietu wkrótce będzie on dostępny w kanale informacyjnym.

   

Uwaga

Jeśli twoja organizacja korzysta z zapory lub serwera proxy, upewnij się, że zezwalasz na adresy URL i adresy IP domeny usługi Azure Artifacts.

Przywracanie pakietów

1. Przejdź do obszaru Artefakty w projekcie usługi Azure DevOps, wybierz źródło danych z menu rozwijanego, a następnie wybierz pakiet, który chcesz zainstalować.

2. Przejdź do obszaru Przegląd>narzędzia Maven, a następnie skopiuj fragment kodu zależności.

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

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

   mvn install
   

Powiązane artykuły

• Publikowanie artefaktów maven za pomocą usługi Azure Pipelines
• Korzystanie z pakietów z usługi Maven Central
• Używanie źródeł nadrzędnych w publicznym kanale informacyjnym