Menyimpan paket Apt di Artifact Registry

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.

Anda akan melakukan langkah-langkah dalam panduan memulai ini menggunakan Cloud Shell dan di shell pada VM yang Anda buat dalam panduan memulai ini.

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

Sebelum memulai

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Artifact Registry API.

   Enable the API

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Artifact Registry API.

   Enable the API

Meluncurkan Cloud Shell

Cloud Shell telah diinstal dengan Google Cloud CLI. Gcloud CLI menyediakan antarmuka command line utama untuk Google Cloud.

Meluncurkan Cloud Shell:

1. Buka Konsol Google Cloud.

   Konsol Google Cloud

2. Di toolbar Konsol Google Cloud, klik Activate Cloud Shell:

Sesi Cloud Shell akan terbuka di dalam frame yang lebih rendah di konsol. Anda akan menggunakan shell ini untuk menjalankan perintah gcloud guna membuat VM dan repositori.

Membuat repositori

Buat repositori untuk artefak Anda.

1. Buat repositori:

   Konsol

   1. Buka halaman Repositories di konsol Google 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 us-central1.

   6. Klik Buat.

   Repositori ditambahkan ke daftar repositori.

   gcloud

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

      gcloud artifacts repositories create quickstart-apt-repo \
          --repository-format=apt \
          --location=us-central1 \
          --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. Jika Anda mem-build paket menggunakan Cloud Build, build dapat menyimpan paket di Cloud Storage untuk Anda impor.

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

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

   apt download apt-dpkg-ref
   

   Apt 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 sheet referensi cepat Apt. Nama filenya 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 us-central1. 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 us-central1
   

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

Melihat paket di repositori

Pastikan paket Anda telah ditambahkan ke repositori.

Konsol

1. Buka halaman Repositories di konsol Google 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 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.

Catatan: VM yang Anda buat dalam panduan memulai ini menggunakan image OS Debian yang dibuat oleh Google, yang telah dikonfigurasi sebelumnya dengan beberapa setelan untuk mengakses repositori Artifact Registry. Jika Anda ingin mengonfigurasi VM Compute Engine yang menggunakan image Ubuntu buatan Google, VM yang menggunakan image OS yang tidak dibuat oleh Google, atau VM di luar Google Cloud, ada langkah konfigurasi tambahan. Untuk mengetahui detailnya, lihat petunjuk konfigurasi VM lengkap.

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 melakukan inisialisasi 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. Konfigurasikan VM Anda untuk mengakses paket Artifact Registry menggunakan perintah berikut:

   echo 'deb ar+https://us-central1-apt.pkg.dev/projects/PROJECT quickstart-apt-repo main' | sudo tee -a  /etc/apt/sources.list.d/artifact-registry.list
   

   Ganti PROJECT dengan project ID Google Cloud 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 tidak menimbulkan biaya pada akun Google Cloud Anda untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut.

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

Untuk menghapus repositori:

Konsol

1. Buka halaman Repositories di konsol Google 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 dikonfigurasi 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 selanjutnya

• Pelajari cara menggunakan paket Deb.
• Baca sumber daya kami tentang DevOps dan jelajahi program penelitian kami.