Usare pacchetti da Maven Central

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

L'uso di origini upstream di Azure Artifacts consente di usare un singolo feed per ospitare entrambi i pacchetti prodotti e pacchetti da registri pubblici, ad esempio Maven Central. Quando si aggiungono origini upstream al feed, Azure Artifacts salva una copia di qualsiasi pacchetto installato da upstream. In questo modo si garantisce un'accessibilità continua per lo sviluppo, anche se un registro pubblico subisce un'interruzione. Azure Artifacts supporta anche varie altre origini upstream di Maven, tra cui il repository Maven di Google, i plug-in Gradle e JitPack.

Prerequisiti

  • Un'organizzazione Di Azure DevOps e un progetto. Creare un'organizzazione o un progetto, se non è già stato fatto.

  • Feed di Azure Artifacts.

Nota

Gli snapshot Maven non sono supportati con le origini upstream di Maven.

Abilitare le origini upstream

Se non si dispone già di un feed, seguire queste istruzioni per crearne una e assicurarsi di selezionare la casella di controllo origini upstream per abilitarle. Se si dispone già di un feed, passare al passaggio successivo per aggiungere Maven Central come origine upstream.

  1. Accedere all'organizzazione di Azure DevOps e passare al progetto.

  2. Selezionare Artefatti e quindi crea feed per creare un nuovo feed.

  3. Immettere un nome descrittivo per il feed e definirne la visibilità (che indica chi può visualizzare i pacchetti all'interno del feed). Specificare l'ambito del feed e, se si desidera includere pacchetti da origini pubbliche, contrassegnare la casella di controllo Origini upstream.

  4. Al termine, fare clic su Crea.

    Screenshot che mostra come creare un nuovo feed in Azure DevOps Services.

  1. Accedere al server Azure DevOps e quindi passare al progetto.

  2. Selezionare Artefatti e quindi crea feed per creare un nuovo feed.

  3. Immettere un nome descrittivo per il feed e definirne la visibilità (che indica chi può visualizzare i pacchetti all'interno del feed). Specificare l'ambito del feed e, se si desidera includere pacchetti da origini pubbliche, contrassegnare la casella di controllo Origini upstream.

  1. Al termine, fare clic su Crea.

    Screenshot che mostra come creare un nuovo feed in Azure DevOps 2022.

  1. Al termine, fare clic su Crea.

    Screenshot che mostra come creare un nuovo feed in Azure DevOps 2020.

  1. Accedere al server Azure DevOps e quindi passare al progetto.

  2. Selezionare Artefatti e quindi nuovo feed.

  3. Immettere un nome descrittivo per il feed e definirne la visibilità (che indica chi può visualizzare i pacchetti all'interno del feed). Se si desidera includere pacchetti da origini pubbliche, selezionare l'opzione Usa pacchetti da origini pubbliche tramite questa opzione di feed .

  4. Al termine, fare clic su Crea.

    Screenshot che mostra come creare un nuovo feed in Azure DevOps 2019.

Nota

Per impostazione predefinita, i feed appena creati hanno il servizio di compilazione del progetto impostato su Feed e lettore upstream (collaboratore).

Aggiungere Maven Central upstream

Se è stata selezionata la casella di controllo origini upstream durante la creazione del feed, Maven Central dovrebbe essere già aggiunto come origine upstream. In caso contrario, è possibile aggiungerlo manualmente seguendo questa procedura:

  1. Accedere all'organizzazione di Azure DevOps e passare al progetto.

  2. Selezionare Artifacts (Artefatti) e quindi selezionare nell'angoloicona a forma di ingranaggioin alto a destra per passare al feed Impostazioni.

  3. Selezionare Origini upstream e quindi Aggiungi upstream.

  4. Selezionare Origine pubblica, selezionare Maven Central (https://repo.maven.apache.org/maven2/) dal menu a discesa e quindi selezionare Salva al termine.

    Screenshot che mostra come aggiungere l'origine upstream centrale Maven.

  5. Selezionare Salva nell'angolo in alto a destra per salvare le modifiche.

    Screenshot che mostra come salvare le origini upstream.

Salvare il pacchetto da Maven Central

Prima di salvare i pacchetti da Maven Central, assicurarsi di aver configurato il progetto per connettersi al feed. Se non è già stato fatto, seguire le istruzioni nella configurazione del progetto per configurare il progetto Maven e connettersi al feed.

In questo esempio si salverà la libreria Datetime Kotlin da Maven Central.

  1. Passare a Maven Central all'indirizzo https://mvnrepository.com/.

  2. Cercare la libreria Datetime di Kotlin. Selezionare il pacchetto Kotlinx Datetime e quindi selezionare la versione da installare.

  3. Copiare il <dependency> frammento di codice dalla scheda Maven .

    <dependency>
        <groupId>org.jetbrains.kotlinx</groupId>
        <artifactId>kotlinx-datetime-jvm</artifactId>
        <version>0.4.1</version>
        <scope>runtime</scope>
    </dependency>
    
  4. Aprire il file pom.xml e incollare il frammento all'interno del <dependencies> tag e quindi salvare il file.

  5. Eseguire il comando seguente dallo stesso percorso del file pom.xml per installare le dipendenze:

    mvn install
    

Nota

Per salvare i pacchetti da upstream, è necessario avere il ruolo Feed e lettore upstream (collaboratore) o versione successiva. Per altri dettagli, vedere Gestire le autorizzazioni .

Visualizzare i pacchetti salvati

È possibile visualizzare i pacchetti salvati da upstream selezionando l'origine Maven Central dal menu a discesa.

  1. Accedere all'organizzazione di Azure DevOps e passare al progetto.

  2. Selezionare Artefatti e quindi selezionare il feed dal menu a discesa.

  3. Selezionare Maven Central dal menu a discesa di origine per filtrare i pacchetti da questo upstream.

  4. Il pacchetto Kotlinx Datetime salvato nel passaggio precedente è ora disponibile nel feed. Azure Artifacts ha salvato automaticamente una copia nel feed quando è stato eseguito il comando mvn install.

Screenshot che mostra un pacchetto salvato da Maven Central.

Suggerimento

Se Maven non scarica tutte le dipendenze, eseguire il comando seguente dalla directory del progetto per rigenerare i file del progetto: mvn eclipse:eclipse -DdownloadSources=true -DdownloadJavadocs=true