Artifact Registry admite paquetes de Java que puedes compilar con Maven y Gradle.
Descripción general
Para familiarizarte con los paquetes de Java en Artifact Registry, puedes probar la guía de inicio rápido.
Cuando estés listo para obtener más información, lee lo siguiente:
- Crea un repositorio de paquetes de Java para tus paquetes.
- Obtén información para crear repositorios remotos y virtuales.
- Obtén información sobre cómo se pueden usar los repositorios remotos y virtuales en este ejemplo de uso de repositorios.
- Otorga permisos a la cuenta que se conectará con el repositorio. Las cuentas de servicio para las integraciones comunes con Artifact Registry tienen permisos predeterminados en los repositorios del mismo proyecto.
- Configura tus herramientas:
- Configura la autenticación para Maven o Gradle.
- Si deseas usar sbt como herramienta de compilación para Scala y Java en lugar de Maven o Gradle, hay un complemento de sbt creado por la comunidad disponible. Esta documentación no describe la configuración ni el uso de Clientes de Scala...
- Configura Cloud Build para subir y descargar paquetes.
- Obtén información para implementar en entornos de ejecución de Google Cloud.
- Obtén más información sobre cómo administrar paquetes
Versiones de actualización y de resumen de Maven
Maven distingue entre las versiones snapshot y release de tus proyectos de Maven.
Instantáneas
Un resumen es una versión previa al lanzamiento de un proyecto de Java. El número de versión
de una instantánea incluye el sufijo -SNAPSHOT
en el modelo de objetos del proyecto
(POM). Por ejemplo, este parámetro de configuración en el archivo pom.xml
es para una versión 1.0
del proyecto que está en desarrollo:
<version>1.0-SNAPSHOT</version>
Cuando publicas un paquete desde este proyecto, Maven 3 agrega automáticamente una marca de tiempo al número de versión de la instantánea para que cada versión únicos. Maven 2 admite versiones de instantáneas no únicas como un medio para reemplazar las instantáneas existentes en un repositorio. Este enfoque es problemático para la reproducibilidad de las compilaciones, por lo que Maven 3 ya no admite instantáneas no únicas.
Las instantáneas ofrecen una forma de publicar iterativamente versiones actualizadas de un
paquete previo al lanzamiento sin aumentar el número de versión en tu Maven
cada vez que publicas contenido en el repositorio. Durante el desarrollo, otros proyectos con dependencias en el paquete pueden obtener la instantánea más reciente de la versión 1.0
del repositorio.
Consulta especificación de orden de versiones para obtener detalles sobre la sintaxis del número de versión de Maven y el orden de clasificación.
Versiones
Cuando esté todo listo para liberar un paquete, quita el sufijo -SNAPSHOT
.
del número de versión en el archivo POM y actualizar los proyectos que dependan de
del paquete para que usen la versión de actualización en lugar de la instantánea
versión.
Para enumerar todas las dependencias de instantáneas, puedes filtrar el árbol de dependencias con el siguiente comando:
mvn dependency:tree -Dincludes=:::*-SNAPSHOT
Política de versiones de Artifact Registry
Cuando creas un repositorio de Maven en Artifact Registry, puedes especificar una política de versión de Maven:
- Ninguno: Almacena paquetes de instantáneas y de lanzamiento. Esta es la configuración predeterminada.
- Instantánea: almacena solo paquetes de instantáneas.
- Lanzamiento: Solo almacena paquetes de lanzamiento.
Si eliges la política de versiones de instantáneas, también puedes especificar si el repositorio permite versiones de instantáneas no únicas que reemplacen versiones coincidentes en el repositorio. Recomendamos usar versiones únicas, ya que Maven 3 no admiten el modelo de versión no único.