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:
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.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Attiva l'API Artifact Registry.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Attiva l'API Artifact Registry.
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.
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.
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 suquickstart-java-repo
e la posizione predefinita suus-central1
. Dopo aver impostato i valori, non è necessario specificarli nei comandigcloud
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 repositoryquickstart-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 filebuild.gradle
.La sezione
publications
è un elemento figlio dipublishing
, 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
osettings
. Per maggiori dettagli su queste opzioni, vedi Configurazione dell'autenticazione.Carica un pacchetto nel repository
Per Maven, puoi utilizzare
mvn deploy
emvn release
per aggiungere pacchetti al repository.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
Apri la pagina Repositories nella console Google Cloud.
Nell'elenco dei repository, fai clic sul repository
quickstart-java-repo
.Nella pagina Pacchetti sono elencati i pacchetti nel repository.
gcloud
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 pacchettoPer 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.
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.