Kelola lisensi

Dokumen ini menjelaskan cara mengelola lisensi yang terkait dengan instance Compute Engine. Hal ini mencakup cara menambahkan, menghapus, mengganti, dan melihat histori pembaruan lisensi. Untuk mengetahui informasi selengkapnya tentang lisensi di Compute Engine, lihat Tentang lisensi.

Batasan untuk mengelola lisensi:

  • Anda hanya dapat menambahkan lisensi ke disk jika AppendableToDisk adalah true.
  • Anda hanya dapat menghapus (tanpa penggantian) jika RemovableFromDisk adalah true.
  • Anda hanya dapat mengganti lisensi dengan salah satu pengganti yang tercantum di AllowedReplacementLicenses.

Untuk Ubuntu LTS, guna mengupgrade lisensi Anda ke Ubuntu Pro untuk mengaktifkan Extended Security Maintenance (ESM), lihat Mengupgrade dari Ubuntu ke Ubuntu Pro.

Untuk mengupdate lisensi RHEL on-demand Anda agar menyertakan dukungan yang diperpanjang, lihat Menambahkan Add-On RHEL Extended Lifecycle Support (ELS) ke lisensi Anda.

Sebelum memulai

  • Jika Anda belum melakukannya, siapkan autentikasi. Autentikasi adalah proses yang digunakan untuk memverifikasi identitas Anda untuk mengakses Trusted Cloud by S3NS layanan dan API. Untuk menjalankan kode atau sampel dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine dengan memilih salah satu opsi berikut:

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.

    gcloud

    1. Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:

      gcloud init
    2. Set a default region and zone.

    REST

    Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, Anda menggunakan kredensial yang Anda berikan ke gcloud CLI.

      Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:

      gcloud init

    Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Trusted Cloud .

Bersiap untuk memperbarui lisensi disk

Untuk memperbarui lisensi disk saat disk terpasang ke instance yang sedang berjalan, hentikan instance atau lepaskan disk terlebih dahulu.

  • Hentikan instance. Menghentikan instance untuk sementara sebelum memperbarui lisensi disk.
  • Lepaskan disk. Tindakan ini melepaskan disk dari instance sebelum memperbarui lisensi disk.

Melihat lisensi yang terkait dengan VM

Untuk melihat lisensi yang terkait dengan VM, gunakan Trusted Cloud konsol, gcloud CLI, atau Compute Engine API.

Konsol

  1. Di konsol Trusted Cloud , buka halaman VM instances.

    Buka instance VM

  2. Klik nama VM untuk memeriksa lisensinya. Halaman Detail instance akan terbuka.

  3. Di bagian bawah halaman Instance details, klik Equivalent Code.

  4. Lihat kolom licenses untuk boot disk.

gcloud

  1. Jalankan perintah gcloud compute instances describe berikut:

    gcloud compute instances describe VM_NAME
    

    Ganti VM_NAME dengan nama VM Anda.

  2. Lihat bagian disks dari output. Kolom licenses menampilkan lisensi yang terkait dengan disk booting.

REST

Panggil metode v1 instances.get:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/instancesVM_NAME

Ganti kode berikut:

  • PROJECT: nama project
  • ZONE: zona yang berisi VM
  • VM_NAME: nama VM

Compute Engine API menampilkan lisensi yang terkait dengan disk boot di bagian disks kolom licenses.

Menambahkan lisensi selama impor gambar

Untuk menambahkan lisensi selama proses impor image, gunakan perintah gcloud compute images import berikut.

gcloud compute images import IMAGE_NAME \
  --source-file=SOURCE_FILE
  --os=OS

Ganti kode berikut:

  • IMAGE_NAME: nama image yang akan dibuat.
  • SOURCE_FILE: file lokal atau URI Cloud Storage dari disk virtual yang akan diimpor.
  • OS: OS disk image yang akan diimpor. Lisensi untuk OS disimpulkan dari nilai flag ini; tidak ada flag eksplisit untuk memberikan informasi lisensi saat mengimpor. Untuk mengetahui daftar nilai yang didukung, lihat flag --os.

Untuk mengetahui informasi selengkapnya tentang cara mengimpor image, lihat Mengimpor disk virtual.

Menambahkan lisensi saat membuat image

Untuk menambahkan lisensi saat membuat image, gunakan perintah gcloud compute images create berikut.

gcloud compute images create IMAGE_NAME \
  --source-image=SOURCE_IMAGE \
  --licenses=LICENSES

Ganti kode berikut:

  • IMAGE_NAME: nama image yang akan dibuat.
  • SOURCE_IMAGE: nama image yang akan digunakan untuk membuat image baru.
  • LICENSES: daftar string lisensi yang dipisahkan koma. Contoh, "license1", "license2".

Untuk mengetahui informasi selengkapnya tentang pembuatan image, lihat Membuat, menghapus, dan menghentikan penggunaan image kustom, serta Membuat image Windows.

Untuk mengetahui informasi selengkapnya tentang pembuatan image, lihat Membuat, menghapus, dan menghentikan penggunaan image kustom, serta Membuat image Windows.

Menambahkan lisensi ke disk

Untuk menambahkan lisensi yang terkait dengan VM, gunakan gcloud CLI atau Compute Engine API.

gcloud

Untuk menambahkan lisensi ke disk menggunakan referensi atau kode lisensi, gunakan perintah gcloud compute disks update berikut.

gcloud compute disks update DISK_NAME \
--append-licenses=LICENSES

Ganti kode berikut:

  • DISK_NAME: nama disk yang akan ditambahkan.
  • LICENSES: daftar referensi lisensi yang dipisahkan koma, misalnya, "projects/rhel-cloud/global/licenses/rhel-9-server", "projects/rhel-cloud/global/licenses/rhel-8-server".

REST

Untuk menambahkan lisensi ke disk menggunakan referensi atau kode lisensi, panggil metode disks.update v1 berikut:

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/disks/DISK_NAME?paths=licenses --data '{"name":"DISK_NAME", "licenses":["https://www.googleapis.com/compute/v1/LICENSES"]}'

Ganti kode berikut:

  • PROJECT: nama project
  • ZONE: zona yang berisi VM
  • DISK_NAME: nama disk
  • LICENSES: daftar referensi lisensi yang dipisahkan koma, misalnya, "projects/rhel-cloud/global/licenses/rhel-9-server", "projects/rhel-cloud/global/licenses/rhel-8-server".

Mengganti lisensi di disk

Untuk mengganti lisensi yang terkait dengan VM, gunakan gcloud CLI atau Compute Engine API.

gcloud

Untuk mengganti lisensi pada disk menggunakan referensi atau kode lisensi, gunakan perintah gcloud compute disks update berikut.

gcloud compute disks update DISK_NAME \
--replace-license=PREVIOUS_LICENSE,NEW_LICENSE

Ganti kode berikut:

  • DISK_NAME: nama disk yang akan ditambahkan.
  • PREVIOUS_LICENSE: referensi izin sebelumnya yang diganti, misalnya, "projects/rhel-cloud/global/licenses/rhel-9-server", "projects/rhel-cloud/global/licenses/rhel-8-server".
  • NEW_LICENSE: referensi lisensi baru, misalnya, "projects/rhel-cloud/global/licenses/rhel-9-server", "projects/rhel-cloud/global/licenses/rhel-8-server".

REST

Untuk mengganti lisensi di disk menggunakan referensi atau kode lisensi, panggil metode v1 disks.update dan ganti lisensi sebelumnya dengan lisensi baru di isi permintaan sebagai berikut:

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/disks/DISK_NAME?paths=licenses --data '{"name":"DISK_NAME", "licenses":["https://www.googleapis.com/compute/v1/NEW_LICENSE"]}'

Ganti kode berikut:

  • PROJECT: nama project
  • ZONE: zona yang berisi VM
  • DISK_NAME: nama disk
  • NEW_LICENSE: referensi lisensi baru, misalnya, "projects/rhel-cloud/global/licenses/rhel-9-server", "projects/rhel-cloud/global/licenses/rhel-8-server".

Menghapus lisensi dari disk

Untuk menghapus lisensi individual yang terkait dengan VM, gunakan gcloud CLI dan Compute Engine API.

gcloud

Untuk menghapus lisensi dari disk menggunakan referensi atau kode lisensi, gunakan perintah gcloud compute disks update.

gcloud compute disks update DISK_NAME \
--remove-licenses=LICENSES

Ganti kode berikut:

  • DISK_NAME: nama disk yang akan dihapus.
  • LICENSES: daftar referensi lisensi yang dipisahkan koma, misalnya, "projects/rhel-cloud/global/licenses/rhel-9-server", "projects/rhel-cloud/global/licenses/rhel-8-server".

REST

Untuk menghapus lisensi, berikan kolom lisensi kosong dalam permintaan panggilan bersama dengan pemilih jalur dengan memanggil metode v1 disks.update berikut:

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/disks/DISK_NAME?paths=licenses --data '{"name":"DISK_NAME", "licenses":[]}'

Ganti kode berikut:

  • PROJECT: nama project
  • ZONE: zona yang berisi VM
  • DISK_NAME: nama disk
  • LICENSES: biarkan kosong.

Melihat histori pembaruan lisensi

Lihat histori pembaruan lisensi untuk VM dalam sebuah project menggunakan prosedur berikut:

  1. Di konsol Trusted Cloud , buka halaman Logs Explorer.

    Buka Logs Explorer

  2. Di toolbar, pastikan Tampilkan kueri diaktifkan.

  3. Salin ekspresi berikut ke editor kueri:

    resource.type="gce_disk"
    logName="projects/PROJECT_NAME/logs/cloudaudit.googleapis.com%2Factivity"
    severity>=NOTICE
    protoPayload.request.@type="type.googleapis.com/compute.disks.update"
    protoPayload.request.licenses:*
    
  4. Ganti PROJECT_NAME dengan nama project.

  5. Klik Run query.

Langkah berikutnya