Configurazione e utilizzo di mvn - Amazon CodeCatalyst
Recupero delle dipendenze da CodeCatalystRecupero di pacchetti da archivi di pacchetti esterni tramite CodeCatalystPubblicazione di pacchetti su CodeCatalystPubblicazione di pacchetti di terze parti

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 () del tuo progetto. POM Il POM file 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 mvn le 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. Avrete bisogno di un token di accesso personale (PAT) con cui mvn autenticarvi. 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 tuoPAT.

      avvertimento

      Non potrai PAT più vedere o copiare i tuoi dati 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.

    • Replace (Sostituisci) space_name con il nome del tuo CodeCatalyst spazio.

    • Replace (Sostituisci) proj_name con il nome CodeCatalyst del tuo progetto.

    • Replace (Sostituisci) repo_name con il nome CodeCatalyst del repository del pacchetto.

    <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 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.

    • Replace (Sostituisci) repo_name con il nome CodeCatalyst del repository dei pacchetti.

    • Replace (Sostituisci) username con il tuo nome CodeCatalyst utente.

    • Replace (Sostituisci) PAT con il tuo CodeCatalystPAT.

    <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 tuo 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.

    • Replace (Sostituisci) space_name con il nome del tuo CodeCatalyst spazio.

    • Replace (Sostituisci) proj_name con il nome CodeCatalyst del tuo progetto.

    • Replace (Sostituisci) repo_name con il nome CodeCatalyst del repository del pacchetto.

    <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 mvn in un CodeCatalyst repository, devi anche modificare ~/.m2/settings.xml il progetto. POM

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. Avrete bisogno di un token di accesso personale (PAT) con cui mvn autenticarvi. 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 tuoPAT.

      avvertimento

      Non potrai PAT più vedere o copiare i tuoi dati dopo aver chiuso la finestra di dialogo.

  7. Configura una variabile di ambiente sul tuo computer locale con il tuoPAT. 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 HTTP richieste.

    <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 JAR file e non hanno accesso al codice sorgente o ai file del pacchetto. POM

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

Innanzitutto, creane uno 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 campo PATNome, inserisci un nome descrittivo per il tuoPAT.

  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 PAT segreto in un luogo sicuro.

    Importante

    Il PAT segreto 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. Modificate gli groupId argomenti ArtifactID, version e file per pubblicarne uno diverso. JAR

Queste istruzioni si basano su esempi contenuti nella Guida alla distribuzione di archivi di terze parti su archivi remoti tratti dalla JARs documentazione di Apache Maven.

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