Mengonfigurasi VM untuk menginstal paket RPM

Halaman ini menjelaskan cara mengonfigurasi VM untuk menginstal paket RPM dari repositori Yum Artifact Registry. Repositori Yum Artifact Registry mendukung klien yum dan dnf.

Sebelum memulai

Jika repositori Yum target tidak ada, buat repositori baru. Anda dapat membuat repositori pribadi atau repositori publik yang tidak memerlukan autentikasi.

Menyiapkan VM untuk mengakses repositori Yum

Untuk menyiapkan VM agar dapat mengakses repositori Yum, gunakan alat klien yum atau dnf:

Repositori pribadi

1. Pilih akun layanan yang akan Anda gunakan untuk memberikan akses.

   • Untuk VM Compute Engine, akun ini mungkin berupa akun layanan default. Artifact Registry otomatis mengambil kredensial akun layanan VM Compute Engine untuk VM apa pun yang menggunakan akun layanan.
   • Untuk VM lain, buat atau pilih akun layanan untuk bertindak atas nama VM Anda. Anda memerlukan lokasi file kunci akun layanan untuk mengonfigurasi VM. Anda dapat melihat dan membuat kunci untuk akun yang ada di halaman Service Accounts.

2. Berikan izin akses repositori ke akun layanan Anda.

3. Siapkan VM untuk mengakses repositori.

   VM Compute Engine

   1. Tetapkan cakupan akses API cloud-platform ke VM. Untuk mengetahui informasi tentang cara menetapkan cakupan akses, lihat Mengubah akun layanan dan cakupan akses untuk instance.

   2. Update cache paket menggunakan perintah berikut:

      sudo yum makecache
      

   3. Instal plugin Artifact Registry di VM menggunakan perintah berikut:

      sudo yum install FORMAT-plugin-artifact-registry
      

      Ganti kode berikut:

      • FORMAT dengan salah satu dari berikut ini:
        • yum, jika sistem operasi Anda adalah Enterprise Linux 7 atau versi yang lebih lama
        • dnf, jika sistem operasi Anda adalah Enterprise Linux 8 atau yang lebih baru

   VM lainnya

   1. Instal kunci penandatanganan RPM menggunakan perintah berikut:

      sudo rpm --import https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
      

   2. Buat file bernama /etc/yum.repos.d/artifact-registry-plugin.repo dengan konten berikut:

      [ar-plugin]
      name=Artifact Registry Plugin
      baseurl=https://packages.cloud.google.com/yum/repos/FORMAT-plugin-artifact-registry-DISTRO-stable
      enabled=1
      gpgcheck=1
      

      Ganti kode berikut:

      • FORMAT dengan salah satu dari berikut ini:
        • yum, jika sistem operasi Anda adalah Enterprise Linux 7 atau versi yang lebih lama
        • dnf, jika sistem operasi Anda adalah Enterprise Linux 8 atau yang lebih baru
      • DISTRO dengan rilis utama Red Hat Enterprise Linux dalam format elX, dengan X adalah versi rilis. Contoh nilai DISTRO yang valid adalah el7 dan el8.

   3. Update Yum menggunakan perintah berikut:

      sudo yum makecache
      

   4. Instal plugin Artifact Registry di VM menggunakan perintah berikut:

      yum install FORMAT-plugin-artifact-registry
      

      Ganti FORMAT dengan salah satu dari berikut ini:

      • yum, jika sistem operasi Anda adalah Enterprise Linux 7 atau versi yang lebih lama
      • dnf, jika sistem operasi Anda adalah Enterprise Linux 8 atau yang lebih baru

   5. Temukan baris #service_account_json = "/path/to/creds.json" dalam file artifact-registry.conf, lalu hapus komentar baris dan tambahkan jalur kunci akun layanan Anda.

      • Untuk sistem operasi Enterprise Linux 7 atau yang lebih lama, jalur ke file konfigurasi adalah /etc/yum/pluginconf.d/artifact-registry.conf.
      • Untuk sistem operasi Enterprise Linux 8 atau yang lebih baru, jalur ke file konfigurasi adalah /etc/dnf/plugins/artifact-registry.conf.

      Entri file konfigurasi:

      service_account_json = "PATH_TO_SERVICE_ACCOUNT_KEY"
      

      Ganti PATH_TO_SERVICE_ACCOUNT_KEY dengan jalur ke file JSON kunci akun layanan Anda.

Repositori publik

Konfigurasi akses publik ke repositori.

Mengonfigurasi VM untuk mengakses repositori Yum standar

Untuk mengonfigurasi VM agar dapat mengakses repositori Yum, gunakan alat klien yum atau dnf:

1. Buat perintah konfigurasi VM dengan menjalankan perintah gcloud beta artifacts print-settings yum:

   gcloud beta artifacts print-settings yum \
       --repository=REPOSITORY \
       --location=LOCATION
   

   Ganti kode berikut:

   • REPOSITORY adalah nama repositori Artifact Registry.
   • LOCATION adalah lokasi repositori regional atau multi-regional.

   Outputnya mirip dengan hal berikut ini:

   # To configure your package manager with this repository:
   
   # Update Yum:
   sudo yum makecache
   
   # Install the Yum credential helper:
   sudo yum install yum-plugin-artifact-registry
   
   # Configure your VM to access Artifact Registry packages using the following
   # command:
   
   sudo tee -a /etc/yum.repos.d/artifact-registry.repo << EOL
   [REPOSITORY]
   name=REPOSITORY
   baseurl=https://LOCATION-yum.pkg.dev/projects/PROJECT/REPOSITORY
   enabled=1
   repo_gpgcheck=0
   gpgcheck=0
   EOL
   
   # Update Yum:
   sudo yum makecache
   

2. Konfigurasi alat klien yum untuk mengambil paket dari repositori Anda menggunakan perintah tee dari output perintah print-settings.

   Misalnya, untuk menginstal paket dari my-repo publik di project my-project dan di lokasi us-west1, gunakan perintah berikut:

   sudo tee -a /etc/yum.repos.d/artifact-registry.repo << EOL
   [my-repo]
   name=My Repository
   baseurl=https://us-west1-yum.pkg.dev/projects/my-project/my-repo
   enabled=1
   repo_gpgcheck=0
   gpgcheck=0
   EOL
   

   Catatan: Validasi GPG tingkat repositori Yum, menggunakan repo_gpgcheck, tidak didukung untuk repositori Artifact Registry. Repositori Artifact Registry ditayangkan melalui HTTPS (menggunakan sertifikat SSL), dan penayangan melalui HTTPS dianggap lebih tepercaya.

3. Perbarui sumber repositori Anda dengan perintah berikut:

   sudo yum makecache
   

Yum kini dapat terhubung ke repositori.

Jika Anda membuat repositori Yum tambahan, buat file .repo untuk setiap repositori di /etc/yum.repos.d/. Jalankan ulang sudo yum update untuk memperbarui sumber repositori.

Mengonfigurasi VM untuk mengakses repositori Yum jarak jauh

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Untuk mengonfigurasi VM agar hanya menggunakan repositori Yum jarak jauh, bukan repositori Yum upstream standar, ganti repositori standar dalam daftar repositori VM dengan repositori jarak jauh.

Jika repositori standar ditentukan dalam file konfigurasi, bukan file repositori terpisah (.repo), Anda dapat menghapus entri dalam file konfigurasi dan menggantinya dengan repositori jarak jauh, atau menentukan file repositori baru di direktori /etc/yum.repos.d/.

Peringatan: Mengurutkan ulang dan menghapus repositori dari file konfigurasi untuk Yum dapat menimbulkan konsekuensi serius. Jika tidak yakin ingin menghapus repositori standar, Anda dapat mengonfigurasi Yum untuk menggunakan repositori Yum jarak jauh sebagai cadangan.

1. Buka halaman instance VM.

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

3. Buka folder /etc/yum.repos.d/ VM dan temukan file repositori (.repo) yang sesuai yang berisi repositori upstream standar. Hal ini terkadang disebut sebagai repositori dasar. Repositori dasar dapat diidentifikasi berdasarkan nama repositori Yum yang berisi [base] atau [baseos].

4. Untuk mengganti repositori dasar sepenuhnya, hapus setelan default di bagian [base] atau [baseos]. Jika Anda ingin mempertahankan repositori upstream standar dan menambahkan repositori jarak jauh sebagai opsi penggantian, jangan hapus setelan default.

5. Tambahkan setelan berikut di bagian [base] atau [baseos]:

   name=YUM_REPOSITORY_NAME
   baseurl=https://LOCATION-yum.pkg.dev/remote/PROJECT_ID/REMOTE_REPOSITORY_NAME
   enabled=1
   gpgcheck=1
   

   Ganti kode berikut:

• YUM_REPOSITORY_NAME dengan ID repositori unik satu kata untuk repositori Yum jarak jauh Anda. Nama ini dapat cocok dengan nama repositori upstream jika Anda telah menghapus konfigurasi repositori upstream standar, atau jika Anda mempertahankan repositori upstream standar, maka Anda dapat menggunakan nama yang berbeda untuk mengidentifikasinya sebagai repositori jarak jauh.
• LOCATION adalah lokasi repositori regional atau multi-regional.
• PROJECT_ID dengan project ID VM.
• REMOTE_REPOSITORY_NAME dengan nama yang dapat dibaca manusia dari repositori jarak jauh.

Catatan: Validasi GPG tingkat repositori Yum, menggunakan repo_gpgcheck, tidak didukung untuk repositori Artifact Registry. Repositori Artifact Registry ditayangkan melalui HTTPS (menggunakan sertifikat SSL), dan penayangan melalui HTTPS dianggap lebih tepercaya.

Menggunakan repositori Yum jarak jauh sebagai cadangan

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Jika ingin mempertahankan upstream standar sebagai opsi pertama dan menambahkan repositori jarak jauh sebagai opsi penggantian, Anda dapat mempertahankan upstream standar di file repositori, dan membuat file repositori baru di folder /etc/yum.repos.d.

Untuk membuat file repositori baru di folder /etc/yum.repos.d, jalankan perintah berikut:

sudo tee -a /etc/yum.repos.d/artifact-registry.repo << EOF
[YUM_REPOSITORY_NAME]
name=REPOSITORY_NAME
baseurl=https://LOCATION-yum.pkg.dev/remote/PROJECT_ID/REMOTE_REPOSITORY_NAME
enabled=1
gpgcheck=1
EOF

Ganti kode berikut:

• Ganti YUM_REPOSITORY_NAME dengan ID repositori unik satu kata untuk repositori Yum jarak jauh Anda.
• REPOSITORY_NAME dengan nama repositori yang dapat dibaca manusia.
• LOCATION dengan lokasi regional atau multi-regional repositori jarak jauh.
• PROJECT_ID dengan project ID VM.
• REMOTE_REPOSITORY_NAME dengan nama yang Anda berikan untuk repositori jarak jauh.

Misalnya, perintah berikut mengonfigurasi VM untuk mengambil repositori my-repo di project my-project dan lokasi us-west1 saat Yum menginstal repositori my-repo.

Catatan: YUM_REPOSITORY_NAME dan Artifact Registry REMOTE_REPOSITORY_NAME dapat berbeda, tetapi YUM_REPOSITORY_NAME digunakan dalam pelaporan error, jadi sebaiknya tetap sama dengan nama repositori.

sudo tee -a /etc/yum.repos.d/artifact-registry.repo << EOF
[my-repo]
name=My Repository
baseurl=https://us-west1-yum.pkg.dev/remote/my-project/my-repo
enabled=1
gpgcheck=1
EOF

Langkah berikutnya

• Pelajari cara mengelola paket