Guía de inicio rápido para Java

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

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. En la página del selector de proyectos de Google Cloud Console, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  3. Comprueba que la facturación esté habilitada en tu proyecto.

    Descubre cómo puedes habilitar la facturación

  4. Habilita la API Artifact Registry.

    Habilita la API

  5. Instala e inicializa el SDK de Cloud.
  6. En la página del selector de proyectos de Google Cloud Console, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  7. Comprueba que la facturación esté habilitada en tu proyecto.

    Descubre cómo puedes habilitar la facturación

  8. Habilita la API Artifact Registry.

    Habilita la API

  9. Instala e inicializa el SDK de Cloud.

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

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

    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:

      Lista de repositorios de los artefactos de gcloud

    Para obtener más información sobre los comandos de Artifact Registry, ejecuta el comando gcloud artifacts.

  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.

Configura una cuenta de servicio para tu cliente

  1. Crea una cuenta de servicio que actúe en nombre de tu aplicación o elige una cuenta de servicio existente que uses para la automatización.

    Necesitarás la ubicación del archivo de claves de la cuenta de servicio para configurar la autenticación con Artifact Registry. En las cuentas existentes, puedes ver claves y crear claves nuevas en la página Cuentas de servicio.

    Ir a la página Cuentas de servicio

  2. Otorga a la cuenta de servicio acceso de lectura y escritura a tu repositorio.

    gcloud artifacts repositories add-iam-policy-binding \
    quickstart-java-repo --location=us-central1 --member=serviceAccount:ACCOUNT --role=roles/artifactregistry.writer
    

    En el ejemplo anterior, ACCOUNT es el ID de tu cuenta de servicio con el formato USERNAME@PROJECT-ID.iam.gserviceaccount.com.

  3. Asigna la ubicación del archivo de claves de la cuenta de servicio a la variable GOOGLE_APPLICATION_CREDENTIALS para que el auxiliar de credenciales de Artifact Registry pueda obtener tu clave cuando se conecta con repositorios.

    export GOOGLE_APPLICATION_CREDENTIALS=KEY-FILE
    

    En el ejemplo anterior, KEY-FILE es la ruta de acceso al archivo de claves de la cuenta de servicio.

    Para obtener información sobre cómo configurar la autenticación de la contraseña mediante el archivo de claves de la cuenta de servicio, consulta la documentación de authentication#auth-password.

Configura Maven

  1. Elige un proyecto de Maven simple que quieras 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 superior ni de complemento almacenadas en Artifact Registry. Para obtener detalles sobre cómo configurar un proyecto de Maven con dependencias en Artifact Registry, consulta Autentica con un asistente de credenciales.

  2. 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.1.4</version>
        </extension>
      </extensions>
    </build>
    
  3. 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 gerente de Operaciones con Socios 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

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

  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. Agrega la configuración para conectarte al repositorio del 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.1.4"
    }
    
    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"
      }
    }
    
  4. Verifica que el archivo build.gradle incluya una sección de publicaciones. 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 Cloud Console.

    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

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

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

    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?