Halaman ini menjelaskan cara menambahkan, melihat, dan menghapus paket Debian di repositori Apt.
Sebelum memulai
- Jika repositori Apt target tidak ada, buat repositori baru.
- Konfigurasi VM untuk mengakses repositori.
- (Opsional) Konfigurasi default untuk perintah gcloud.
- Pastikan nama paket Anda dalam metadata memenuhi standar nama paket Debian.
Menambahkan paket
Mode repositori: standar
Anda harus memiliki izin baca dan tulis bagi repositori untuk menambahkan paket.
Anda dapat mengupload paket ke repositori menggunakan Google Cloud CLI, atau mengimpor paket yang disimpan di Cloud Storage. Jika Anda mem-build paket menggunakan Cloud Build, build dapat menyimpan paket di Cloud Storage untuk Anda impor.
Operasi impor atau upload yang sangat lama dapat melebihi periode habis masa berlaku untuk token yang digunakan gcloud CLI untuk memanggil API. Jika Anda memiliki banyak paket untuk ditambahkan, pertimbangkan untuk menambahkannya dalam batch yang lebih kecil sehingga setiap operasi upload atau impor dapat selesai dalam waktu yang lebih singkat. Lihat dokumentasi Pemecahan masalah paket OS untuk mengetahui informasi selengkapnya.
Upload langsung
Gunakan
perintah gcloud artifacts apt upload
untuk mengupload paket ke repositori Apt:
gcloud artifacts apt upload REPOSITORY \
--location=LOCATION \
--source=PACKAGES
Ganti nilai berikut:
- REPOSITORY adalah nama repositori Artifact Registry.
- LOCATION adalah lokasi regional atau multi-regional repositori.
- PACKAGES adalah jalur ke paket.
Misalnya, untuk mengupload paket my-package.deb
ke repositori Apt
my-repo
di lokasi us-central1
, jalankan:
gcloud artifacts apt upload my-repo \ --location=us-central1 \ --source=my-package.deb
Cloud Storage
Upload paket ke Cloud Storage dengan salah satu cara berikut:
- Mengupload paket langsung ke bucket Cloud Storage
- Membangun paket dengan Cloud Build dan menyimpannya dalam bucket
Jalankan perintah berikut:
gcloud artifacts apt import REPOSITORY \ --location=LOCATION \ --gcs-source=PACKAGES
Ganti nilai berikut:
- REPOSITORY adalah nama repositori Artifact Registry.
- LOCATION adalah lokasi regional atau multi-regional repositori.
- PACKAGES adalah daftar paket yang dipisahkan koma di Cloud Storage. Untuk mengupload semua paket dari direktori, gunakan
karakter pengganti direktori (
*
) atau gunakan karakter pengganti direktori rekursif (**) untuk mengupload semua paket di semua subdirektori.
Misalnya, untuk mengupload paket
package.rpm
dan semua paket di direktoridirectory
dari bucketmy-bucket
ke repositori Aptmy-repo
di lokasius-central1
, jalankan:gcloud artifacts apt import my-repo \ --location=us-central1 \ --gcs-source=gs://my-bucket/path/to/package.deb,gs://my-bucket/directory*
Setelah operasi upload atau impor selesai, Anda dapat menggunakan Google Cloud Console atau gcloud CLI untuk melihat paket di repositori dan mengonfirmasi bahwa paket tersebut berhasil diupload.
Jika Anda memiliki repositori besar dengan banyak paket, mungkin perlu waktu beberapa menit untuk membuat ulang indeks paket sehingga paket baru dapat dilihat oleh klien Apt.
Menampilkan paket
Mode repositori: standar, jarak jauh (pratinjau)
Untuk melihat paket, Anda harus memiliki izin dalam peran Artifact Registry Reader. Artifact Registry tidak mencantumkan file di dalam paket.
Untuk melihat paket dan versi paket menggunakan Konsol Google Cloud
atau gcloud
:
Konsol
Buka halaman Repositories di Konsol Google Cloud.
Dalam daftar repositori, klik repositori yang sesuai.
Halaman Packages mencantumkan paket dalam repositori.
Klik paket untuk melihat versi paket.
gcloud
Untuk mencantumkan paket dalam repositori, jalankan perintah berikut:
gcloud artifacts packages list [--repository=REPOSITORY] [--location=LOCATION]
Dari mana
- REPOSITORY adalah nama repositori. Jika mengonfigurasi repositori default, Anda dapat menghilangkan tanda ini untuk menggunakan repositori default.
- LOCATION adalah lokasi regional atau multi-regional. Gunakan flag ini untuk melihat repositori di lokasi tertentu. Jika mengonfigurasi lokasi default, Anda dapat menghilangkan tanda ini untuk menggunakan lokasi default.
Untuk melihat versi paket, jalankan perintah berikut:
gcloud artifacts versions list --package=PACKAGE \
[--repository=REPOSITORY] [--location=LOCATION]
Dari mana
- PACKAGE adalah ID paket atau ID yang sepenuhnya memenuhi syarat untuk paket tersebut.
- REPOSITORY adalah nama repositori. Jika mengonfigurasi repositori default, Anda dapat menghilangkan tanda ini untuk menggunakan repositori default.
- LOCATION adalah lokasi regional atau multi-regional. Gunakan flag ini untuk melihat repositori di lokasi tertentu. Jika mengonfigurasi lokasi default, Anda dapat menghilangkan tanda ini untuk menggunakan lokasi default.
Menginstal paket
Mode repositori: standar, jarak jauh (pratinjau)
Sebelum menginstal paket, pastikan Anda telah mengonfigurasi pengelola dan repositori paket dengan benar.
Untuk menginstal paket di repositori:
Perbarui daftar paket yang tersedia:
sudo apt update
Instal paket, yang menentukan nama repositori yang dikonfigurasi di Apt.
sudo apt install PACKAGE/REPOSITORY
Ganti nilai berikut:
- PACKAGE adalah nama paket.
- REPOSITORY adalah nama repositori Artifact Registry. Untuk repositori jarak jauh, gunakan nama repositori upstream standar.
Misalnya, untuk menginstal paket
my-package
dari repositorimy-repo
, jalankan perintah:sudo apt install my-package -t my-repo
Menghapus paket
Mode repositori: standar
Sebelum menghapus paket atau versi paket, pastikan Anda telah mengomunikasikan atau mengatasi dependensi penting pada paket atau versi tersebut.
Untuk menghapus paket:
Konsol
Buka halaman Repositories di Konsol Google Cloud.
Dalam daftar repositori, klik repositori yang sesuai.
Halaman Packages mencantumkan paket dalam repositori.
Pilih paket yang ingin Anda hapus.
Klik HAPUS.
Di kotak dialog konfirmasi, klik HAPUS.
gcloud
Jalankan perintah berikut:
gcloud artifacts packages delete PACKAGE \
[--repository=REPOSITORY] [--location=LOCATION] [--async]
Dari mana
- PACKAGE adalah nama paket dalam repositori.
- REPOSITORY adalah nama repositori. Jika mengonfigurasi repositori default, Anda dapat menghilangkan tanda ini untuk menggunakan repositori default.
- LOCATION adalah lokasi regional atau multi-regional. Gunakan flag ini untuk melihat repositori di lokasi tertentu. Jika mengonfigurasi lokasi default, Anda dapat menghilangkan tanda ini untuk menggunakan lokasi default.
--async
Segera kembali, tanpa menunggu operasi yang sedang berlangsung selesai.
Untuk menghapus versi paket:
Konsol
Buka halaman Repositories di Konsol Google Cloud.
Dalam daftar repositori, klik repositori yang sesuai.
Halaman Packages mencantumkan paket dalam repositori.
Klik paket untuk melihat versi paket tersebut.
Pilih versi yang ingin Anda hapus.
Klik HAPUS.
Di kotak dialog konfirmasi, klik HAPUS.
gcloud
Jalankan perintah berikut:
gcloud artifacts versions delete VERSION \
--package=PACKAGE \
[--repository=REPOSITORY] [--location=LOCATION] \
[--async]
Dari mana
- PACKAGE adalah nama paket dalam repositori.
- REPOSITORY adalah nama repositori. Jika mengonfigurasi repositori default, Anda dapat menghilangkan tanda ini untuk menggunakan repositori default.
- LOCATION adalah lokasi regional atau multi-regional. Gunakan flag ini untuk melihat repositori di lokasi tertentu. Jika mengonfigurasi lokasi default, Anda dapat menghilangkan tanda ini untuk menggunakan lokasi default.
--async
segera ditampilkan, tanpa menunggu operasi yang sedang berlangsung selesai.
Untuk repositori besar, perlu waktu beberapa menit untuk membuat ulang indeks paket Apt guna mencerminkan penghapusan.