Configurazione e utilizzo di mvn - Amazon CodeCatalyst

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Configurazione e utilizzo di mvn

Si utilizza il mvn comando per eseguire le build di Maven. È necessario configurare mvn per utilizzare l'archivio dei pacchetti e fornire un token di accesso personale (PAT) per l'autenticazione.

Recupero delle dipendenze da CodeCatalyst

mvnPer configurare il recupero delle dipendenze da un CodeCatalyst repository, devi modificare il file di configurazione di Maven settings.xml e, facoltativamente, il file Project Model Object (POM) del tuo progetto. Il file POM contiene informazioni sul progetto e informazioni di configurazione per consentire a Maven di creare il progetto, come dipendenze, directory di compilazione, directory dei sorgenti, directory dei sorgenti di test, plug-in e obiettivi.

Da usare per recuperare le mvn dipendenze dal repository dei pacchetti CodeCatalyst
  1. Apri la CodeCatalyst console all'indirizzo https://codecatalyst.aws/.

  2. Nella pagina di panoramica del progetto, scegli Pacchetti.

  3. Scegli il tuo repository di pacchetti dall'elenco dei repository di pacchetti.

  4. Scegli Connect to repository.

  5. Nella finestra di dialogo Connect to repository, scegliete mvn dall'elenco dei client del gestore di pacchetti.

  6. Avrai bisogno di un token di accesso personale (PAT) con cui autenticarti. mvn CodeCatalyst Se ne hai già uno, puoi usarlo. In caso contrario, puoi crearne uno qui.

    1. Scegli Crea token.

    2. Scegli Copia per copiare il tuo PAT.

      avvertimento

      Non potrai più vedere o copiare il tuo PAT dopo aver chiuso la finestra di dialogo.

  7. Aggiungi un profilo contenente il tuo repository al tuo settings.xml file. Sostituisci i seguenti valori.

    Nota

    Se si copiano le istruzioni dalla console, i seguenti valori devono essere aggiornati automaticamente e non devono essere modificati.

    • space_nameSostituiscili con il nome CodeCatalyst dello spazio.

    • proj_nameSostituiscilo con il nome CodeCatalyst del tuo progetto.

    • repo_nameSostituiscilo con il nome CodeCatalyst del repository dei pacchetti.

    <profiles> <profile> <id>repo_name</id> <activation> <activeByDefault>true</activeByDefault> </activation> <repositories> <repository> <id>repo_name</id> <url>https://packages.region.codecatalyst.aws/maven/space_name/proj_name/repo_name/</url> </repository> </repositories> </profile> </profiles>
  8. Aggiungi il tuo server all'elenco dei server nel settings.xml file. Sostituisci i seguenti valori.

    Nota

    Se si copiano le istruzioni dalla console, i seguenti valori devono essere aggiornati automaticamente e non devono essere modificati.

    • repo_nameSostituiteli con il nome CodeCatalyst del repository dei pacchetti.

    • Sostituisci username con il tuo nome CodeCatalyst utente.

    • PATSostituiscilo con il tuo CodeCatalyst PAT.

    <servers> <server> <id>repo_name</id> <username>username</username> <password>PAT</password> </server> </servers>
  9. (Facoltativo) Imposta un mirror nel settings.xml file che acquisisca tutte le connessioni e le indirizzi al repository anziché a un repository gateway.

    Nota

    Se copiate le istruzioni dalla console, i seguenti valori devono essere aggiornati automaticamente e non devono essere modificati.

    • space_nameSostituiscili con il nome CodeCatalyst dello spazio.

    • proj_nameSostituiscilo con il nome CodeCatalyst del tuo progetto.

    • repo_nameSostituiscilo con il nome CodeCatalyst del repository dei pacchetti.

    <mirrors> <mirror> <id>repo_name</id> <name>repo_name</name> <url>https://packages.region.codecatalyst.aws/maven/space_name/proj_name/repo_name/</url> <mirrorOf>*</mirrorOf> </mirror> </mirrors>
Importante

È possibile utilizzare qualsiasi valore nell'<id>elemento, ma deve essere lo stesso in entrambi <server> gli <repository> elementi. Ciò consente di includere le credenziali specificate nelle richieste di CodeCatalyst.

Dopo aver apportato queste modifiche alla configurazione, puoi creare il progetto.

mvn compile

Recupero di pacchetti da archivi di pacchetti esterni tramite CodeCatalyst

È possibile installare i pacchetti Maven dai repository pubblici tramite un CodeCatalyst repository configurandolo con una connessione upstream al gateway che rappresenta il repository del gateway. I pacchetti installati dal repository del gateway vengono inseriti e archiviati nel repository dell'utente. CodeCatalyst

Attualmente, CodeCatalyst supporta i seguenti archivi pubblici di pacchetti Maven.

  • maven-central-gateway

  • google-android-gateway

  • gradle-plugins-gateway

  • commonsware-gateway

Per installare pacchetti dagli archivi pubblici di pacchetti Maven
  1. Se non l'hai già fatto, esegui la configurazione mvn con il tuo repository di CodeCatalyst pacchetti seguendo i passaggi riportati di seguito. Recupero delle dipendenze da CodeCatalyst

  2. Assicurati che il tuo repository abbia aggiunto il repository gateway da cui desideri installare come connessione upstream. Per verificare quali sorgenti upstream vengono aggiunte o per aggiungere un repository gateway come sorgente upstream, segui le istruzioni riportate in. Aggiungere un repository upstream

Per ulteriori informazioni sulla richiesta di pacchetti dai repository upstream, consulta. Richiesta di una versione del pacchetto con repository upstream

Pubblicazione di pacchetti su CodeCatalyst

Per pubblicare un pacchetto Maven in un CodeCatalyst repository, devi anche modificare ~/.m2/settings.xml e progettare POM. mvn

Da usare per mvn pubblicare pacchetti nel tuo repository di pacchetti CodeCatalyst
  1. Apri la CodeCatalyst console all'indirizzo https://codecatalyst.aws/.

  2. Nella pagina di panoramica del progetto, scegli Pacchetti.

  3. Scegli il tuo repository di pacchetti dall'elenco dei repository di pacchetti.

  4. Scegli Connect to repository.

  5. Nella finestra di dialogo Connect to repository, scegliete mvn dall'elenco dei client del gestore di pacchetti.

  6. Avrai bisogno di un token di accesso personale (PAT) con cui autenticarti. mvn CodeCatalyst Se ne hai già uno, puoi usarlo. In caso contrario, puoi crearne uno qui.

    1. Scegli Crea token.

    2. Scegli Copia per copiare il tuo PAT.

      avvertimento

      Non potrai più vedere o copiare il tuo PAT dopo aver chiuso la finestra di dialogo.

  7. Configura una variabile di ambiente sul tuo computer locale con il tuo PAT. Utilizzerai questa variabile di ambiente nel tuo setting.xml file.

    export CODECATALYST_ARTIFACTS_TOKEN=your_PAT
  8. Aggiungi una <servers> sezione a settings.xml con un riferimento alla variabile di CodeCatalyst_ARTIFACTS_TOKEN ambiente in modo che Maven passi il token nelle richieste HTTP.

    <settings> ... <servers> <server> <id>repo-name</id> <username>username</username> <password>${env.CodeCatalyst_ARTIFACTS_TOKEN}</password> </server> </servers> ... </settings>
  9. Aggiungi una <distributionManagement> sezione a quella del tuo progetto. pom.xml

    <project> ... <distributionManagement> <repository> <id>repo_name</id> <name>repo_name</name> <url>https://packages.region.codecatalyst.aws/maven/space_name/proj_name/repo_name/</url> </repository> </distributionManagement> ... </project>

Dopo aver apportato queste modifiche alla configurazione, puoi creare il progetto e pubblicarlo nel repository specificato.

mvn deploy

È possibile accedere all'archivio dei pacchetti nella CodeCatalyst console per verificare che il pacchetto sia stato pubblicato correttamente.

Pubblicazione di pacchetti di terze parti

Puoi pubblicare pacchetti Maven di terze parti in un CodeCatalyst repository con. mvn deploy:deploy-file Questo può essere utile per gli utenti che desiderano pubblicare pacchetti e dispongono solo di file JAR e non hanno accesso al codice sorgente del pacchetto o ai file POM.

Il mvn deploy:deploy-file comando genererà un file POM basato sulle informazioni passate nella riga di comando.

Innanzitutto, crea un PAT se non ne hai uno.

Per creare un token di accesso personale (PAT)
  1. Nella barra dei menu in alto, scegli il badge del tuo profilo, quindi scegli Le mie impostazioni.

    Suggerimento

    Puoi anche trovare il tuo profilo utente accedendo alla pagina dei membri relativa a un progetto o a uno spazio e scegliendo il tuo nome dall'elenco dei membri.

  2. Nel nome PAT, inserisci un nome descrittivo per il tuo PAT.

  3. In Data di scadenza, lascia la data predefinita o scegli l'icona del calendario per selezionare una data personalizzata. La data di scadenza predefinita è un anno dalla data corrente.

  4. Scegli Create (Crea) .

    Puoi anche creare questo token quando scegli Clone repository come repository di origine.

  5. Salva il segreto PAT in un luogo sicuro.

    Importante

    Il segreto PAT viene visualizzato solo una volta. Non è possibile recuperarlo dopo aver chiuso la finestra.

Per pubblicare pacchetti Maven di terze parti
  1. Crea un ~/.m2/settings.xml file con i seguenti contenuti:

    <settings> <servers> <server> <id>repo_name</id> <username>username</username> <password>PAT}</password> </server> </servers> </settings>
  2. Eseguire il comando mvn deploy:deploy-file:

    mvn deploy:deploy-file -DgroupId=commons-cli \ -DartifactId=commons-cli \ -Dversion=1.4 \ -Dfile=./commons-cli-1.4.jar \ -Dpackaging=jar \ -DrepositoryId=repo-name \ -Durl=https://packages.region.codecatalyst.aws/maven/space-name/proj-name/repo-name/
    Nota

    L'esempio precedente pubblicacommons-cli 1.4. Modifica gli argomenti GroupiD, artifactID, version e file per pubblicare un JAR diverso.

Queste istruzioni si basano su esempi contenuti nella Guida alla distribuzione di terze parti in un repository remoto tratti dalla documentazione di JARs Apache Maven.

Per ulteriori informazioni, consulta questi argomenti sul sito Web del progetto Apache Maven: