Mengonfigurasi VM untuk menginstal paket Debian

Mengonfigurasi instance virtual machine (VM) untuk terhubung ke repositori Apt Artifact Registry memungkinkan Anda menginstal dan mengupdate paket Debian menggunakan alat Apt standar. Anda dapat menyiapkan autentikasi dan sumber repositori untuk VM Compute Engine guna menarik paket dari repositori pribadi atau publik.

Sebelum memulai

Jika repositori Apt target tidak ada, buat repositori standar atau jarak jauh. Anda dapat membuat repositori pribadi, atau repositori publik yang tidak memerlukan autentikasi.

Menyiapkan VM untuk mengakses repositori Apt

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 lain, buat atau pilih akun layanan yang akan 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

   VM Debian

   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. Perbarui Apt menggunakan perintah berikut:

      sudo apt update
      

   3. Instal paket apt-transport-artifact-registry di VM:

      sudo apt install apt-transport-artifact-registry
      

   VM Ubuntu

   1. Instal kunci penandatanganan repositori Apt menggunakan perintah berikut:

      curl https://LOCATION-apt.pkg.dev/doc/repo-signing-key.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/artifact-registry.gpg && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/google-cloud-sdk.gpg
      

      Ganti LOCATION dengan lokasi repositori regional atau multi-regional.

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

   3. Konfigurasi VM Anda untuk mengakses paket Artifact Registry menggunakan perintah berikut:

      echo 'deb http://packages.cloud.google.com/apt apt-transport-artifact-registry-stable main' | sudo tee -a /etc/apt/sources.list.d/artifact-registry.list
      

   4. Perbarui Apt menggunakan perintah berikut:

      sudo apt update
      

   5. Instal paket apt-transport-artifact-registry di VM:

      sudo apt install apt-transport-artifact-registry
      

   VM lainnya

   1. Instal kunci penandatanganan repositori Apt menggunakan perintah berikut:

      curl https://LOCATION-apt.pkg.dev/doc/repo-signing-key.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/artifact-registry.gpg && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/google-cloud-sdk.gpg
      

      Ganti LOCATION dengan lokasi repositori regional atau multi-regional.

   2. Konfigurasi VM Anda untuk mengakses paket Artifact Registry menggunakan perintah berikut:

      echo 'deb http://packages.cloud.google.com/apt apt-transport-artifact-registry-stable main' | sudo tee -a /etc/apt/sources.list.d/artifact-registry.list
      

   3. Perbarui Apt menggunakan perintah berikut:

      sudo apt update
      

   4. Instal paket apt-transport-artifact-registry di VM:

      sudo apt install apt-transport-artifact-registry
      

   5. Temukan baris #Service-Account-JSON "/path/to/creds.json"; dalam file /etc/apt/apt.conf.d/90artifact-registry, lalu hapus tanda komentar baris dan tambahkan jalur kunci akun layanan Anda.

      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

1. Konfigurasi akses publik ke repositori.

2. Jika Anda mengonfigurasi VM di luar Google Cloud, siapkan mesin Anda untuk mengakses repositori. Jika Anda mengonfigurasi VM Compute Engine, lanjutkan ke langkah berikutnya.

   Instal kunci verifikasi tanda tangan publik menggunakan perintah berikut:

   curl https://LOCATION-apt.pkg.dev/doc/repo-signing-key.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/artifact-registry.gpg
   

   Ganti LOCATION dengan lokasi repositori regional atau multi-regional.

3. Perbarui Apt menggunakan perintah berikut:

   sudo apt update
   

Mengonfigurasi VM untuk mengakses repositori Apt standar

Mengonfigurasi VM untuk mengakses repositori Apt:

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

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

   Ganti kode berikut:

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

   Outputnya mirip dengan hal berikut ini:

   # To configure your package manager with this repository:
   
   # Update Apt:
   sudo apt update
   
   # Install the Apt credential helper:
   sudo apt install apt-transport-artifact-registry
   
   # Configure your VM to access Artifact Registry packages using the following
   # command:
   
   echo "deb [signed-by=/etc/apt/trusted.gpg.d/artifact-registry.gpg] ar+https://LOCATION-apt.pkg.dev/projects/PROJECT REPOSITORY main" | sudo tee -a /etc/apt/sources.list.d/artifact-registry.list
   
   # Update Apt:
   sudo apt update
   

2. Konfigurasi Apt untuk mengambil paket dari repositori Anda menggunakan perintah echo dari output perintah print-settings.

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

   echo 'deb ar+https://us-west1-apt.pkg.dev/projects/my-project my-repo main'
   

3. Perbarui sumber repositori Anda dengan perintah berikut:

   sudo apt update
   

Apt kini dapat terhubung ke repositori.

Jika membuat repositori Apt tambahan, Anda dapat menambahkannya ke file artifact-registry.list, lalu menjalankan kembali sudo apt update untuk memperbarui sumber repositori.

Mengonfigurasi VM untuk mengakses repositori Apt 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 Apt jarak jauh, bukan repositori Apt upstream standar, ganti repositori standar dengan repositori jarak jauh Anda di file /etc/apt/sources.list VM.

Peringatan: Mengatur ulang urutan dan menghapus repositori dari file sources.list dapat menimbulkan konsekuensi serius. Jika tidak yakin ingin menghapus repositori standar, Anda dapat mengonfigurasi Apt untuk menggunakan repositori Apt jarak jauh sebagai cadangan.

1. Berikan izin tulis Artifact Registry di seluruh project ke akun layanan Compute Engine default:

    gcloud projects add-iam-policy-binding PROJECT_ID \
      --member=serviceAccount:[e-mail] \
      --role=roles/artifactregistry.writer
   

2. Buka halaman VM instances.

3. Di baris dengan VM Anda, klik SSH.

   Jendela baru akan terbuka dengan sesi terminal di VM.

4. Buka file /etc/apt/sources.list VM dan temukan repositori standar yang ingin Anda ganti dengan repositori jarak jauh baru.

5. Hapus baris repositori standar, dan ganti dengan yang berikut:

   deb ar+https://LOCATION-apt.pkg.dev/remote/PROJECT_ID/REMOTE_REPOSITORY_NAME UPSTREAM_REPOSITORY_NAME COMPONENTS
   

   Ganti kode berikut:

   • LOCATION dengan lokasi regional atau multi-regional repositori jarak jauh.
   • PROJECT_ID dengan project ID VM.
   • REMOTE_REPOSITORY_NAME dengan nama yang Anda berikan ke repositori jarak jauh Anda.
   • UPSTREAM_REPOSITORY_NAME dengan nama repositori upstream untuk remote Anda.
   • COMPONENTS dengan daftar nama komponen yang dipisahkan spasi.

   Misalnya, berikut mengonfigurasi VM untuk mengambil paket dari repositori my-repo di project my-project di lokasi us-east1 menggunakan stable sebagai repositori upstream untuk komponen main, contrib, dan non-free.

   deb ar+https://us-east1-apt.pkg.dev/remote/my-project/my-repo stable main contrib non-free
   

6. Perbarui sumber repositori Anda dengan perintah berikut:

   sudo apt update
   

   Apt kini dapat terhubung ke repositori.

Menggunakan repositori Apt 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 pengganti, Anda dapat mempertahankan upstream standar di file sources.list, dan menambahkan repositori jarak jauh ke akhir file sources.list, atau membuat daftar baru di folder sources.list.d.

Untuk membuat file artifact-registry.list baru di folder sources.list.d, jalankan perintah berikut:

echo 'deb ar+https://LOCATION-apt.pkg.dev/remote/PROJECT_ID/REMOTE_REPOSITORY_NAME UPSTREAM_REPOSITORY_NAME COMPONENTS' | sudo tee -a  /etc/apt/sources.list.d/artifact-registry.list

Ganti kode berikut:

• LOCATION adalah lokasi repositori regional atau multi-regional.
• PROJECT_ID dengan project ID VM.
• REMOTE_REPOSITORY_NAME dengan nama yang Anda berikan ke repositori jarak jauh Anda.
• UPSTREAM_REPOSITORY_NAME dengan nama repositori upstream untuk remote Anda.
• COMPONENTS dengan daftar nama komponen yang dipisahkan dengan spasi.

Jika membuat repositori Apt tambahan, Anda dapat menambahkannya ke file artifact-registry.list atau sources.list, lalu menjalankan kembali sudo apt update untuk memperbarui sumber repositori.

Mengonfigurasi akses HTTP ke repositori Apt

Jika menggunakan alat klien lama yang tidak mendukung enkripsi SSL, Anda dapat mengonfigurasi akses publik ke repositori Apt dan mengaksesnya melalui HTTP. Permintaan yang dikirim ke repositori yang dapat dibaca publik menggunakan HTTP akan ditolak jika token autentikasi disertakan dalam permintaan.

1. Konfigurasi akses publik ke repositori.

   Catatan: Akses HTTP hanya diaktifkan untuk repositori yang dapat dibaca secara publik.

2. Untuk mengonfigurasi Apt agar mengambil paket dari repositori Anda menggunakan HTTP, jalankan perintah berikut:

    echo 'deb http://LOCATION-apt.pkg.dev/projects/PROJECT_ID \
    REPOSITORY main' | sudo tee -a /etc/apt/sources.list.d/artifact-registry.list
   

   Ganti kode berikut:

   • LOCATION adalah lokasi repositori regional atau multi-regional.
   • PROJECT_ID adalah project ID repositori.
   • REPOSITORY adalah nama repositori.

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

   echo 'deb http://us-west1-apt.pkg.dev/projects/my-project my-repo main' | sudo tee -a /etc/apt/sources.list.d/artifact-registry.list
   

3. Perbarui sumber repositori Anda dengan perintah berikut:

   sudo apt update
   

Apt kini dapat terhubung ke repositori.

Jika membuat repositori Apt tambahan, Anda dapat menambahkannya ke file artifact-registry.list, lalu menjalankan kembali sudo apt update untuk memperbarui sumber repositori.

Langkah berikutnya

• Mempelajari cara mengelola paket Debian