Ringkasan repositori konektor

Repositori konektor Artifact Registry berfungsi sebagai proxy untuk sumber upstream. Semua permintaan ke repositori di-proxy ke sumber upstream dan tidak ada artefak yang di-cache di Artifact Registry. Konfigurasi ini memungkinkan auditabilitas penuh sumber upstream dan mendukung kasus ketika kebijakan pihak ketiga mencegah penyimpanan artefak dalam cache.

Dokumen ini menjelaskan cara kerja repositori konektor dan memberikan beberapa kasus penggunaan. Untuk mengetahui petunjuk tentang cara membuat repositori konektor, lihat Membuat repositori konektor.

Format konektor yang didukung

Artifact Registry hanya mendukung repositori konektor berformat Docker.

Autentikasi upstream

Repositori konektor Artifact Registry memerlukan autentikasi dasar ke sumber upstream. Untuk mengetahui informasi selengkapnya tentang cara mengautentikasi ke sumber upstream repositori konektor, lihat Mengonfigurasi autentikasi ke upstream repositori konektor.

Jika Anda meminta artefak dari sumber upstream yang tidak ada, atau tidak berisi versi yang Anda tentukan, permintaan akan gagal.

Kasus penggunaan dan manfaat

Auditabilitas hulu penuh
Repositori konektor tidak menyimpan cache paket apa pun di Artifact Registry, sehingga semua permintaan repositori dibuat langsung ke sumber upstream Anda. Proses ini berguna jika konfigurasi repositori Anda memerlukan auditabilitas penuh sumber upstream atau jika Anda harus mematuhi kebijakan pihak ketiga yang mencegah penyimpanan artefak dalam cache.
Resolusi dependensi yang lebih aman

Gunakan repositori konektor bersama dengan repositori virtual untuk mengurangi risiko yang terkait dengan dependensi publik. Beberapa alat tidak menyediakan cara untuk mengontrol urutan penelusuran saat campuran repositori pribadi dan publik dikonfigurasi di klien. Jenis konfigurasi ini rentan terhadap serangan kebingungan dependensi, di mana penyerang mengupload versi baru paket dengan kode berbahaya ke repositori publik untuk mengelabui klien agar memilih versi berbahaya.

Daripada mengonfigurasi klien secara langsung untuk menelusuri beberapa repositori, Anda dapat mengonfigurasi repositori virtual untuk memprioritaskan repositori pribadi daripada repositori konektor.

Jika Artifact Registry berada dalam perimeter layanan Kontrol Layanan VPC, Artifact Registry akan menolak akses ke sumber upstream di luar perimeter secara default. Anda dapat mengizinkan repositori konektor di lokasi tertentu untuk mengakses sumber eksternal yang dikonfigurasi di luar perimeter. Untuk mengetahui petunjuknya, lihat Konfigurasi Kontrol Layanan VPC.

Untuk mempelajari praktik terbaik pengelolaan dependensi lainnya, lihat Pengelolaan dependensi.

Pembaruan pada indeks dan metadata paket

File yang dapat diubah seperti indeks dan metadata paket diperbarui dari sumber upstream saat file tersebut melampaui usia default. Default untuk jenis file tertentu tercantum dalam tabel berikut:

Format Jenis file Usia update default
Docker Cache daftar/dapatkan tag 1 jam

Upstream repositori konektor Artifact Registry

Anda dapat menggunakan Docker Hub sebagai sumber repositori konektor atau memasukkan URL repositori kustom. Tabel berikut menampilkan daftar sebagian beberapa URI Docker upstream umum:

Format URI upstream Nama Registry
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 Galeri Publik AWS ECR
Docker https://registry.k8s.io Kubernetes Container Registry
Docker https://MY_NEXUS_IP Nexus

Batasan

Selain kuota dan batasan Artifact Registry, repositori konektor memiliki batasan berikut:

  • Sumber upstream harus dapat diakses melalui internet. Repositori konektor tidak mendukung sumber hulu jaringan Virtual Private Cloud (VPC) atau lokal tanpa alamat IP publik.

Mode repositori lainnya

Mode repositori lainnya adalah sebagai berikut:

  • Standar: mode repositori default. Anda mengupload atau memublikasikan artefak seperti paket pribadi langsung ke repositori standar. Meskipun Anda dapat mendownload langsung dari setiap repositori standar, mengakses grup repositori dengan repositori virtual akan menyederhanakan konfigurasi alat.
  • Jarak jauh: repositori yang berfungsi sebagai proxy untuk sumber upstream dengan menyimpan paket dalam cache di Artifact Registry setelah paket didownload dari sumber upstream untuk pertama kalinya. Saat Anda meminta versi paket yang sama lagi, Artifact Registry akan memberikan salinan yang di-cache.
  • Virtual: repositori yang berfungsi sebagai satu titik akses untuk beberapa repositori upstream, termasuk repositori standar dan konektor.

Langkah berikutnya