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 trabajando con Artifact Registry. Para 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 gcloud artifacts, intenta ejecutar el comando que falló con el marcas y los valores correspondientes. Para obtener detalles sobre la sintaxis de una aplicación ejecuta el comando con la marca --help.

La configuración predeterminada del repositorio no se aplica a los comandos de gcloud artifacts en el 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 del repositorio o la ubicación.

Ubicación del repositorio

Para ver una lista de todas las ubicaciones compatibles de Artifact Registry, 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 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 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 ver una lista de 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 de 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. Tú 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 a las imágenes debes 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 desde repositorios no borrados

Los repositorios ya no funcionan correctamente después de recuperar una cuenta de Google Cloud o habilitar la API de Artifact Registry después de inhabilitarla.

Si inhabilitas la API de Artifact Registry o borrar el proyecto, los servicios de Artifact Registry se disponible. 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.