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. 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.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

  4. Enable the Artifact Registry API.

    Enable the API

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

    Go to project selector

  6. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

  7. Enable the Artifact Registry API.

    Enable the 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:

  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?