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 dapat melakukan langkah-langkah dalam panduan memulai ini menggunakan Cloud Shell dan di shell pada VM yang Anda buat di panduan memulai ini.

Untuk mempelajari lebih lanjut cara mengelola paket Debian, lihat Bekerja dengan paket Debian.

Sebelum memulai

1. Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

2. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

3. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

4. Enable the Artifact Registry API.

   Enable the API

5. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

6. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

7. Enable the Artifact Registry API.

   Enable the API

Meluncurkan Cloud Shell

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

Meluncurkan Cloud Shell:

1. Buka Konsol Google Cloud.

   Google Cloud console

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 Create.

   Repositori ditambahkan ke daftar repositori.

   gcloud

   1. Di Cloud Shell, jalankan perintah berikut untuk membuat repositori Apt baru di project saat ini yang 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 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, upload 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 dikonfigurasi.

   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 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 lebih lanjut tentang perintah ini, baca 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. Dalam daftar repositori, klik repositori quickstart-apt-repo.

   Halaman Packages mencantumkan paket dalam repositori.

gcloud

Untuk mencantumkan paket dalam 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 sampel.

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. Tanda --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.

Catatan: VM yang Anda buat dalam panduan memulai ini menggunakan image OS Debian yang dibangun 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 yang dibuat Google, VM yang menggunakan OS image yang tidak dibuat oleh Google, atau VM di luar Google Cloud, ada langkah-langkah konfigurasi tambahan. Untuk mengetahui detailnya, lihat petunjuk konfigurasi VM lengkap.

1. Buka halaman VM instances.

   Buka halaman VM instances

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

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

4. {i>Update Apt<i}:

   sudo apt update
   

5. Instal helper kredensial Apt di VM untuk mengaktifkan Apt agar dapat melakukan autentikasi:

   sudo apt install apt-transport-artifact-registry
   

6. Konfigurasi 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 akun Google Cloud Anda tidak dikenakan biaya untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut.

Sebelum menghapus repositori, pastikan paket apa pun 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 Delete.

gcloud

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

   gcloud artifacts repositories delete quickstart-apt-repo
   

2. Jika Anda ingin menghapus repositori default dan setelan lokasi yang Anda konfigurasikan 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.