Amazon non CodeCatalyst è più aperta a nuovi clienti. I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta [Come migrare da CodeCatalyst](migration.md).

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
<a name="packages-maven-mvn"></a>

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.

**Contents**
+ [Recupero delle dipendenze da CodeCatalyst](#mvn-fetch-dependencies)
+ [Recupero di pacchetti da archivi di pacchetti esterni tramite CodeCatalyst](#mvn-install-public)
+ [Pubblicazione di pacchetti su CodeCatalyst](#mvn-publish-packages)
+ [Pubblicazione di pacchetti di terze parti](#publishing-third-party-packages)

## Recupero delle dipendenze da CodeCatalyst
<a name="mvn-fetch-dependencies"></a>

`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**

1. [Apri la CodeCatalyst console all'indirizzo https://codecatalyst.aws/.](https://codecatalyst.aws/)

1. Nella pagina di panoramica del progetto, scegli **Pacchetti**.

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

1. Scegli **Connect to repository.**

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

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

   1. Scegli **Copia** per copiare il tuo PAT.
**avvertimento**  
Non potrai più vedere o copiare il tuo PAT dopo aver chiuso la finestra di dialogo.

1. 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\$1name*Sostituiscili con il nome CodeCatalyst dello spazio.
   + *proj\$1name*Sostituiscilo con il nome CodeCatalyst del tuo progetto.
   + *repo\$1name*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>
   ```

1. 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\$1name*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>
   ```

1. (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\$1name*Sostituiscili con il nome CodeCatalyst dello spazio.
   + *proj\$1name*Sostituiscilo con il nome CodeCatalyst del tuo progetto.
   + *repo\$1name*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
<a name="mvn-install-public"></a>

È 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](#mvn-fetch-dependencies)

1. 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. [Aggiunta di un repository upstream](packages-upstream-repositories-add.md)

Per ulteriori informazioni sulla richiesta di pacchetti dai repository upstream, consulta. [Richiesta di una versione del pacchetto con repository upstream](packages-upstream-repositories-request.md)

## Pubblicazione di pacchetti su CodeCatalyst
<a name="mvn-publish-packages"></a>

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/](https://codecatalyst.aws/).

1. Nella pagina di panoramica del progetto, scegli **Pacchetti**.

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

1. Scegli **Connect to repository.**

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

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

   1. Scegli **Copia** per copiare il tuo PAT.
**avvertimento**  
Non potrai più vedere o copiare il tuo PAT dopo aver chiuso la finestra di dialogo.

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

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

1. 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
<a name="publishing-third-party-packages"></a>

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.

1. Nel nome **PAT, inserisci un nome** descrittivo per il tuo PAT.

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

1. Scegli **Create** (Crea).

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

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

1. 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](https://maven.apache.org/guides/mini/guide-3rd-party-jars-remote.html) Maven.* 

 Per ulteriori informazioni, consulta questi argomenti sul sito Web del progetto Apache Maven:
+  [Configurazione di più repository](https://maven.apache.org/guides/mini/guide-multiple-repositories.html) 
+  [Riferimento alle impostazioni](https://maven.apache.org/settings.html) 
+  [Gestione della distribuzione](https://maven.apache.org/pom.html#Distribution_Management) 
+  [Profili](https://maven.apache.org/pom.html#Profiles)