En esta página, se explica cómo administrar módulos de Go empaquetados y almacenados en Artifact Registry.
Antes de comenzar
- Si el repositorio de destino no existe, crea un repositorio nuevo. Elige Go como el formato del repositorio.
- Verifica que tengas los permisos necesarios para el repositorio.
- (Opcional) Configura valores predeterminados para los comandos de gcloud.
- Instala Go 1.15 o una versión posterior.
Instala el complemento package-go-module de gcloud CLI:
gcloud components install package-go-module
Configura Go para autenticar con Artifact Registry.
Funciones requeridas
Si deseas obtener los permisos que necesitas para administrar los módulos, solicita a tu administrador que te otorgue los siguientes roles de IAM en el repositorio:
-
Ver módulos:
Lector de Artifact Registry (
roles/artifactregistry.reader
) -
Descarga o instala módulos:
Lector de Artifact Registry (
roles/artifactregistry.reader
) -
Agrega módulos a un repositorio:
Escritor de Artifact Registry (
roles/artifactregistry.writer
) -
Borrar módulos:
Administrador del repositorio de Artifact Registry (
roles/artifactregistry.repoAdmin
)
Si quieres obtener más información para otorgar roles, consulta Administra el acceso.
Es posible que también puedas obtener los permisos necesarios a través de funciones personalizadas o, también, otras funciones predefinidas.
Subir un módulo
Modos de repositorio: Estándar
Para empaquetar y subir un módulo a tu repositorio, ejecuta el siguiente comando:
gcloud artifacts go upload --project=PROJECT \ --repository=REPOSITORY \ --location=LOCATION \ --module-path=MODULE_PATH \ --version=VERSION \ --source=SOURCE_LOCATION
Reemplaza lo siguiente:
- PROJECT por el ID del proyecto de Google Cloud.
- REPOSITORY por el nombre del repositorio en el que se almacena el paquete
- LOCATION por la ubicación regional o multirregional del repositorio
- MODULE_PATH por la ruta del módulo Por ejemplo:
example.com/foo
. Consulta la referencia de los módulos de Go para obtener más información. - VERSION por la versión semántica del módulo en el formato
vX.Y.Z
, en el queX
es la versión principal,Y
es la versión secundaria yZ
es la versión del parche. - SOURCE_LOCATION por la ruta de acceso al directorio raíz de tu módulo de Go Si omites la marca
--source
, el valor predeterminado será el directorio actual.
El módulo se sube a Artifact Registry.
Para obtener más información sobre la creación de módulos de Go, consulta este instructivo.
Subir una nueva versión del módulo
Modos de repositorio: Estándar
Para subir una versión nueva del módulo al proyecto, el repositorio y la ubicación predeterminados cuando se configuran los valores predeterminados, ejecuta el siguiente comando con el número de versión nuevo:
gcloud artifacts go upload \ --module-path=MODULE_PATH \ --version=VERSION \ --source=SOURCE_LOCATION
Reemplaza VERSION por la versión del módulo actualizado. Por ejemplo,
para subir la versión 0.1.1
de un módulo con la ruta de acceso example.com/foo
, ejecuta el
siguiente comando:
gcloud artifacts go upload \ --module-path=example.com/foo \ --version=v0.1.1 \ --source=SOURCE_LOCATION
Para marcar un módulo como versión previa al lanzamiento, agrega un guion después de VERSION y agrega los identificadores previos al lanzamiento de tu módulo:
gcloud artifacts go upload \ --module-path=MODULE_PATH \ --version=VERSION-PRE_RELEASE_IDENTIFIERS \ --source=SOURCE_LOCATION
Reemplaza PRE_RELEASE_IDENTIFIERS por guiones y caracteres alfanuméricos ASCII separados por puntos. Por ejemplo, para subir un lanzamiento previo de un módulo con la ruta de acceso example.com/foo
del módulo identificado por alpha.x.12m.5
, ejecuta el siguiente comando:
gcloud artifacts go upload \ --module-path=example.com/foo \ --version=v1.0.0-alpha.x.12m.5 \ --source=SOURCE_LOCATION
Sube una nueva versión principal
Modos de repositorio: Estándar
Las versiones principales no son retrocompatibles con versiones anteriores. Para evitar que los usuarios importen un cambio rotundo, las versiones principales posteriores a v1
deben tener rutas de módulo diferentes a las de las versiones anteriores. A partir de v2
, la versión principal se agrega al final de la ruta del módulo.
Por ejemplo, la ruta del módulo para v2.0.0
de example.com/foo
sería example.com/foo/v2
.
Se recomienda desarrollar versiones principales después de v1
en directorios independientes que lleven el nombre de su sufijo de versión principal.
Para subir una nueva versión principal 2.0.0
de un módulo con la ruta de acceso example.com/foo
al proyecto, el repositorio y la ubicación predeterminados cuando se configuran los valores predeterminados, haz lo siguiente:
gcloud artifacts go upload --module-path=example.com/foo/v2 --version=v2.0.0
Enumerar módulos
Modos de repositorio: Estándar
Ejecuta el siguiente comando para inspeccionar un módulo de Go subido en el proyecto, el repositorio y la ubicación predeterminados cuando se configuren los valores predeterminados:
gcloud artifacts packages list
El resultado será similar al siguiente:
Listing items under project my-project, location us-west1, repository my-repo. PACKAGE CREATE_TIME UPDATE_TIME example.com/foo 2022-06-03T20:43:39 2022-06-20T20:37:40
Ver detalles de la versión del módulo
Modos de repositorio: Estándar
Ejecuta el siguiente comando para ver las versiones de un módulo en la ubicación, el repositorio y el proyecto predeterminados cuando se configuren los valores predeterminados:
gcloud artifacts versions list --package=MODULE_PATH
El resultado será similar al siguiente:
Listing items under project my-project, location us-west1, repository my-repo, package example.com/foo. VERSION DESCRIPTION CREATE_TIME UPDATE_TIME v0.1.0 2022-06-03T20:43:39 2022-06-03T20:43:39 v0.1.1 2022-06-20T20:37:40 2022-06-20T20:37:40
Cómo usar un módulo como dependencia
Modos de repositorio: Estándar
Para importar módulos almacenados en Artifact Registry, debes indicarle a Go que busque dependencias de Artifact Registry y omita la base de datos de suma de verificación. Sigue las instrucciones para configurar la autenticación y el entorno de Go en Cómo configurar la autenticación para Go.
Si usas credenciales de corta duración para autenticarte en Artifact Registry, deberás actualizar tu token de OAuth mediante la ejecución del siguiente comando:
GOPROXY=proxy.golang.org \ go run github.com/GoogleCloudPlatform/artifact-registry-go-tools/cmd/auth@latest refresh
Si tu módulo aún no tiene un archivo
go.mod
, cambia de directorio a la carpeta del módulo y ejecutago mod init
para crear un archivogo.mod
para tu paquete.go mod init MODULE_PATH
Reemplaza MODULE_PATH por la ruta de acceso del módulo almacenado en Artifact Registry. Consulta la Referencia de módulos de Go para obtener más información.
Para exigir la versión del módulo almacenada en Artifact Registry, edita el archivo
go.mod
para que se vea de la siguiente manera:module example.com/bar go 1.19 require example.com/foo v0.1.0
Reemplaza lo siguiente:
example.com/foo
es la ruta de acceso del módulo requerido.v0.1.0
es la versión almacenada en Artifact Registry.
Incluye la ruta de acceso del módulo como de costumbre en la sección
import
de tu archivomain.go
.Por ejemplo, para importar un módulo con la ruta de acceso
example.com/foo
almacenada en Artifact Registry, la sección de importación podría parecerse a la siguiente:package main import ( foo "example.com/foo" ) func main() { ... }
Ejecuta
go mod tidy
para descargar dependencias:go mod tidy
Ejecuta tu módulo como de costumbre:
go run .
El módulo almacenado en Artifact Registry se descarga y se usa como dependencia.
Borrar módulos de Go empaquetados
Modos de repositorio: Estándar
Puedes borrar un paquete y todas sus versiones, o bien borrar una versión específica.
- Una vez que borres un paquete, no podrás deshacer la acción.
Antes de borrar un paquete o una versión de un paquete, verifica que se haya comunicado o abordado cualquier dependencia importante en este.
Para borrar un paquete, haz lo siguiente:
Console
Abre la página Repositorios en la consola de Google Cloud.
En la lista de repositorios, haz clic en el repositorio correspondiente.
En la página Paquetes, se enumeran los paquetes del repositorio.
Selecciona el paquete que quieres borrar.
Haz clic en BORRAR.
En el cuadro de diálogo de confirmación, haz clic en BORRAR.
gcloud
Ejecuta el siguiente comando:
gcloud artifacts packages delete PACKAGE \
[--repository=REPOSITORY] [--location=LOCATION] [--async]
Dónde
- PACKAGE es el nombre del paquete en el repositorio.
- REPOSITORY es el nombre del repositorio. Si configuraste un repositorio predeterminado, puedes omitir esta marca para usarlo.
- LOCATION es una ubicación regional o multirregional. Usa esta marca para ver los repositorios en una ubicación específica. Si configuraste una ubicación default, puedes omitir esta marca para usar la predeterminada.
--async
se muestra de inmediato, sin necesidad de esperar a que se complete la operación en curso.
Sigue estos pasos para borrar versiones de un paquete:
Console
Abre la página Repositorios en la consola de Google Cloud.
En la lista de repositorios, haz clic en el repositorio correspondiente.
En la página Paquetes, se enumeran los paquetes del repositorio.
Haz clic en un paquete para ver sus versiones.
Selecciona las versiones que deseas borrar.
Haz clic en BORRAR.
En el cuadro de diálogo de confirmación, haz clic en BORRAR.
gcloud
Ejecuta el siguiente comando:
gcloud artifacts versions delete VERSION \
--package=PACKAGE \
[--repository=REPOSITORY] [--location=LOCATION] \
[--async]
Dónde
- PACKAGE es el nombre del paquete en el repositorio.
- REPOSITORY es el nombre del repositorio. Si configuraste un repositorio predeterminado, puedes omitir esta marca para usarlo.
- LOCATION es una ubicación regional o multirregional. Usa esta marca para ver los repositorios en una ubicación específica. Si configuraste una ubicación default, puedes omitir esta marca para usar la predeterminada.
--async
se muestra de inmediato, sin necesidad de esperar a que se complete la operación en curso.
¿Qué sigue?
- Prueba la guía de inicio rápido de Go.
- Descarga archivos individuales asociados a un módulo o una versión sin usar los comandos de Go.