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.
- Imágenes de contenedor: imágenes de contenedor y gráficos de Helm
- Paquetes de idiomas: Java, Node.js y Python
- Paquetes de 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 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.
- Imágenes de contenedor: Docker, Helm
- Paquetes de idiomas: Java, Node.js, Python, Go
- Paquetes de 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 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