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 de 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 una ubicación no válida del repositorio o errores de nombre de repositorio no válido.

Valores predeterminados de ubicación y 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, ejúcalo con la marca --help.

La configuración predeterminada del repositorio 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 especificaste 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 que son anteriores a las restricciones de ubicación.

Nombres de repositorios en los comandos de gcloud

Puedes enumerar repositorios para ver los nombres de los 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 del proyecto de Google Cloud LOCATION por la ubicación del repositorio

El comando muestra información de 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 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 marca:

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

Nombres de repositorios con clientes de terceros

Para clientes de terceros, por lo general, se usa una ruta de repositorio completa cuando configurar clientes, como us-east1-docker.pkg.dev/my-project/my-repo. Luego, sigue 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 estás trabajando.

Si realizas la transición desde Container Registry, ten en cuenta que todas las rutas de acceso de las imágenes deben incluir un nombre de repositorio de Artifact Registry. No puedes especificar un ruta de acceso de la imagen que solo incluye un ID del proyecto.

  • Ruta 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 pueden enviar ni extraer repositorios no borrados.

Los repositorios ya no funcionan correctamente después de deshacer la eliminación de un proyecto de Google Cloud o 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.