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 Bekerja dengan paket Debian.

Sebelum memulai

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

    Go to project selector

  2. Verify that billing is enabled for your Trusted Cloud project.

  3. Enable the Artifact Registry API.

    Enable the API

  4. Menginstal gcloud CLI

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

      gcloud components update
      

      Untuk memeriksa versi gcloud CLI Anda, jalankan perintah:

      gcloud version
      

    Membuat repositori

    Buat repositori untuk artefak Anda.

    1. Buat repositori:

      Konsol

      1. Buka halaman Repositories di konsol Trusted Cloud .

        Buka halaman Repositori

      2. Klik Create Repository.

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

      4. Pilih Apt sebagai format.

      5. Di bawah Jenis Lokasi, pilih Region dan kemudian 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.

    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 akan mengupload contoh file menggunakan perintah gcloud artifacts apt upload.

    1. Di Cloud Shell, download lembar referensi cepat Apt dengan perintah:

      apt download apt-dpkg-ref
      

      Apt akan mendownload versi terbaru paket yang tersedia dari repositori Apt yang Anda konfigurasi.

      Get:1 http://deb.debian.org/debian buster/main amd64 apt-dpkg-ref all 5.3.1+nmu2 [113 kB]
      Fetched 113 kB in 0s (428 kB/s)
      

      Jalankan ls untuk mendapatkan nama file lembar referensi cepat Apt. Nama file mirip dengan apt-dpkg-ref_5.3.1+nmu2_all.deb.

    2. Untuk menyederhanakan perintah gcloud, 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 menyetel repositori, jalankan perintah:

      gcloud config set artifacts/repository quickstart-apt-repo
      

      Untuk menyetel lokasi, jalankan perintah:

      gcloud config set artifacts/location u-france-east1
      

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

    3. 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 lembar referensi cepat Apt.

    Melihat paket di repositori

    Pastikan paket Anda telah ditambahkan ke repositori.

    Konsol

    1. Buka halaman Repositories di konsol Trusted Cloud .

      Buka halaman Repositori

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

      Halaman Paket 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
    

    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-10 \
        --image-project=debian-cloud \
        --scopes=cloud-platform
    

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

    Mengonfigurasi pengelola paket

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

    1. Buka halaman VM instances.

      Buka halaman instance VM

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

    3. Jalankan gcloud init untuk menginisialisasi Google Cloud CLI di VM Anda.

    4. Update Apt:

      sudo apt update
      
    5. Instal helper kredensial Apt di VM agar Apt dapat melakukan autentikasi:

      sudo apt install apt-transport-artifact-registry
      
    6. Konfigurasi 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 Trusted Cloud 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 di repositori Anda.

      sudo apt install apt-dpkg-ref/quickstart-apt-repo
      

      Informasi penginstalan yang ditampilkan akan terlihat seperti contoh berikut:

      Reading package lists... Done
      Building dependency tree
      Reading state information... Done
      Selected version '5.3.1+nmu2' (Debian:10.7/stable, namespaces/my-repo/repositories/quickstart-apt-repo:quickstart
      -apt-repo [all]) for 'apt-dpkg-ref'
      The following NEW packages will be installed:
        apt-dpkg-ref
      0 upgraded, 1 newly installed, 0 to remove and 3 not upgraded.
      Need to get 113 kB of archives.
      After this operation, 128 kB of additional disk space will be used.
      Get:1 http://deb.debian.org/debian buster/main amd64 apt-dpkg-ref all 5.3.1+nmu2 [113 kB]
      Fetched 113 kB in 0s (693 kB/s)
      Selecting previously unselected package apt-dpkg-ref.
      (Reading database ... 39506 files and directories currently installed.)
      Preparing to unpack .../apt-dpkg-ref_5.3.1+nmu2_all.deb ...
      Unpacking apt-dpkg-ref (5.3.1+nmu2) ...
      Setting up apt-dpkg-ref (5.3.1+nmu2) ...
      

    Pembersihan

    Agar akun Trusted Cloud Anda tidak dikenai biaya untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut.

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

    Untuk menghapus repositori:

    Konsol

    1. Buka halaman Repositories di konsol Trusted Cloud .

      Buka halaman Repositori

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

    3. Klik Hapus.

    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