Melihat dan menambahkan lisensi


Dokumen ini menunjukkan cara melihat lisensi yang terkait dengan instance virtual machine (VM), menambahkan lisensi ke VM, dan melihat histori pembaruan lisensi. Untuk mengetahui informasi selengkapnya tentang lisensi di Compute Engine, lihat Tentang lisensi.

Sebelum memulai

  • Siapkan autentikasi, jika Anda belum melakukannya. Autentikasi adalah proses verifikasi identitas Anda untuk akses ke layanan dan API Google Cloud. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine sebagai berikut.

    Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:

    Konsol

    Saat menggunakan Konsol Google Cloud untuk mengakses API dan layanan Google Cloud, Anda tidak perlu menyiapkan autentikasi.

    gcloud

    1. Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut:

      gcloud init
    2. Menetapkan region dan zona default.

    REST

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

      Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut:

      gcloud init

Melihat lisensi yang terkait dengan VM

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

Konsol

  1. Di konsol Google Cloud, buka halaman Instance VM.

    Buka instance VM

  2. Klik nama VM untuk memeriksa lisensinya. Halaman Instance detail akan terbuka.

  3. Di bagian bawah halaman Detail instance, klik REST yang Setara.

  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 menunjukkan lisensi yang terkait dengan boot disk.

REST

  1. Panggil metode v1 instances.get berikut:

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

    Ganti kode berikut:

    • PROJECT: nama project
    • ZONE: zona yang berisi VM
    • VM_NAME: nama VM
  2. Compute Engine API menampilkan lisensi yang terkait dengan boot disk di bagian disks pada kolom licenses.

Melihat lisensi pengguna yang terkait dengan VM

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

Konsol

  1. Di konsol Google Cloud, buka halaman Instance VM.

    Buka instance VM

  2. Klik nama VM untuk memeriksa lisensi penggunanya. Halaman Instance detail akan terbuka.

  3. Di bagian bawah halaman Detail instance, klik REST yang Setara.

  4. Lihat kolom userLicenses untuk boot disk.

gcloud

  1. Jalankan perintah gcloud beta compute instances describe berikut:

    gcloud beta compute instances describe VM_NAME
    

    Ganti VM_NAME dengan nama VM Anda.

  2. Lihat bagian disks dari output. Kolom licenses menunjukkan lisensi yang terkait dengan boot disk.

REST

  1. Panggil metode beta instances.get berikut:

    GET https://compute.googleapis.com/compute/beta/projects/PROJECT/zones/ZONE/instances/VM_NAME
    

    Ganti kode berikut:

    • PROJECT: nama project
    • ZONE: zona yang berisi VM
    • VM_NAME: nama VM
  2. Compute Engine API menampilkan lisensi yang terkait dengan boot disk di bagian disks pada kolom licenses.

Menambahkan lisensi saat mengimpor image

Untuk menambahkan lisensi saat mengimpor 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. Misalnya, "license1", "license2".

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

Menambahkan lisensi dan lisensi pengguna saat membuat image

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

gcloud beta compute images create IMAGE_NAME \
  --source-image=SOURCE_IMAGE \
  --licenses=LICENSES \
  --user-licenses=USER_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. Misalnya, "license1", "license2".
  • USER_LICENSES: daftar string lisensi pengguna yang dipisahkan koma. Misalnya, "userlicense1", "userlicense2".

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

Menambahkan dan memvalidasi lisensi pengguna

Untuk menambahkan dan memvalidasi lisensi pengguna, lakukan langkah berikut:

  1. Hentikan VM.

  2. Cantumkan disk yang terkait dengan VM menggunakan perintah gcloud compute instances describe:

    gcloud compute instances describe VM_NAME --format="yaml(disks)"
    
  3. Pastikan outputnya mirip dengan yang berikut ini:

    disks:
    - autoDelete: true
      boot: true
      deviceName: BOOT_DISK_NAME
      diskSizeGb: '20'
      guestOsFeatures:
      - type: UEFI_COMPATIBLE
      index: 0
      interface: SCSI
      kind: compute#attachedDisk
      licenses:
      - BOOT_DISK_LICENSE_STRING
      mode: READ_WRITE
      source: https://www.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/disks/BOOT_DISK_NAME
      type: PERSISTENT
    
  4. Pada output dari langkah sebelumnya, temukan nama boot disk. Untuk boot disk, nilai boot adalah true, dan nama boot disk adalah nilai deviceName.

  5. Tambahkan lisensi pengguna ke boot disk menggunakan perintah gcloud beta compute disks update:

    gcloud beta compute disks update BOOT_DISK_NAME \
       --update-user-licenses=LICENSE_URIS
    

    Ganti kode berikut:

    • BOOT_DISK_NAME: nama boot disk yang akan ditambahkan lisensi

    • LICENSE_URIS: daftar string lisensi yang dipisahkan koma, yang menggantikan semua lisensi pengguna yang ada

  6. Dapatkan informasi tentang boot disk menggunakan perintah gcloud beta compute disks describe:

    gcloud beta compute disks describe BOOT_DISK_NAME
    

    Ganti BOOT_DISK_NAME dengan nama boot disk untuk memeriksa lisensi yang ditambahkan.

  7. Pastikan outputnya mirip dengan yang berikut ini:

    creationTimestamp: '2021-05-05T15:26:27.835-07:00'
    guestOsFeatures:
    - type: UEFI_COMPATIBLE
    id: '727854272460268924'
    interface: SCSI
    kind: compute#disk
    labelFingerprint: 42WmSpB8rSM=
    lastAttachTimestamp: '2021-05-05T15:26:27.836-07:00'
    licenseCodes:
    - '1000006'
    - '6213885950785916969'
    licenses:
    - BOOT_DISK_LICENSE_STRING
    multiWriter: false
    name: VM_NAME
    physicalBlockSizeBytes: '4096'
    selfLink: https://www.googleapis.com/compute/beta/projects/PROJECT_NAME/zones/ZONE/disks/DISK_NAME
    selfLinkWithId: https://www.googleapis.com/compute/beta/projects/PROJECT_NAME/zones/ZONE/disks/727854272460268924
    sizeGb: '20'
    sourceImage: https://www.googleapis.com/compute/beta/projects/IMAGE_PROJECT/global/images/IMAGE
    sourceImageId: '7397991294075835597'
    status: READY
    type: https://www.googleapis.com/compute/beta/projects/PROJECT_NAME/zones/ZONE/diskTypes/pd-standard
    userLicenses:
    - LICENSE_URI
    users:
    - https://www.googleapis.com/compute/beta/projects/PROJECT_NAME/zones/ZONE/instances/VM_NAME
    zone: https://www.googleapis.com/compute/beta/projects/PROJECT_NAME/zones/ZONE
    
  8. Pastikan lisensi pengguna ditambahkan ke boot disk dengan memeriksa output langkah sebelumnya untuk kolom userLicenses pada string lisensi yang sesuai.

    Jika kolom userLicenses tidak berisi string lisensi yang diinginkan, Anda mungkin perlu menghapus lalu memperbarui daftar string lisensi. Anda dapat melakukannya menggunakan perintah gcloud beta compute disks update.

  9. Mulai VM.

Melihat histori pembaruan lisensi

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

  1. Di konsol Google Cloud, buka halaman Aktivitas.

    Buka Aktivitas

  2. Di panel Filter pada Kategori, pilih Konfigurasi untuk Jenis Aktivitas.

  3. Di panel Filter pada Kategori, pilih Disk untuk Jenis Resource.

Langkah selanjutnya