Almacena paquetes de Java en Artifact Registry
En esta guía de inicio rápido, se muestra cómo configurar un repositorio de Maven de Artifact Registry privado y subir un paquete en este.
Para seguir la guía paso a paso en esta tarea directamente en la consola de Google Cloud, haz clic en Guiarme:
Antes de comenzar
- Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.
-
Enable the Artifact Registry API.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.
-
Enable the Artifact Registry API.
Inicia Cloud Shell
En esta guía de inicio rápido, usarás Cloud Shell, que es un entorno de shell para administrar recursos alojados en Google Cloud.Cloud Shell ya viene instalado en Google Cloud CLI y Java. La CLI de gcloud proporciona la interfaz de línea de comandos principal para Google Cloud.
Iniciar Cloud Shell:
Ve a la consola de Google Cloud.
En la barra de herramientas de la consola de Google Cloud, haz clic en Activar Cloud Shell:
Se abrirá una sesión de Cloud Shell dentro de un marco en la parte inferior en la consola.
Usa esta shell para ejecutar los comandos de gcloud
.
Crea un repositorio de paquetes de Java
Crea el repositorio para los artefactos de Java.- Crea el repositorio:
Console
Abre la página Repositorios en la consola de Google Cloud.
Haz clic en Crear repositorio.
Especifica
quickstart-java-repo
como el nombre del repositorio.Elige Maven como el formato y Standard como el modo.
En Tipo de ubicación, selecciona Región y, luego, elige la ubicación
us-central1
.Haga clic en Crear.
El repositorio se agrega a la lista de repositorios.
gcloud
Ejecuta el siguiente comando para crear un nuevo repositorio de paquetes de Java en el proyecto actual llamado
quickstart-java-repo
en la ubicaciónus-central1
.gcloud artifacts repositories create quickstart-java-repo --repository-format=maven \ --location=us-central1 --description="Java package repository"
Ejecuta el siguiente comando para verificar que se haya creado el repositorio:
gcloud artifacts repositories list
Para obtener más información sobre los comandos de Artifact Registry, ejecuta el comando
gcloud artifacts
.
Configura Maven
Elige un proyecto de Maven simple que quieras usar.
Si no cuentas con un proyecto simple disponible, puedes crear Maven en 5 minutos en un proyecto final.
En esta guía de inicio rápido, se da por sentado que tu proyecto simple no tiene permisos dependencias superiores o de complementos almacenadas en Artifact Registry. Más información sobre la configuración de un proyecto de Maven con dependencias en Artifact Registry, consulta Cómo realizar la autenticación con un auxiliar de credenciales.
Para simplificar los comandos de
gcloud
, configura el repositorio predeterminado comoquickstart-java-repo
y la ubicación predeterminada comous-central1
. Una vez configurados los valores, no necesitas especificarlos en los comandos degcloud
que requieren un repositorio o una ubicación.Para configurar el repositorio, ejecuta el siguiente comando:
gcloud config set artifacts/repository quickstart-java-repo
Para configurar la ubicación, ejecuta el siguiente comando:
gcloud config set artifacts/location us-central1
Para obtener más información sobre estos comandos, consulta la documentación de establecimiento de la configuración de gcloud.
Ejecuta el siguiente comando para imprimir la configuración del repositorio
quickstart-java-repo
predeterminado.gcloud artifacts print-settings mvn
El resultado del comando
gcloud
se ve como el siguiente fragmento, en el que PROJECT es el ID del proyecto.<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.3</version> </extension> </extensions> </build>
Agrega la configuración al archivo
pom.xml
en tu proyecto de Maven. En el siguiente esquema, se muestra la posición relativa de cada elemento principal. Consulta la referencia de POM de Maven. para obtener detalles sobre la estructura del archivo.<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>
Tu proyecto de Maven ahora puede subir paquetes a tu repositorio.
Configura Gradle
Crea un proyecto de Gradle simple para implementar un paquete en el repositorio de Artifact Registry que creaste. Si no tienes una compilación de Gradle de prueba, puedes seguir el instructivo de Gradle introductorio para crear una compilación simple de Gradle.Para simplificar los comandos de gcloud
, configura el repositorio predeterminado como quickstart-java-repo
y la ubicación predeterminada como us-central1
.
Una vez configurados los valores, no necesitas especificarlos en los comandos de gcloud
que requieren un repositorio o una ubicación.
Para configurar el repositorio, ejecuta el siguiente comando:
gcloud config set artifacts/repository quickstart-java-repo
Para configurar la ubicación, ejecuta el siguiente comando:
gcloud config set artifacts/location us-central1
Para obtener más información sobre estos comandos, consulta la documentación de establecimiento de la configuración de gcloud.
Agrega la configuración para conectar el repositorio al archivo
build.gradle
. Mediante el siguiente comando, se imprime la configuración que se agregará al repositorioquickstart-java-repo
predeterminado.gcloud artifacts print-settings gradle
El resultado del comando de
gcloud
se ve como el siguiente ejemplo, en el que PROJECT es el ID del proyecto.plugins { id "maven-publish" id "com.google.cloud.artifactregistry.gradle-plugin" version "2.2.3" } 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 que el archivo
build.gradle
incluya una publicaciones. sección. Si no es así, agrégala a tu archivobuild.gradle
.La sección de
publications
es un elemento secundario depublishing
, como se muestra en el siguiente ejemplo:publishing { publications { mavenJava(MavenPublication) { groupId 'maven.example.id' from components.java } } repositories { maven { url "artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-java-repo" } } }
También puedes agregar la configuración del repositorio a los archivos
init.gradle
osettings
. Para obtener detalles sobre estas opciones, consulta Configura la autenticación.Sube un paquete al repositorio
En Maven, puedes usar
mvn deploy
ymvn release
con el fin de agregar paquetes al repositorio.En Gradle, usa el comando
gradle publish
para subir un paquete al repositorio.Visualiza el paquete en el repositorio
Para verificar que tu paquete se haya agregado al repositorio, haz lo siguiente:Console
Abre la página Repositorios en la consola de Google Cloud.
En la lista de repositorios, haz clic en el repositorio
quickstart-java-repo
.En la página Paquetes, se enumeran los paquetes del repositorio.
gcloud
Para generar una lista de los paquetes en el repositorio
quickstart-java-repo
, ejecuta el siguiente comando:gcloud artifacts packages list --repository=quickstart-java-repo
El resultado será similar al siguiente ejemplo:
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
En el ejemplo anterior,
maven.example.id:gradle-demo
es el ID del paquete.Para ver las versiones de un paquete, ejecuta el siguiente comando:
gcloud artifacts versions list --package=PACKAGE
En el ejemplo anterior, PACKAGE es el ID del paquete.
Limpia
Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta página.
Antes de quitar el repositorio, asegúrate de que los paquetes que quieres conservar estén disponibles en otra ubicación.
Para borrar el repositorio, haz lo siguiente:
Console
Abre la página Repositorios en la consola de Google Cloud.
En la lista de repositorios, selecciona el repositorio
quickstart-java-repo
.Haz clic en Borrar.
gcloud
Para borrar el repositorio
quickstart-java-repo
, ejecuta el siguiente comando:gcloud artifacts repositories delete quickstart-java-repo
Si deseas quitar la configuración predeterminada de la ubicación y del repositorio que estableciste para la configuración activa de
gcloud
, ejecuta los siguientes comandos:gcloud config unset artifacts/repository gcloud config unset artifacts/location
¿Qué sigue?
- Obtén más información para configurar la autenticación.
- Obtén más información para administrar repositorios.
- Obtén más información para administrar paquetes.
- Lee nuestros recursos sobre DevOps y explora nuestro programa de investigación.