Panoramica dei repository dei connettori

I repository dei connettori di Artifact Registry fungono da proxy per le origini upstream. Tutte le richieste al repository vengono inviate tramite proxy all'origine upstream e nessun artefatto viene memorizzato nella cache in Artifact Registry. Questa configurazione consente la completa auditabilità delle origini upstream e supporta i casi in cui le policy di terze parti impediscono la memorizzazione nella cache degli artefatti.

Questo documento descrive il funzionamento dei repository dei connettori e fornisce diversi casi d'uso. Per istruzioni su come creare un repository di connettori, consulta Creare repository di connettori.

Formati di connettori supportati

Artifact Registry supporta solo i repository di connettori in formato Docker.

Autenticazione upstream

I repository dei connettori di Artifact Registry richiedono l'autenticazione di base alle origini upstream. Per saperne di più su come eseguire l'autenticazione alle origini upstream del repository dei connettori, consulta Configurare l'autenticazione alle origini upstream del repository dei connettori.

Se richiedi un artefatto da un'origine upstream che non esiste o non contiene la versione specificata, la richiesta non andrà a buon fine.

Casi d'uso e vantaggi

Auditabilità completa upstream
I repository dei connettori non memorizzano nella cache alcun pacchetto in Artifact Registry, quindi tutte le richieste del repository vengono effettuate direttamente all'origine upstream. Questa procedura è utile se la configurazione del repository richiede la completa auditabilità delle origini upstream o se devi rispettare le policy di terze parti che impediscono la memorizzazione nella cache degli artefatti.
Risoluzione delle dipendenze più sicura

Utilizza i repository dei connettori insieme ai repository virtuali per mitigare i rischi associati alle dipendenze pubbliche. Alcuni strumenti non forniscono un modo per controllare l'ordine di ricerca quando nel client è configurato un mix di repository privati e pubblici. Questo tipo di configurazione è vulnerabile a un attacco di confusione delle dipendenze, in cui un utente malintenzionato carica una nuova versione di un pacchetto con codice dannoso in un repository pubblico per indurre i client a scegliere la versione dannosa.

Anziché configurare i client direttamente per cercare più repository, puoi configurare i repository virtuali in modo da dare la priorità ai repository privati rispetto ai repository dei connettori.

Se Artifact Registry si trova in un perimetro di servizio dei Controlli di servizio VPC, per impostazione predefinita nega l'accesso alle origini upstream all'esterno del perimetro. Puoi consentire ai repository dei connettori in una località specifica di accedere alle origini esterne configurate all'esterno del perimetro. Per istruzioni, consulta Configurazione dei Controlli di servizio VPC.

Per scoprire altre best practice per la gestione delle dipendenze, consulta Gestione delle dipendenze.

Aggiornamenti degli indici e dei metadati dei pacchetti

I file modificabili, come gli indici e i metadati dei pacchetti, vengono aggiornati dall'origine upstream quando superano l'età predefinita. I valori predefiniti per i tipi di file specifici sono elencati nella tabella seguente:

Formato Tipo di file Età di aggiornamento predefinita
Docker Cache di elenchi/recuperi di tag 1 ora

Origini upstream del repository dei connettori di Artifact Registry

Puoi utilizzare Docker Hub come origine del repository dei connettori o inserire un URL del repository personalizzato. La tabella seguente mostra un elenco parziale di alcuni URI Docker upstream comuni:

Formato URI upstream Nome registro
Docker https://MY_ARTIFACTORY_INSTANCE.jfrog.io/OPTIONAL_REPO JFrog Artifactory
Docker https://ghcr.io GitHub Container Registry
Docker https://registry-1.docker.io Docker Hub
Docker https://public.ecr.aws AWS ECR Public Gallery
Docker https://registry.k8s.io Kubernetes Container Registry
Docker https://MY_NEXUS_IP Nexus

Limitazioni

Oltre alle quote e alle limitazioni di Artifact Registry, i repository dei connettori presentano le seguenti limitazioni:

  • Le origini upstream devono essere accessibili a internet. I repository dei connettori non supportano le origini upstream on-premise o di rete Virtual Private Cloud (VPC) senza un indirizzo IP pubblico.

Altre modalità di repository

Le altre modalità di repository sono le seguenti:

  • Standard: la modalità di repository predefinita. Carichi o pubblichi artefatti come pacchetti privati direttamente nei repository standard. Sebbene tu possa scaricare direttamente dai singoli repository standard, l'accesso a gruppi di repository con un repository virtuale semplifica la configurazione degli strumenti.
  • Remoto: un repository che funge da proxy per un'origine upstream memorizzando nella cache i pacchetti in Artifact Registry dopo che sono stati scaricati dall'origine upstream per la prima volta. La volta successiva che richiedi la stessa versione del pacchetto, Artifact Registry fornisce la copia memorizzata nella cache.
  • Virtuale: un repository che funge da singolo punto di accesso per più repository upstream, inclusi i repository dei connettori e standard

Passaggi successivi