Solución de problemas generales

Obtén información sobre los pasos para solucionar problemas que se aplican a todos los formatos de artefactos cuando trabajas con Artifact Registry. Para problemas específicos del formato de artefactos, consulta la página específica de formato.

Repositorio o ubicación no válidos en los comandos

Usa la siguiente información para diagnosticar la ubicación o los errores de nombres de repositorios no válidos.

Configuración predeterminada de la ubicación y el repositorio para gcloud

Si configuras un repositorio y una ubicación predeterminados en Google Cloud CLI para que puedas omitir las marcas --location y --repository de los comandos gcloud artifacts, intenta ejecutar el comando que falló con las marcas y los valores correspondientes. Para obtener detalles sobre la sintaxis de un comando en particular, ejecuta el comando con la marca --help.

La configuración predeterminada del repositorio no se aplica a los comandos de gcloud artifacts en los que especificas un nombre de repositorio sin la marca --repository. Por ejemplo, debes especificar el nombre del repositorio en un comando gcloud artifacts repositories describe como se muestra en el siguiente ejemplo:

gcloud artifacts repositories describe my-repo --location=us-west1

Si el comando sigue fallando, es posible que debas verificar que especificaste valores válidos para el repositorio o la ubicación.

Ubicación del repositorio

Para enumerar todas las ubicaciones de Artifact Registry compatibles, ejecuta el siguiente comando:

gcloud artifacts locations list

La política de tu organización puede incluir restricciones de ubicación. Artifact Registry aplica estas restricciones durante la creación del repositorio. Artifact Registry no aplica la política de forma retroactiva en los repositorios previos a las restricciones de ubicación.

Nombres de repositorios en comandos de gcloud

Puedes enumerar repositorios para ver los nombres de repositorios en un proyecto o una ubicación especificados.

Para enumerar todos los repositorios de un proyecto, ejecuta el siguiente comando:

gcloud artifacts repositories list --project=PROJECT-ID \
    --location=all

Para enumerar todos los repositorios de una ubicación, ejecuta el siguiente comando:

gcloud artifacts repositories list --project=PROJECT-ID \
    --location=LOCATION

Reemplaza PROJECT-ID por el ID de tu proyecto de Google Cloud y LOCATION por la ubicación del repositorio.

El comando muestra información para cada repositorio similar al siguiente ejemplo:

REPOSITORY: my-repo
FORMAT: MAVEN
DESCRIPTION:
LOCATION: us-east1
LABELS:
ENCRYPTION: Google-managed key
CREATE_TIME: 2021-09-23T19:39:10
UPDATE_TIME: 2021-09-23T19:39:10

El valor de REPOSITORY es el valor que usas con los comandos gcloud artifacts que incluyen el nombre del repositorio como parámetro.

Por ejemplo, este comando usa la marca --repository:

gcloud artifacts packages list --location=us-east1 --repository=my-repo

Este comando usa el nombre del repositorio solo sin una marca:

gcloud artifacts repositories describe my-repo --location=us-west1

Nombres de repositorios con clientes de terceros

Para los clientes de terceros, por lo general, se usa una ruta de acceso de repositorio completa cuando se configuran clientes, como us-east1-docker.pkg.dev/my-project/my-repo. Luego, debes seguir las convenciones del cliente para subir y descargar paquetes. Para obtener detalles sobre la configuración y el uso del cliente, consulta la documentación del formato con el que trabajas.

Si haces la transición de Container Registry, ten en cuenta que todas las rutas de imagen deben incluir un nombre de repositorio de Artifact Registry. No puedes especificar una ruta de imagen que solo incluya un ID del proyecto.

  • Ruta de acceso no válida: us-east1-docker.pkg.dev/my-project/my-image
  • Ruta de acceso válida: us-east1-docker.pkg.dev/my-project/my-repo/my-image

No se puede enviar ni extraer repositorios no borrados

Los repositorios ya no funcionan de forma correcta después de recuperar un proyecto de Google Cloud o de habilitar la API de Artifact Registry después de inhabilitarla.

Si inhabilitas la API de Artifact Registry o borras el proyecto, los servicios de Artifact Registry dejan de estar disponibles. Artifact Registry borra los datos del repositorio después de 7 días.

Obtén más información sobre la eliminación de datos en Google Cloud.