Se usó la API de Cloud Translation para traducir esta página.

Almacena paquetes de Java en Artifact Registry

En esta guía de inicio rápido, se muestra cómo configurar un repositorio privado de Maven de Artifact Registry y cómo subir un paquete a él.

Para seguir la guía paso a paso sobre esta tarea directamente en la consola Google Cloud , haz clic en Guiarme:

GUIARME

Antes de comenzar

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.

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

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Artifact Registry API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

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

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Artifact Registry API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

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 enGoogle Cloud.

Cloud Shell ya viene instalado en Google Cloud CLI y Java. Gcloud CLI proporciona la interfaz de línea de comandos principal para Google Cloud.

Iniciar Cloud Shell:

Ve a la consola de Google Cloud .

Google Cloud console
En la barra de herramientas de la consola 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 .

Abrir la página repositorios
Haz clic en Crear repositorio.
Especifica quickstart-java-repo como el nombre del repositorio.
Elige Maven como formato y Estándar como 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ón us-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 desees usar.

Si no tienes un proyecto simple disponible, puedes crear el proyecto de Maven en 5 minutos.

En esta guía de inicio rápido, se supone que tu proyecto simple no tiene dependencias adicionales de complementos o elementos superiores almacenadas en Artifact Registry. Para obtener detalles sobre cómo configurar un proyecto de Maven con dependencias en Artifact Registry, consulta Cómo autenticarse con un auxiliar de credenciales.
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.

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.5</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 del 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>

Ahora tu proyecto de Maven 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 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.5"
      }

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 sección de publicaciones. 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.

Nota: El comando mvn archetype no es compatible si se usa exclusivamente desde el repositorio de Artifact Registry.

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

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

Abrir la página repositorios
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.

Almacena paquetes de Java en Artifact Registry

Antes de comenzar

Inicia Cloud Shell

Crea un repositorio de paquetes de Java

Console

gcloud

Configura Maven

Configura Gradle

Sube un paquete al repositorio

Visualiza el paquete en el repositorio

Console

gcloud

Limpia

Console

gcloud

¿Qué sigue?