Menyimpan paket Apt di Artifact Registry

Panduan memulai ini menunjukkan cara menyiapkan repositori Apt Artifact Registry pribadi, menambahkan paket Debian ke repositori, dan menginstal paket di VM Compute Engine yang menjalankan sistem operasi berbasis Debian.

Untuk mempelajari lebih lanjut cara mengelola paket Debian, lihat Menggunakan paket Debian.

Sebelum memulai

  1. In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  2. If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

  3. Verify that billing is enabled for your Cloud de Confiance project.

  4. Enable the Artifact Registry API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk membuat dan mengelola repositori paket Apt Artifact Registry, minta administrator untuk memberi Anda peran IAM berikut di project Anda:

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Menginstal gcloud CLI

  1. Instal dan lakukan inisialisasi Google Cloud CLI jika belum diinstal. Untuk penginstalan yang ada, update komponen Google Cloud CLI dengan perintah:

    gcloud components update

    Untuk memeriksa versi gcloud CLI, jalankan perintah:

    gcloud version

Membuat repositori

Buat repositori untuk artefak Anda.

  1. Buat repositori:

    Konsol

    1. Buka halaman Repositories di Cloud de Confiance konsol.

      Buka halaman Repositori

    2. Klik Create Repository.

    3. Tentukan quickstart-apt-repo sebagai nama repositori.

    4. Pilih Apt sebagai format.

    5. Di bagian Location Type, pilih Region, lalu pilih lokasi u-france-east1.

    6. Klik Buat.

    Repositori ditambahkan ke daftar repositori.

    gcloud

    1. Di Cloud Shell, jalankan perintah berikut untuk membuat repositori Apt baru di project saat ini bernama quickstart-apt-repo di lokasi u-france-east1.

      gcloud artifacts repositories create quickstart-apt-repo \
    --repository-format=apt \
    --location=u-france-east1 \
    --description="Apt repository"

    2. Jalankan perintah berikut untuk memverifikasi bahwa repositori Anda telah dibuat:

      gcloud artifacts repositories list

Sekarang Anda dapat menambahkan paket ke repositori. Cloud Shell menggunakan image Ubuntu yang dibuat Google, bukan Debian. Untuk mengelola paket Debian di repositori, Anda akan menggunakan VM yang menggunakan image OS Debian.

Membuat VM

Buat VM Compute Engine baru tempat Anda akan menginstal paket contoh.

Di Cloud Shell, jalankan perintah berikut untuk membuat instance VM bernama quickstart-apt-vm:

gcloud compute instances create quickstart-apt-vm \
    --image-family=debian-12 \
    --image-project=debian-cloud \
    --scopes=cloud-platform

Secara default, VM tidak memiliki cakupan akses yang diperlukan untuk menggunakan repositori. Flag --scopes menetapkan cakupan akses untuk VM ke cloud-platform.

  1. Buka halaman VM instances.

    Buka halaman VM instances

  2. Di baris dengan VM Anda, klik SSH. Jendela baru akan terbuka dengan sesi terminal di VM.

Menambahkan paket ke repositori

Anda dapat mengupload paket ke repositori menggunakan Google Cloud CLI, atau Anda dapat mengimpor paket yang disimpan di Cloud Storage.

Untuk panduan memulai ini, Anda mengupload file contoh menggunakan perintah gcloud artifacts apt upload.

  1. Jalankan gcloud init untuk melakukan inisialisasi Google Cloud CLI di VM Anda.

  2. Update Apt:

    sudo apt update

  3. Download paket curl dengan perintah:

    apt download curl

    Apt mendownload versi terbaru paket yang tersedia dari repositori Apt yang dikonfigurasi.

    Get:1 file:/etc/apt/mirrors/debian.list Mirrorlist [30 B]
Get:2 https://deb.debian.org/debian bookworm/main amd64 curl amd64 7.88.1-10+deb12u14 [316 kB]
Fetched 316 kB in 0s (3078 kB/s)

    Jalankan ls untuk mendapatkan nama file paket curl. Nama filenya mirip dengan curl_7.88.1-10+deb12u14_amd64.deb.

  4. Untuk menyederhanakan gcloud perintah, tetapkan repositori default ke quickstart-apt-repo dan lokasi default ke u-france-east1. Setelah nilai ditetapkan, Anda tidak perlu menentukannya dalam perintah gcloud yang memerlukan repositori atau lokasi.

    Untuk menetapkan repositori, jalankan perintah:

    gcloud config set artifacts/repository quickstart-apt-repo

    Untuk menetapkan lokasi, jalankan perintah:

    gcloud config set artifacts/location u-france-east1

    Untuk mengetahui informasi selengkapnya tentang perintah ini, lihat dokumentasi gcloud config set.

  5. Jalankan gcloud artifacts apt upload untuk mengupload paket ke repositori:

    gcloud artifacts apt upload quickstart-apt-repo \
    --source=FILE_NAME

    Ganti FILE_NAME dengan jalur ke paket curl.

Melihat paket di repositori

Pastikan paket Anda telah ditambahkan ke repositori.

Konsol

  1. Buka halaman Repositories di Cloud de Confiance konsol.

    Buka halaman Repositori

  2. Di daftar repositori, klik repositori quickstart-apt-repo.

    Halaman Packages mencantumkan paket di repositori.

gcloud

Untuk mencantumkan paket di repositori quickstart-apt-repo, jalankan perintah:

 gcloud artifacts packages list

Untuk melihat versi paket di quickstart-apt-repo, jalankan perintah:

gcloud artifacts versions list --package=apt-dpkg-ref

Mengonfigurasi pengelola paket

Untuk menginstal paket di VM, tambahkan repositori yang Anda buat ke file konfigurasi Apt yang menentukan repositori paket.

  1. Instal helper kredensial Apt di VM untuk mengaktifkan Apt melakukan autentikasi:

    sudo apt install apt-transport-artifact-registry

  2. Konfigurasikan VM Anda untuk mengakses paket Artifact Registry:

    echo 'deb ar+https://u-france-east1-apt.s3nsregistry.fr/projects/PROJECT quickstart-apt-repo main' | sudo tee -a  /etc/apt/sources.list.d/artifact-registry.list

    Ganti PROJECT dengan Cloud de Confiance by S3NS project ID Anda.

Menginstal paket

Instal paket yang Anda tambahkan ke repositori.

  1. Perbarui daftar paket yang tersedia:

    sudo apt update

  2. Instal paket dari repositori Anda.

    sudo apt install curl/quickstart-apt-repo

    Informasi penginstalan yang ditampilkan akan terlihat seperti contoh berikut:

    Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
Selected version '7.88.1-10+deb12u14' (quickstart-apt-repo:quickstart-apt-repo, Debian:12.12/oldstable [amd64]) for 'curl'
The following additional packages will be installed:
  libcurl3-gnutls libcurl4
The following packages will be upgraded:
  curl libcurl3-gnutls libcurl4
3 upgraded, 0 newly installed, 0 to remove and 77 not upgraded.
Need to get 1093 kB of archives.
After this operation, 0 B of additional disk space will be used.
Do you want to continue? [Y/n] y
Get:1 file:/etc/apt/mirrors/debian.list Mirrorlist [30 B]
Get:2 https://deb.debian.org/debian bookworm/main amd64 libcurl4 amd64 7.88.1-10+deb12u14 [392 kB]
Get:3 https://deb.debian.org/debian bookworm/main amd64 libcurl3-gnutls amd64 7.88.1-10+deb12u14 [386 kB]
Get:4 ar+https://u-france-east1-apt.pkg.dev/projects/PROJECT quickstart-apt-repo/main amd64 curl amd64 7.88.1-10+deb12u14 [316 kB]
Fetched 1093 kB in 1s (947 kB/s)
Reading changelogs... Done
(Reading database ... 72080 files and directories currently installed.)
Preparing to unpack .../curl_7.88.1-10+deb12u14_amd64.deb ...
Unpacking curl (7.88.1-10+deb12u14) over (7.88.1-10+deb12u12) ...
Preparing to unpack .../libcurl4_7.88.1-10+deb12u14_amd64.deb ...
Unpacking libcurl4:amd64 (7.88.1-10+deb12u14) over (7.88.1-10+deb12u12) ...
Preparing to unpack .../libcurl3-gnutls_7.88.1-10+deb12u14_amd64.deb ...
Unpacking libcurl3-gnutls:amd64 (7.88.1-10+deb12u14) over (7.88.1-10+deb12u12) ...
Setting up libcurl3-gnutls:amd64 (7.88.1-10+deb12u14) ...
Setting up libcurl4:amd64 (7.88.1-10+deb12u14) ...
Setting up curl (7.88.1-10+deb12u14) ...
Processing triggers for man-db (2.11.2-2) ...
Processing triggers for libc-bin (2.36-9+deb12u10) ...

Pembersihan

Agar akunAnda tidak dikenai biaya untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut. Cloud de Confiance

Sebelum menghapus repositori, pastikan paket yang ingin Anda simpan tersedia di lokasi lain.

Untuk menghapus repositori:

Konsol

  1. Buka halaman Repositories di Cloud de Confiance konsol.

    Buka halaman Repositories

  2. Di daftar repositori, pilih repositori quickstart-apt-repo.

  3. Klik Delete.

gcloud

  1. Untuk menghapus repositori quickstart-apt-repo, jalankan perintah berikut:

    gcloud artifacts repositories delete quickstart-apt-repo

  2. Jika Anda ingin menghapus setelan repositori dan lokasi default yang Anda konfigurasi untuk konfigurasi gcloud aktif, jalankan perintah berikut:

    gcloud config unset artifacts/repository
gcloud config unset artifacts/location

Untuk menghapus VM yang Anda buat, jalankan perintah berikut:

gcloud compute instances delete quickstart-apt-vm

Langkah berikutnya