Introduzione ai pacchetti Maven in Azure Artifacts

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

Azure Artifacts consente agli sviluppatori di gestire le dipendenze da un singolo feed fornendo al tempo stesso il controllo sulla condivisione dei pacchetti. Con i feed di Azure Artifacts è possibile pubblicare e ripristinare pacchetti Maven e configurare origini upstream per l'uso di pacchetti da registri pubblici come Maven Central, repository Google Maven, plug-in Gradle e JitPack. Questo articolo illustra come configurare il progetto Maven, connettersi a un feed di Azure Artifacts e pubblicare e ripristinare i pacchetti Maven.

Prerequisiti

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

• Scaricare e installare Apache Maven.

Creare un feed

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

2. Selezionare Artefatti e quindi selezionare Crea feed.

3. Specificare un Nome per il feed, scegliere l'opzione Visibilità che definisce chi può visualizzare i pacchetti, selezionare Includi pacchetti da origini pubbliche comuni se si desidera includere pacchetti da fonti come nuget.org o npmjs.com, e per l'opzione Ambitodecidere se il feed deve essere limitato al progetto o all'intera organizzazione.

4. Al termine, fare clic su Crea.

   

Nota

Per impostazione predefinita, i feed appena creati hanno il valore del servizio di compilazione del progetto impostato su Feed e Lettore Upstream (Collaboratore).

Connettersi a un feed

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

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

3. Selezionare Connetti al feed e quindi selezionare Maven nell'area di spostamento a sinistra.

4. Se questa è la prima volta che si usa Azure Artifacts con Maven, assicurarsi di aver installato i prerequisiti. In caso contrario, selezionare Ottieni gli strumenti nell'angolo superiore destro per installarli.

5. Seguire le istruzioni nella sezione Configurazione progetto per configurare i file pom.xml e settings.xml . I file dovrebbero essere simili agli esempi seguenti:

   • 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. Generare un token di accesso personale con confezionamento>ambito di lettura e scrittura, e incollarlo nel tag <password>.

Pubblicare pacchetti

1. Aprire una finestra del prompt dei comandi e passare alla directory del progetto in cui si trova il file pom.xml, quindi eseguire il comando seguente per creare il pacchetto del progetto. Questo comando compila il codice, esegue test inclusi e crea un pacchetto del progetto in un formato distribuibile, ad esempio un file JAR.

   mvn package
   

2. Eseguire il comando seguente dalla directory del progetto per pubblicare il pacchetto nel feed:

   mvn deploy
   

3. Dopo aver distribuito correttamente il pacchetto, sarà disponibile a breve nel feed.

   

Nota

Se l'organizzazione usa un firewall o un server proxy, assicurarsi di consentire gli URL di dominio e gli indirizzi IP di Azure Artifacts.

Ripristinare pacchetti

1. Passare a Artefatti nel progetto Azure DevOps, selezionare il feed dal menu a discesa e quindi selezionare il pacchetto da installare.

2. Passare a Panoramica>Maven, quindi copiare il frammento di dipendenza.

3. Aprire il file pom.xml e incollare il frammento all'interno del <dependencies> tag.

4. Eseguire il comando seguente dalla directory in cui si trova il file pom.xml per ripristinare i pacchetti:

   mvn install
   

Articoli correlati

• Pubblicare gli artefatti Maven con Azure Pipelines
• Usare pacchetti da Maven Central
• Utilizzare le fonti a monte in un feed pubblico