Mengaktifkan tampilan virtual di VM

Dokumen ini menjelaskan cara mengaktifkan atau menonaktifkan tampilan virtual pada instance virtual machine (VM).

Jika aplikasi yang berjalan di VM Anda memerlukan perangkat tampilan, tetapi Anda tidak memerlukan performa GPU, konfigurasi VM Anda untuk menggunakan perangkat tampilan virtual. Dengan mengaktifkan tampilan virtual di VM, Anda dapat menjalankan perangkat tampilan virtual di VM, seperti alat pengelolaan sistem jarak jauh, software desktop jarak jauh, dan alat perekam layar.

Sebelum memulai

  • Jika Anda belum melakukannya, siapkan autentikasi. Autentikasi adalah proses yang digunakan untuk memverifikasi identitas Anda untuk mengakses Google Cloud 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 Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. Menginstal Google Cloud CLI. Setelah penginstalan, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut: 

      gcloud init

      Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

    2. Set a default region and zone.

    Terraform

    Untuk menggunakan contoh Terraform di halaman ini dalam lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI, lalu siapkan Kredensial Default Aplikasi dengan kredensial pengguna Anda.

      Menginstal Google Cloud CLI.

      Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

      If you're using a local shell, then create local authentication credentials for your user account: 

      gcloud auth application-default login

      You don't need to do this if you're using Cloud Shell.

      If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

    Untuk informasi selengkapnya, lihat Set up authentication for a local development environment.

    REST

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

      Menginstal Google Cloud CLI.

      Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

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

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk mengaktifkan atau menonaktifkan tampilan virtual di VM, minta administrator untuk memberi Anda peran IAM Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) di project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk mengaktifkan atau menonaktifkan tampilan virtual di VM. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk mengaktifkan atau menonaktifkan tampilan virtual pada VM:

  • Untuk mengaktifkan atau menonaktifkan tampilan virtual pada VM yang ada: compute.instances.updateDisplayDevice di VM
  • Untuk membuat VM dengan tampilan virtual yang diaktifkan:
    • compute.instances.create pada project
    • Untuk menggunakan image kustom guna membuat VM: compute.images.useReadOnly pada image
    • Untuk menggunakan snapshot untuk membuat VM: compute.snapshots.useReadOnly pada snapshot
    • Untuk menggunakan template instance guna membuat VM: compute.instanceTemplates.useReadOnly di template instance
    • Untuk menetapkan jaringan lama ke VM: compute.networks.use di project
    • Untuk menentukan alamat IP statis untuk VM: compute.addresses.use di project
    • Untuk menetapkan alamat IP eksternal ke VM saat menggunakan jaringan lama: compute.networks.useExternalIp di project
    • Untuk menentukan subnet bagi VM: compute.subnetworks.use pada project atau pada subnet yang dipilih
    • Untuk menetapkan alamat IP eksternal ke VM saat menggunakan jaringan VPC: compute.subnetworks.useExternalIp di project atau di subnet yang dipilih
    • Untuk menetapkan metadata instance VM untuk VM: compute.instances.setMetadata di project
    • Untuk menyetel tag untuk VM: compute.instances.setTags di VM
    • Untuk menyetel label VM: compute.instances.setLabels di VM
    • Untuk menyetel akun layanan yang akan digunakan VM: compute.instances.setServiceAccount di VM
    • Untuk membuat disk baru untuk VM: compute.disks.create di project
    • Untuk memasang disk yang ada dalam mode hanya baca atau baca-tulis: compute.disks.use pada disk
    • Untuk memasang disk yang ada dalam mode hanya baca: compute.disks.useReadOnly pada disk

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Harga

Tidak ada biaya yang terkait dengan mengaktifkan atau menonaktifkan tampilan virtual di VM.

Pembatasan

Untuk VM dengan tampilan virtual yang diaktifkan, batasan berikut berlaku:

  • Jika VM Anda menjalankan image OS Windows berbasis x64 yang lebih lama dari versi v20190312, maka, setelah mengaktifkan tampilan virtual di VM, Anda harus menginstal driver tampilan virtual seperti yang dijelaskan dalam dokumen ini. Jika VM Anda menjalankan versi image OS yang lebih baru, driver sudah diinstal di image OS.

  • Anda dapat menggunakan perangkat tampilan virtual di VM hanya setelah OS tamu melakukan booting dan melakukan inisialisasi driver tampilan virtual.

  • Anda tidak dapat menggunakan perangkat tampilan virtual di VM yang menjalankan platform CPU Sandy Bridge.

  • Anda tidak dapat menggunakan perangkat tampilan virtual di VM Arm T2A.

Mengaktifkan tampilan virtual di VM

Untuk mengaktifkan tampilan virtual di VM, pilih salah satu metode berikut yang dijelaskan dalam dokumen ini:

Jika VM Anda menjalankan image OS Windows berbasis x64 yang lebih lama dari versi v20190312, maka, setelah Anda mengaktifkan tampilan virtual di VM, instal driver tampilan virtual seperti yang dijelaskan dalam dokumen ini.

Membuat VM dengan tampilan virtual yang diaktifkan

Untuk membuat VM dengan tampilan virtual yang diaktifkan, pilih salah satu opsi berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Create an instance.

    Buka halaman Buat instance

  2. Tentukan properti untuk VM, termasuk nama, zona, dan jenis mesin.

  3. Di bagian Display device, centang kotak Enable display device.

  4. Untuk membuat VM, klik Create.

gcloud

Untuk membuat VM dengan tampilan virtual yang diaktifkan, gunakan perintah gcloud compute instances create dengan flag --enable-display-device.

gcloud compute instances create VM_NAME \
    --enable-display-device \
    --machine-type=MACHINE_TYPE \
    --zone=ZONE

Ganti kode berikut:

  • VM_NAME: nama VM.

  • MACHINE_TYPE: jenis mesin yang akan digunakan untuk VM.

  • ZONE: zona tempat untuk membuat VM.

Terraform

Untuk membuat VM dengan tampilan virtual yang diaktifkan, gunakan resource Terraform dengan argumen enable_display yang ditetapkan ke true.

Misalnya, untuk membuat VM di zona us-central1-c dengan tampilan virtual yang diaktifkan, dan menentukan f1-micro sebagai jenis mesin, gunakan resource berikut:


resource "google_compute_instance" "instance_virtual_display" {
  name         = "instance-virtual-display"
  machine_type = "f1-micro"
  zone         = "us-central1-c"

  # Set the below to true to enable virtual display
  enable_display = true

  boot_disk {
    initialize_params {
      image = "debian-cloud/debian-11"
    }
  }
  network_interface {
    # A default network is created for all GCP projects
    network = "default"
    access_config {
    }
  }
}

REST

Untuk membuat VM dengan tampilan virtual yang diaktifkan, buat permintaan POST ke metode instances.insert. Dalam isi permintaan, sertakan kolom enableDisplay yang ditetapkan ke true.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

{
  "name": "VM_NAME",
  "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
  "disks": [
    {
      "boot": true,
      "initializeParams": {
        "sourceImage": "project/IMAGE_PROJECT/global/images/IMAGE"
      }
    }
  ],
  "displayDevice": {
    "enableDisplay": true
  },
  "networkInterfaces": [
    {
      "network": "global/networks/default"
    }
  ]
}

Ganti kode berikut:

  • PROJECT_ID: ID project tempat VM akan dibuat.

  • ZONE: zona tempat untuk membuat VM.

  • VM_NAME: nama VM.

  • MACHINE_TYPE: jenis mesin yang akan digunakan untuk VM.

  • IMAGE_PROJECT: project image yang berisi image OS—misalnya, debian-cloud. Untuk mengetahui informasi selengkapnya tentang project gambar yang didukung, lihat Gambar publik.

  • IMAGE: tentukan salah satu dari berikut ini:

    • Versi tertentu dari image OS—misalnya, debian-12-bookworm-v20240617.

    • Kelompok image, yang harus diformat sebagai family/IMAGE_FAMILY. Tindakan ini menentukan image OS terbaru yang tidak digunakan lagi. Misalnya, jika Anda menentukan family/debian-12, versi terbaru dalam kelompok image Debian 12 akan digunakan. Untuk mengetahui informasi selengkapnya tentang penggunaan kelompok image, lihat Praktik terbaik kelompok image.

Untuk mengetahui informasi selengkapnya tentang cara membuat VM, lihat Membuat dan memulai instance Compute Engine.

Mengaktifkan tampilan virtual di VM yang ada

Sebelum mengaktifkan tampilan virtual di VM, pastikan untuk menghentikan VM.

Untuk mengaktifkan tampilan virtual di VM yang ada, pilih salah satu opsi berikut:

Konsol

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

    Buka halaman Instance VM

  2. Di kolom Nama, klik nama VM.

    Halaman detail VM akan terbuka.

  3. Klik Edit.

    Halaman untuk mengedit properti VM akan terbuka.

  4. Di bagian Display device, centang kotak Enable display device.

  5. Klik Simpan.

gcloud

Untuk mengaktifkan tampilan virtual di VM yang ada, gunakan perintah gcloud compute instances update dengan flag --enable-display-device.

gcloud compute instances update VM_NAME \
    --enable-display-device \
    --zone=ZONE

Ganti kode berikut:

  • VM_NAME: nama VM.

  • ZONE: zona tempat VM berada.

REST

Untuk mengaktifkan tampilan virtual di VM yang ada, buat permintaan POST ke metode instances.updateDisplayDevice. Dalam isi permintaan, sertakan kolom enableDisplay dan tetapkan ke true.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/updateDisplayDevice

{
  "enableDisplay": true
}

Ganti kode berikut:

  • PROJECT_ID: ID project tempat VM berada.

  • ZONE: zona tempat VM berada.

  • VM_NAME: nama VM.

Menonaktifkan tampilan virtual pada VM yang ada

Sebelum menonaktifkan tampilan virtual di VM, pastikan untuk menghentikan VM.

Untuk menonaktifkan tampilan virtual pada VM yang ada, pilih salah satu opsi berikut:

Konsol

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

    Buka halaman Instance VM

  2. Di kolom Nama, klik nama VM.

    Halaman detail VM akan terbuka.

  3. Klik Edit.

    Halaman untuk mengedit properti VM akan terbuka.

  4. Di bagian Perangkat tampilan, hapus centang pada kotak Aktifkan perangkat tampilan.

  5. Klik Simpan.

gcloud

Untuk menonaktifkan tampilan virtual pada VM yang ada, gunakan perintah gcloud compute instances update dengan flag --no-enable-display-device.

gcloud compute instances update VM_NAME \
    --no-enable-display-device \
    --zone=ZONE

Ganti kode berikut:

  • VM_NAME: nama VM.

  • ZONE: zona tempat VM berada.

REST

Untuk menonaktifkan tampilan virtual di VM yang ada, buat permintaan POST ke metode instances.updateDisplayDevice. Dalam isi permintaan, sertakan kolom enableDisplay dan tetapkan ke false.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/updateDisplayDevice

{
  "enableDisplay": false
}

Ganti kode berikut:

  • PROJECT_ID: ID project tempat VM berada.

  • ZONE: zona tempat VM berada.

  • VM_NAME: nama VM.

Menginstal driver tampilan virtual

Jika Anda telah mengaktifkan tampilan virtual di VM Windows yang menjalankan image OS Windows yang lebih lama dari versi v20190312, maka untuk menggunakan perangkat tampilan virtual di VM, Anda harus menginstal driver tampilan virtual yang disediakan oleh Google Cloud. Jika VM menjalankan versi image OS yang lebih baru, driver sudah diinstal dan Anda dapat melewati bagian ini.

Untuk menginstal driver tampilan virtual di VM yang mengaktifkan tampilan virtual, lakukan hal berikut:

  1. Hubungkan ke VM Windows.

  2. Buka terminal PowerShell sebagai administrator.

  3. Instal komponen google-compute-engine-driver-gga:

    googet install google-compute-engine-driver-gga

  4. Mulai ulang VM.

Setelah memulai ulang VM, Anda dapat memverifikasi bahwa driver telah diinstal dengan benar seperti yang dijelaskan di bagian berikutnya.

Memverifikasi penginstalan driver tampilan virtual

Jika Anda harus menginstal driver tampilan virtual secara manual di VM Windows seperti yang dijelaskan di bagian sebelumnya, Anda dapat memverifikasi bahwa penginstalan berhasil dengan melakukan hal berikut:

  1. Jika Anda belum melakukannya, hubungkan ke VM Windows.

  2. Buka Pengelola Perangkat.

  3. Pada daftar Device Manager, di daftar Display adapters, pastikan driver Google Graphics Array (GGA) tercantum.

    Jika driver tidak tercantum, instal ulang driver tampilan virtual seperti yang dijelaskan dalam dokumen ini.

Langkah berikutnya