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.
- Imágenes de contenedor: Imágenes de contenedor, gráficos de Helm
- Paquetes de lenguaje: Java, Node.js y Python
- Paquetes del SO
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 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 Google Cloud ID de tu proyecto y LOCATION por la ubicación del repositorio.
El comando muestra información de 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 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, por lo general, se usa una ruta de acceso completa del repositorio cuando se configuran clientes, como us-west1-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.
- Imágenes de contenedores: Docker, Helm
- Paquetes de lenguaje: Java, Node.js, Python y Go
- Paquetes del SO: Debian, RPM
- 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 pueden enviar ni extraer repositorios no borrados.
Los repositorios ya no funcionan correctamente después de deshacer la eliminación de un proyecto 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.