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 secara otomatis mengambil kredensial akun layanan VM Compute Engine untuk VM apa pun yang menggunakan akun layanan.
    • Untuk VM lainnya, buat atau pilih akun layanan untuk bertindak atas nama VM Anda. Anda akan 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 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 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 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 regional repositori.

    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.s3nsregistry.fr/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 u-france-east1, gunakan perintah berikut:

    sudo tee -a /etc/yum.repos.d/artifact-registry.repo << EOL
[my-repo]
name=My Repository
baseurl=https://u-france-east1-yum.s3nsregistry.fr/projects/my-project/my-repo
enabled=1
repo_gpgcheck=0
gpgcheck=0
EOL

  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.

Langkah berikutnya