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.
Indice
Recupero delle dipendenze da CodeCatalyst
mvn
Per 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
-
Apri la CodeCatalyst console all'indirizzo https://codecatalyst.aws/.
-
Nella pagina di panoramica del progetto, scegli Pacchetti.
-
Scegli il tuo repository di pacchetti dall'elenco dei repository di pacchetti.
-
Scegli Connect to repository.
-
Nella finestra di dialogo Connect to repository, scegliete mvn dall'elenco dei client del gestore di pacchetti.
-
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.-
Scegli Crea token.
-
Scegli Copia per copiare il tuo PAT.
avvertimento
Non potrai più vedere o copiare il tuo PAT dopo aver chiuso la finestra di dialogo.
-
-
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_name
Sostituiscili con il nome CodeCatalyst dello spazio. -
proj_name
Sostituiscilo con il nome CodeCatalyst del tuo progetto. -
repo_name
Sostituiscilo 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> -
-
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_name
Sostituiteli con il nome CodeCatalyst del repository dei pacchetti. -
Sostituisci
username
con il tuo nome CodeCatalyst utente. -
PAT
Sostituiscilo con il tuo CodeCatalyst PAT.
<servers> <server> <id>
repo_name
</id> <username>username
</username> <password>PAT
</password> </server> </servers> -
-
(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_name
Sostituiscili con il nome CodeCatalyst dello spazio. -
proj_name
Sostituiscilo con il nome CodeCatalyst del tuo progetto. -
repo_name
Sostituiscilo 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
-
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 -
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
-
Apri la CodeCatalyst console all'indirizzo https://codecatalyst.aws/
. -
Nella pagina di panoramica del progetto, scegli Pacchetti.
-
Scegli il tuo repository di pacchetti dall'elenco dei repository di pacchetti.
-
Scegli Connect to repository.
-
Nella finestra di dialogo Connect to repository, scegliete mvn dall'elenco dei client del gestore di pacchetti.
-
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.-
Scegli Crea token.
-
Scegli Copia per copiare il tuo PAT.
avvertimento
Non potrai più vedere o copiare il tuo PAT dopo aver chiuso la finestra di dialogo.
-
-
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
-
Aggiungi una
<servers>
sezione asettings.xml
con un riferimento alla variabile diCodeCatalyst_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> -
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)
-
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.
-
Nel nome PAT, inserisci un nome descrittivo per il tuo PAT.
-
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.
-
Scegli Create (Crea) .
Puoi anche creare questo token quando scegli Clone repository come repository di origine.
-
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
-
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> -
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 pubblica
commons-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
Per ulteriori informazioni, consulta questi argomenti sul sito Web del progetto Apache Maven: