Obtén información sobre los pasos para solucionar problemas que se aplican a todos los formatos de artefactos cuando se trabaja con Artifact Registry. Si quieres obtener información sobre los problemas específicos de un formato de artefacto, consulta la página sobre cada formato.
- Imágenes de contenedor: Imágenes de contenedor, gráficos de Helm
- Paquetes de lenguajes: Java, Node.js, Python
- Paquetes de SO
Repositorio o ubicación no válidos en los comandos
Usa la siguiente información para diagnosticar una ubicación de repositorio no válida o errores de nombres de repositorio no válidos.
Configuración predeterminada de la ubicación y el repositorio de gcloud
Si configuras un repositorio y una ubicación predeterminados en Google Cloud CLI
para poder omitir las marcas --location y --repository en los
comandos de 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 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 aún falla, 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
La política de la 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 repositorios en un proyecto o una ubicación especificados.
Para mostrar una lista de todos los repositorios de un proyecto, ejecuta el siguiente comando:
gcloud artifacts repositories list --project=PROJECT-ID \
--location=all
Para mostrar una lista de 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 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 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 una marca:
gcloud artifacts repositories describe my-repo --location=us-west1
Nombres de repositorios con clientes de terceros
Para los clientes de terceros, generalmente, 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 estás trabajando.
- Imágenes de contenedor: Docker, Helm
- Paquetes de lenguajes: Java, Node.js, Python y Go
- Paquetes de SO: Debian, RPM
Si haces la transición desde 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 pueden enviar ni extraer repositorios no borrados
Los repositorios ya no funcionan correctamente cuando recuperas un proyecto de Google Cloud o habilitas 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.