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:

GUIARME

Antes de comenzar

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Artifact Registry API.

    Enable the API

    5.

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Artifact Registry API.

    Enable the API

    8.

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:

  1. Ve a la consola de Google Cloud.

    Consola de Google Cloud

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

  1. Crea el repositorio:

Console

  1. Abre la página Repositorios en la consola de Google Cloud.

    Abrir la página Repositorios

  2. Haz clic en Crear repositorio.

  3. Especifica quickstart-java-repo como el nombre del repositorio.

  4. Elige Maven como el formato y Standard como el modo.

  5. En Tipo de ubicación, selecciona Región y, luego, elige la ubicación us-central1.

  6. Haga clic en Crear.

    El repositorio se agrega a la lista de repositorios.

gcloud

  1. Ejecuta el siguiente comando para crear un nuevo repositorio de paquetes de Java en el proyecto actual llamado quickstart-java-repo en la ubicación us-central1.

    gcloud artifacts repositories create quickstart-java-repo --repository-format=maven \
--location=us-central1 --description="Java package repository"

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

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

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

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

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

  1. 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 repositorio quickstart-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"
  }
}

  2. Verifica que el archivo build.gradle incluya una publicaciones. sección. Si no es así, agrégala a tu archivo build.gradle.

    La sección de publications es un elemento secundario de publishing, 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 o settings. Para obtener detalles sobre estas opciones, consulta Configura la autenticación.

    Sube un paquete al repositorio

    En Maven, puedes usar mvn deploy y mvn 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

    1. Abre la página Repositorios en la consola de Google Cloud.

      Abrir la página Repositorios

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

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

  1. Abre la página Repositorios en la consola de Google Cloud.

    Abrir la página repositorios

  2. En la lista de repositorios, selecciona el repositorio quickstart-java-repo.

  3. Haz clic en Borrar.

gcloud

  1. Para borrar el repositorio quickstart-java-repo, ejecuta el siguiente comando:

    gcloud artifacts repositories delete quickstart-java-repo

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