Archiviare pacchetti Java in Artifact Registry

Questa guida rapida mostra come configurare un repository Maven privato di Artifact Registry e caricarvi un pacchetto.

Per seguire le indicazioni dettagliate per questa attività direttamente nella console Google Cloud, fai clic su Aiuto:

Aiuto

Prima di iniziare

Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

Vai al selettore progetti

Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

Attiva l'API Artifact Registry.

Abilita l'API

Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

Vai al selettore progetti

Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

Attiva l'API Artifact Registry.

Abilita l'API

Avvia Cloud Shell

In questa guida rapida, utilizzerai Cloud Shell, un ambiente shell per la gestione delle risorse ospitate su Google Cloud.

In Cloud Shell sono preinstallati Google Cloud CLI e Java. gcloud CLI fornisce la principale interfaccia a riga di comando per Google Cloud.

Avvia Cloud Shell:

Vai alla console Google Cloud.

Console Google Cloud
Nella barra degli strumenti della console Google Cloud, fai clic su Attiva Cloud Shell:

Si apre una sessione di Cloud Shell all'interno di un frame più in basso nella console. Puoi utilizzare questa shell per eseguire i comandi gcloud.

Crea un repository di pacchetti Java

Crea il repository per gli artefatti Java.

Crea il repository:

Console

Apri la pagina Repositories nella console Google Cloud.

Apri la pagina Repository
Fai clic su Crea repository.
Specifica quickstart-java-repo come nome del repository.
Scegli Maven come formato e Standard come modalità.
In Tipo di località, seleziona Regione e poi scegli la località us-central1.
Fai clic su Crea.

Il repository viene aggiunto all'elenco dei repository.

gcloud

Esegui il comando seguente per creare un nuovo repository di pacchetti Java nel progetto corrente denominato quickstart-java-repo nella località us-central1.
```
gcloud artifacts repositories create quickstart-java-repo --repository-format=maven \
--location=us-central1 --description="Java package repository"
```
Esegui questo comando per verificare che il repository sia stato creato:
```
gcloud artifacts repositories list
```
Per ulteriori informazioni sui comandi di Artifact Registry, esegui il comando gcloud artifacts.

Configura Maven

Scegli un progetto Maven semplice da utilizzare.

Se non è disponibile un progetto semplice, puoi creare il progetto Maven in 5 minuti.

Questa guida rapida presuppone che il progetto semplice non abbia dipendenze principali o plug-in aggiuntive archiviate in Artifact Registry. Per maggiori dettagli sulla configurazione di un progetto Maven con dipendenze in Artifact Registry, consulta Autenticazione con un helper per le credenziali.
Per semplificare i comandi gcloud, imposta il repository predefinito su quickstart-java-repo e la posizione predefinita su us-central1. Dopo aver impostato i valori, non è necessario specificarli nei comandi gcloud che richiedono un repository o una posizione.

Per impostare il repository, esegui il comando:
```
gcloud config set artifacts/repository quickstart-java-repo
```
Per impostare la località, esegui il comando:
```
gcloud config set artifacts/location us-central1
```
Per ulteriori informazioni su questi comandi, consulta la documentazione di gcloud config set.

Esegui questo comando per stampare le impostazioni del repository quickstart-java-repo predefinito.

gcloud artifacts print-settings mvn

L'output del comando gcloud è simile al seguente snippet, dove PROJECT è l'ID progetto.

<distributionManagement>
  <snapshotRepository>
    <id>artifact-registry</id>
    <url>artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-java-repo</url>
  </snapshotRepository>
  <repository>
    <id>artifact-registry</id>
    <url>artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-java-repo</url>
  </repository>
</distributionManagement>

<repositories>
  <repository>
    <id>artifact-registry</id>
    <url>artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-java-repo</url>
    <releases>
      <enabled>true</enabled>
    </releases>
    <snapshots>
      <enabled>true</enabled>
    </snapshots>
  </repository>
</repositories>

<build>
  <extensions>
    <extension>
      <groupId>com.google.cloud.artifactregistry</groupId>
      <artifactId>artifactregistry-maven-wagon</artifactId>
      <version>2.2.1</version>
    </extension>
  </extensions>
</build>

Aggiungi le impostazioni al file pom.xml per il tuo progetto Maven. Il seguente schema mostra il posizionamento relativo di ogni elemento principale. Consulta il riferimento POM di Maven per i dettagli sulla struttura del file.

<project xmlns="http://maven.apache.org/POM/4.0.0"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
                      http://maven.apache.org/xsd/maven-4.0.0.xsd">

  <!-- Build Settings -->
  <build>
    ...
    <extensions>...</extensions>
  </build>

  <!-- Environment Settings -->
  <repositories>...</repositories>
  <distributionManagement>...</distributionManagement>
</project>

Ora il tuo progetto Maven può caricare pacchetti nel tuo repository.

Configura Gradle

Crea un progetto Gradle semplice per eseguire il deployment di un pacchetto nel repository Artifact Registry che hai creato. Se non hai una build Gradle di test, puoi seguire il tutorial introduttivo per creare una build Gradle semplice.

Per semplificare i comandi gcloud, imposta il repository predefinito su quickstart-java-repo e la posizione predefinita su us-central1. Dopo aver impostato i valori, non è necessario specificarli nei comandi gcloud che richiedono un repository o una posizione.

Per impostare il repository, esegui il comando:

gcloud config set artifacts/repository quickstart-java-repo

Per impostare la località, esegui il comando:

gcloud config set artifacts/location us-central1

Per ulteriori informazioni su questi comandi, consulta la documentazione di gcloud config set.

Aggiungi le impostazioni per connettere il repository al file build.gradle. Il seguente comando stampa le impostazioni da aggiungere per il repository quickstart-java-repo predefinito.

gcloud artifacts print-settings gradle

L'output del comando gcloud è simile all'esempio seguente, dove PROJECT è l'ID progetto.

plugins {
  id "maven-publish"
  id "com.google.cloud.artifactregistry.gradle-plugin" version "2.2.1"
      }

publishing {
  repositories {
    maven {
      url "artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-java-repo"
    }
  }
}

repositories {
  maven {
    url "artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-java-repo"
  }
}

Verifica che il file build.gradle includa una sezione pubblicazioni. Se non ce l'ha, aggiungila al file build.gradle.

La sezione publications è un elemento figlio di publishing, come mostrato nell'esempio seguente:
```
publishing {
  publications {
       mavenJava(MavenPublication) {
          groupId  'maven.example.id'
          from components.java
       }
  }
  repositories {
    maven {
      url "artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-java-repo"
    }
  }
}
```
Puoi anche aggiungere la configurazione del repository ai tuoi file init.gradle o settings. Per maggiori dettagli su queste opzioni, vedi Configurazione dell'autenticazione.

Carica un pacchetto nel repository

Per Maven, puoi utilizzare mvn deploy e mvn release per aggiungere pacchetti al repository.

Nota: il comando mvn archetype non è supportato se utilizzato esclusivamente dal repository di Artifact Registry.

Per Gradle, utilizza il comando gradle publish per caricare un pacchetto nel repository.
Visualizza il pacchetto nel repository
Per verificare che il pacchetto sia stato aggiunto al repository:
Console
1. Apri la pagina Repositories nella console Google Cloud.
  
  Apri la pagina Repository
2. Nell'elenco dei repository, fai clic sul repository quickstart-java-repo.
  
  Nella pagina Pacchetti sono elencati i pacchetti nel repository.
gcloud
1. Per elencare i pacchetti nel repository quickstart-java-repo, esegui il comando seguente:
```
gcloud artifacts packages list --repository=quickstart-java-repo
```
  L'output sarà simile al seguente:
```
Listing items under project <project-id>, location us-central1,\
repository quickstart-java-repo.

PACKAGE: maven.example.id:gradle-demo
CREATE_TIME: 2022-01-20T22:46:07
UPDATE_TIME: 2022-01-20T22:46:07
```
  Dove maven.example.id:gradle-demo è l'ID pacchetto
  
  Per visualizzare le versioni di un pacchetto, esegui questo comando:
```
gcloud artifacts versions list --package=PACKAGE
```
  Dove PACKAGE è l'ID pacchetto.

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi.

Prima di rimuovere il repository, assicurati che tutti i pacchetti che vuoi conservare siano disponibili in un'altra posizione.

Per eliminare il repository:

Console

Apri la pagina Repositories nella console Google Cloud.

Apri la pagina Repository
Nell'elenco dei repository, seleziona il repository quickstart-java-repo.
Fai clic su Elimina.

gcloud

Per eliminare il repository quickstart-java-repo, esegui questo comando:
```
gcloud artifacts repositories delete quickstart-java-repo
```
Se vuoi rimuovere il repository predefinito e le impostazioni di posizione configurate per la configurazione gcloud attiva, esegui i comandi seguenti:
```
gcloud config unset artifacts/repository
gcloud config unset artifacts/location
```

Passaggi successivi

Scopri di più sulla configurazione dell'autenticazione
Scopri di più sulla gestione dei repository
Scopri di più sulla gestione dei pacchetti
Leggi le nostre risorse su DevOps ed esplora il nostro programma di ricerca.

Archiviare pacchetti Java in Artifact Registry

Prima di iniziare

Avvia Cloud Shell

Crea un repository di pacchetti Java

Console

gcloud

Configura Maven

Configura Gradle

Carica un pacchetto nel repository

Visualizza il pacchetto nel repository

Console

gcloud

Esegui la pulizia

Console

gcloud

Passaggi successivi