Udostępnij za pośrednictwem


Korzystanie z pakietów z usługi Maven Central

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

Korzystanie ze źródeł nadrzędnych usługi Azure Artifacts umożliwia używanie pojedynczego źródła danych do hostowania zarówno pakietów, które tworzysz, jak i pakietów z publicznych rejestrów, takich jak Maven Central. Po dodaniu źródeł nadrzędnych do źródła danych usługa Azure Artifacts zapisuje kopię dowolnego pakietu zainstalowanego z nadrzędnego źródła danych. Zapewnia to ciągłą dostępność rozwoju, nawet jeśli rejestr publiczny uległ awarii. Ponadto usługa Azure Artifacts obsługuje różne inne źródła nadrzędne narzędzia Maven, w tym repozytorium Google Maven, wtyczki Gradle i pakiet JitPack.

Wymagania wstępne

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

  • Źródło danych usługi Azure Artifacts.

Uwaga

Migawki narzędzia Maven nie są obsługiwane w przypadku źródeł nadrzędnych maven.

Włączanie źródeł nadrzędnych

Jeśli nie masz jeszcze kanału informacyjnego, postępuj zgodnie z tymi instrukcjami, aby je utworzyć, i upewnij się, że zaznaczono pole wyboru nadrzędne źródła , aby je włączyć. Jeśli masz już źródło danych, przejdź do następnego kroku , aby dodać program Maven Central jako źródło nadrzędne.

  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 źródło danych , aby utworzyć nowe źródło danych.

  3. Wprowadź opisową nazwę źródła danych i zdefiniuj jego widoczność (wskazującą, kto może wyświetlać pakiety w kanale informacyjnym). Określ zakres źródła danych, a jeśli chcesz uwzględnić pakiety ze źródeł publicznych, zaznacz pole wyboru Upstream sources (Źródła nadrzędne).

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

    Zrzut ekranu przedstawiający sposób tworzenia nowego źródła danych w usłudze Azure DevOps Services.

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

  2. Wybierz pozycję Artefakty, a następnie wybierz pozycję Utwórz źródło danych , aby utworzyć nowe źródło danych.

  3. Wprowadź opisową nazwę źródła danych i zdefiniuj jego widoczność (wskazującą, kto może wyświetlać pakiety w kanale informacyjnym). Określ zakres źródła danych, a jeśli chcesz uwzględnić pakiety ze źródeł publicznych, zaznacz pole wyboru Upstream sources (Źródła nadrzędne).

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

    Zrzut ekranu przedstawiający sposób tworzenia nowego źródła danych w usłudze Azure DevOps 2022.

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

    Zrzut ekranu przedstawiający sposób tworzenia nowego źródła danych w usłudze Azure DevOps 2020.

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

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

  3. Wprowadź opisową nazwę źródła danych i zdefiniuj jego widoczność (wskazującą, kto może wyświetlać pakiety w kanale informacyjnym). Jeśli chcesz dołączyć pakiety ze źródeł publicznych, wybierz opcję Użyj pakietów ze źródeł publicznych za pośrednictwem tego kanału informacyjnego .

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

    Zrzut ekranu przedstawiający sposób tworzenia nowego źródła danych w usłudze Azure DevOps 2019.

Uwaga

Domyślnie nowo utworzone kanały informacyjne mają ustawioną usługę kompilacji projektu na Źródło danych i Czytelnik nadrzędny (współpracownicy).

Dodaj nadrzędną usługę Maven Central

Jeśli pole wyboru źródła nadrzędnego zostało zaznaczone podczas tworzenia źródła danych, narzędzie Maven Central powinno już zostać dodane jako nadrzędne źródło. Jeśli nie, możesz dodać ją ręcznie, wykonując następujące czynności:

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

  2. Wybierz pozycję Artefakty, a następnie wybierz ikonę ikona koła zębatego w prawym górnym rogu, aby przejść do Ustawienia kanału informacyjnego.

  3. Wybierz pozycję Źródła nadrzędne, a następnie wybierz pozycję Dodaj nadrzędny.

  4. Wybierz pozycję Źródło publiczne, wybierz pozycję Maven Central (https://repo.maven.apache.org/maven2/) z menu rozwijanego, a następnie wybierz pozycję Zapisz po zakończeniu.

    Zrzut ekranu przedstawiający sposób dodawania centralnego źródła nadrzędnego programu Maven.

  5. Wybierz pozycję Zapisz w prawym górnym rogu, aby zapisać zmiany.

    Zrzut ekranu przedstawiający sposób zapisywania nadrzędnych źródeł.

Zapisywanie pakietu z usługi Maven Central

Przed zapisaniem pakietów z usługi Maven Central upewnij się, że skonfigurowaliśmy projekt w celu nawiązania połączenia z kanałem informacyjnym. Jeśli jeszcze tego nie zrobiono, postępuj zgodnie z instrukcjami w konfiguracji projektu, aby skonfigurować projekt Maven i nawiązać połączenie z kanałem informacyjnym.

W tym przykładzie zapiszemy bibliotekę Kotlin Datetime z usługi Maven Central.

  1. Przejdź do usługi Maven Central pod adresem https://mvnrepository.com/.

  2. Wyszukaj bibliotekę Daty/godziny Kotlin. Wybierz pakiet Kotlinx Datetime, a następnie wybierz wersję, którą chcesz zainstalować.

  3. <dependency> Skopiuj fragment kodu z karty Maven.

    <dependency>
        <groupId>org.jetbrains.kotlinx</groupId>
        <artifactId>kotlinx-datetime-jvm</artifactId>
        <version>0.4.1</version>
        <scope>runtime</scope>
    </dependency>
    
  4. Otwórz plik pom.xml i wklej fragment kodu wewnątrz <dependencies> tagu, a następnie zapisz plik.

  5. Uruchom następujące polecenie z tej samej ścieżki co plik pom.xml , aby zainstalować zależności:

    mvn install
    

Uwaga

Aby zapisać pakiety z nadrzędnych strumieni, musisz mieć rolę Kanał informacyjny i Nadrzędny czytelnik (współpracownik) lub wyższy. Aby uzyskać więcej informacji, zobacz Zarządzanie uprawnieniami .

Wyświetlanie zapisanych pakietów

Pakiety zapisane z nadrzędnych strumieni można wyświetlić, wybierając źródło narzędzia Maven Central z menu rozwijanego.

  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ę Maven Central z menu rozwijanego źródła, aby filtrować pakiety z tego nadrzędnego źródła.

  4. Pakiet Kotlinx Datetime zapisany w poprzednim kroku jest teraz dostępny w naszym kanale informacyjnym. Usługa Azure Artifacts automatycznie zapisała kopię do naszego kanału informacyjnego po wykonaniu polecenia mvn install.

Zrzut ekranu przedstawiający pakiet zapisany w usłudze Maven Central.

Napiwek

Jeśli narzędzie Maven nie pobiera wszystkich zależności, uruchom następujące polecenie z katalogu projektu, aby ponownie wygenerować pliki projektu: mvn eclipse:eclipse -DdownloadSources=true -DdownloadJavadocs=true