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. Si tienes problemas específicos con un formato de artefacto, consulta la página específica del formato.

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

Usa la siguiente información para diagnosticar errores relacionados con la ubicación o el nombre del repositorio no válidos.

Ubicación y repositorio predeterminados para gcloud

Si estableciste un repositorio y una ubicación predeterminados en Google Cloud CLI para poder 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.

El parámetro de configuración del repositorio predeterminado no se aplica a los comandos 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 el siguiente:

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

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

Ubicación del repositorio

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

gcloud artifacts locations list

Es posible que la política de tu organización incluya restricciones de ubicación. Artifact Registry aplica estas restricciones en el momento de la creación del repositorio. Artifact Registry no aplica la política de forma retroactiva en los repositorios anteriores a las restricciones de ubicación.

Nombres de repositorios en los comandos de gcloud

Puedes enumerar los repositorios para ver sus nombres 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 en una ubicación, ejecuta el siguiente comando:

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

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

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

REPOSITORY: my-repo
FORMAT: DOCKER
DESCRIPTION:
LOCATION: us-west1
LABELS:
ENCRYPTION: Google-owned and Google-managed encryption key
CREATE_TIME: 2021-09-23T19:39:10
UPDATE_TIME: 2021-09-23T19:39:10

El valor de REPOSITORY es el 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-west1 --repository=my-repo

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

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

Nombres de repositorios con clientes de terceros

En el caso de los clientes externos, generalmente se usa una ruta de acceso completa al repositorio cuando se configuran los clientes, como us-west1-docker.pkg.dev/my-project/my-repo. Luego, sigues 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 estás migrando desde Container Registry, ten en cuenta que todas las rutas de acceso a las imágenes deben incluir un nombre de repositorio de Artifact Registry. No puedes especificar una ruta de acceso a la imagen que solo incluya un ID del proyecto.

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

No se puede enviar ni extraer contenido de repositorios no borrados

Los repositorios ya no funcionan correctamente después de recuperar un proyecto Google Cloudo 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 dejarán 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.

Error al extraer el archivo adicional de Prometheus para Cloud Run en un perímetro de servicio

Usas Artifact Registry con los Controles del servicio de VPC y tratas de extraer la imagen del archivo adicional de Prometheus para Cloud Run dentro de un perímetro de servicio. Recibes un error 403 permission denied.

Para solucionar este problema, permite la salida al proyecto cloud-ops-agents-artifacts en la regla de salida que configuraste para usar mirror.gcr.io en tu perímetro de servicio. Para ello, agrega projects/1042947621568 como recurso en tu regla de salida.