Um repositório virtual é um tipo de repositório do Artifact Registry que permite acessar pacotes do Assured Open Source Software (Assured OSS) de vários repositórios upstream por um único repositório.
Os repositórios virtuais são compatíveis apenas no nível sem custo financeiro. No nível Premium, os repositórios do Assured OSS são provisionados automaticamente.
Para mais informações sobre as opções de repositório, consulte Opções de repositório do Assured OSS.
Antes de começar
Se você quiser usar um repositório virtual para acessar os pacotes do Assured OSS, faça o seguinte:
Forneça os detalhes do Agente de serviço do Artifact Registry para o projeto que você quer usar no formulário de ativação do cliente do Assured OSS. O agente de serviço do Artifact Registry é uma conta de serviço gerenciada pelo Google que atua em nome do Artifact Registry ao interagir com os serviços do Google Cloud . Os repositórios virtuais usam o serviço para autenticar em repositórios upstream. O agente de serviço requer acesso de leitura ao repositório do Artifact Registry do Assured OSS.
É possível ativar o acesso do agente de serviço durante a inscrição inicial, incluindo os detalhes do agente de serviço como uma das contas de serviço que você quer que tenham acesso ao Assured OSS.
Se você já tiver ativado o acesso ao Assured OSS sem incluir os detalhes do agente de serviço, volte ao site de ativação do Assured OSS e crie uma nova solicitação de ativação para o agente de serviço com os detalhes específicos.
Para instruções sobre como encontrar o nome do agente de serviço atual ou criar um novo para seu projeto, consulte Conta de serviço do Artifact Registry.
Configurar um repositório virtual
Crie um repositório virtual na mesma região do Google Cloud em que o repositório do Artifact Registry do Assured OSS está localizado. Use o projeto em que o agente de serviço tem acesso de leitura ao repositório do Artifact Registry do Assured OSS.
No arquivo
policies.json, adicione a seguinte configuração para dar ao repositório virtual acesso ao repositório do Artifact Registry do Assured OSS:- Configuração para o repositório Java:
{ "id" : "AOSS Java", "repository" : "projects/cloud-aoss/locations/us/repositories/cloud-aoss-java", "priority" : 100 }- Configuração do repositório do Python:
{ "id" : "AOSS Python", "repository" : "projects/cloud-aoss/locations/us/repositories/cloud-aoss-python", "priority" : 100 }- Configuração para o repositório Go:
{ "id" : "AOSS Go", "repository" : "projects/cloud-aoss/locations/us/repositories/assuredoss-go-free", "priority" : 100 }Baixe os pacotes Java, Python e Go usando o repositório virtual. Para instruções sobre como fazer o download dos pacotes, consulte os seguintes tópicos:
Acessar pacotes não disponíveis no Assured OSS
Se você quiser acessar pacotes que não estão disponíveis no repositório do Artifact Registry para o Assured OSS, faça o seguinte:
O Assured OSS também é pré-configurado com o Assured OSS como repositório preferencial e repositórios públicos canônicos, como Maven Central ou PyPI, como repositórios secundários. Para usar esse recurso (pré-lançamento), você pode apontar para um único URL:
- Para Java, use
https://us-maven.pkg.dev/cloud-aoss/java - Para Python, use
https://us-python.pkg.dev/cloud-aoss/python - Para Go, use
https://us-go.pkg.dev/cloud-aoss/go
- Para Java, use