Solucionar problemas generales

Consulta los pasos para solucionar problemas que se aplican a todos los formatos de artefacto al trabajar con Artifact Registry. Si tienes problemas específicos con un formato de artefacto, consulta la página correspondiente.

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

Usa la siguiente información para diagnosticar errores de ubicación o nombre de repositorio no válidos.

Valores predeterminados de ubicación y repositorio de gcloud

Si has definido un repositorio y una ubicación predeterminados en la CLI de Google Cloud para poder omitir las marcas --location y --repository de los comandos gcloud artifacts, prueba a ejecutar el comando que ha fallado con las marcas y los valores correspondientes. Para obtener información sobre la sintaxis de un comando concreto, ejecuta el comando con la marca --help.

El ajuste predeterminado del repositorio no se aplica a los comandos gcloud artifacts en los que se especifica un nombre de repositorio sin la marca --repository. Por ejemplo, debes especificar el nombre del repositorio en un comando gcloud artifacts repositories describe como en el siguiente ejemplo:

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

Si el comando sigue fallando, puede que tengas que verificar que has especificado valores válidos para el repositorio o la ubicación.

Ubicación del repositorio

Para ver una lista de todas las ubicaciones compatibles con 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 crear el repositorio. Artifact Registry no aplica las políticas de forma retroactiva a los repositorios anteriores a las restricciones de ubicación.

Nombres de repositorios en comandos de gcloud

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

Para ver una lista de 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

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

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

REPOSITORY: my-repo
FORMAT: DOCKER
DESCRIPTION:
LOCATION: us-west1
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-west1 --repository=my-repo

Este comando usa solo el nombre del repositorio sin un indicador:

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

Nombres de repositorios con clientes de terceros

En el caso de los clientes de terceros, normalmente se usa una ruta de repositorio completa al configurar los clientes, como us-west1-docker.pkg.dev/my-project/my-repo. A continuación, sigue las convenciones del cliente para subir y descargar paquetes. Para obtener información sobre la configuración y el uso del cliente, consulta la documentación del formato con el que estés trabajando.

Si vas a migrar de Container Registry, ten en cuenta que todas las rutas de las imágenes deben incluir un nombre de repositorio de Artifact Registry. No puedes especificar una ruta de imagen que solo incluya un ID de proyecto.

  • Ruta 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 eliminados

Los repositorios dejan de funcionar correctamente después de restaurar un proyecto Google Cloud o de habilitar la API de Artifact Registry tras inhabilitarla.

Si inhabilitas la API de Artifact Registry o eliminas el proyecto, los servicios de Artifact Registry dejarán de estar disponibles. Artifact Registry elimina los datos del repositorio al cabo de 7 días.

Más información sobre la eliminación de datos en Google Cloud