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 de 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 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 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 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 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
. 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 contenedor: Docker, Helm
- Paquetes de lenguajes: Java, Node.js, Python y Go
- Paquetes de SO: Debian, RPM
Si realizas la transición desde Container Registry, ten en cuenta que todas las rutas de acceso de las imágenes deben 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 repositorios no borrados.
Los repositorios ya no funcionan correctamente después de deshacer la eliminación de un proyecto de 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.