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 quindi passare al progetto.

2. Selezionare Artefatti e quindi Crea feed.

3. In Nome immettere un nome descrittivo per il feed.

   In Visibilità selezionare un'opzione per indicare chi può visualizzare i pacchetti all'interno del feed.

   Per includere pacchetti da origini pubbliche, selezionare la casella di controllo in Origini upstream.

   Per Ambito specificare se l'ambito del feed è il progetto o l'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 e quindi selezionare il 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 ambito di lettura e scrittura per la creazione di pacchetti>e incollarlo nel <password> tag.

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 artefatti Maven con Azure Pipelines
• Usare pacchetti da Maven Central
• Usare le origini upstream in un feed pubblico