Un repositorio virtual es un tipo de repositorio de Artifact Registry que te permite acceder a paquetes de Assured Open Source Software (Assured OSS) desde varios repositorios upstream a través de un solo repositorio.
Los repositorios virtuales solo se admiten en el nivel gratuito. En el nivel Premium, los repositorios de Assured OSS se aprovisionan automáticamente.
Para obtener más información sobre las opciones de repositorios, consulta Opciones de repositorios de Assured OSS.
Antes de comenzar
Si quieres usar un repositorio virtual para acceder a los paquetes de Assured OSS, haz lo siguiente:
Proporciona los detalles del agente de servicio de Artifact Registry para el proyecto que quieres usar en el formulario de habilitación del cliente de Assured OSS. El agente de servicio de Artifact Registry es una cuenta de servicio administrada por Google que actúa en nombre de Artifact Registry cuando interactúa con los servicios de Google Cloud . Los repositorios virtuales usan el servicio para autenticarse en los repositorios upstream. El agente de servicio requiere acceso de lectura al repositorio de Artifact Registry de Assured OSS.
Puedes habilitar el acceso del agente de servicio durante la inscripción inicial incluyendo los detalles del agente de servicio como una de las cuentas de servicio que quieres que tengan acceso a Assured OSS.
Si ya habilitaste el acceso a Assured OSS sin incluir los detalles del agente de servicio, regresa al sitio web de habilitación de Assured OSS y crea una nueva solicitud de habilitación para el agente de servicio con sus detalles específicos.
Si deseas obtener instrucciones para encontrar el nombre del agente de servicio existente o crear uno nuevo para tu proyecto, consulta Cuenta de servicio de Artifact Registry.
Configura un repositorio virtual
Crea un repositorio virtual en la misma región de Google Cloud en la que reside el repositorio de Artifact Registry de Assured OSS. Usa el proyecto cuyo agente de servicio tenga acceso de lectura al repositorio de Artifact Registry de Assured OSS.
En el archivo
policies.json, agrega la siguiente configuración para otorgar al repositorio virtual acceso al repositorio de Assured OSS de Artifact Registry:- Configuración del repositorio de Java:
{ "id" : "AOSS Java", "repository" : "projects/cloud-aoss/locations/us/repositories/cloud-aoss-java", "priority" : 100 }- Configuración del repositorio de Python:
{ "id" : "AOSS Python", "repository" : "projects/cloud-aoss/locations/us/repositories/cloud-aoss-python", "priority" : 100 }- Configuración del repositorio de Go:
{ "id" : "AOSS Go", "repository" : "projects/cloud-aoss/locations/us/repositories/assuredoss-go-free", "priority" : 100 }Descarga los paquetes de Java, Python y Go con el repositorio virtual. Para obtener instrucciones sobre cómo descargar los paquetes, consulta los siguientes temas:
Accede a paquetes que no están disponibles en Assured OSS
Si deseas acceder a paquetes que no están disponibles en el repositorio de Artifact Registry para Assured OSS, puedes hacer lo siguiente:
Assured OSS también está preconfigurado con Assured OSS como repositorio preferido y con repositorios públicos canónicos, como Maven Central o PyPI, como repositorios secundarios. Para usar esta función (versión preliminar), puedes apuntar a una sola URL:
- Para Java, usa
https://us-maven.pkg.dev/cloud-aoss/java - Para Python, usa
https://us-python.pkg.dev/cloud-aoss/python - Para Go, usa
https://us-go.pkg.dev/cloud-aoss/go
- Para Java, usa