Mengonfigurasi VM untuk menginstal paket Debian

Halaman ini menjelaskan cara mengonfigurasi VM untuk menginstal paket Debian dari repositori Apt Artifact Registry.

Sebelum memulai

Jika repositori Apt target tidak ada, buat repositori standar baru. 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 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

    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 regional repositori.

    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 regional repositori.

    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 hilangkan komentar pada baris tersebut 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 Cloud de Confiance, 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 regional repositori.

  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 regional repositori.
    • 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 u-france-east1, gunakan perintah berikut:

    echo 'deb ar+https://u-france-east1-apt.pkg.dev/projects/my-project my-repo main'

  3. Perbarui sumber repositori Anda dengan perintah berikut:

    sudo apt update

Apt sekarang 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 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.

  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 regional repositori.
    • 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 u-france-east1 menggunakan HTTP, gunakan perintah berikut:

    echo 'deb http://u-france-east1-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 sekarang 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