VM에서 가상 디스플레이 사용 설정

이 문서에서는 가상 머신(VM) 인스턴스에서 가상 디스플레이를 사용 설정하거나 사용 중지하는 방법을 설명합니다.

VM에서 실행되는 애플리케이션에 디스플레이 기기가 필요하지만 GPU 성능은 필요하지 않은 경우 가상 디스플레이 기기를 사용하도록 VM을 구성합니다. VM에서 가상 디스플레이를 사용 설정하면 원격 시스템 관리 도구, 원격 데스크톱 소프트웨어, 화면 캡처와 같은 가상 디스플레이 기기를 VM에서 실행할 수 있습니다.

시작하기 전에

  • 아직 인증을 설정하지 않았다면 설정합니다. 인증은 Google Cloud 서비스 및 API에 액세스하기 위해 ID를 확인하는 프로세스입니다. 로컬 개발 환경에서 코드 또는 샘플을 실행하려면 다음과 같이 Compute Engine에 인증하면 됩니다.

    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. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. Terraform

      로컬 개발 환경에서 이 페이지의 Terraform 샘플을 사용하려면 gcloud CLI를 설치 및 초기화한 다음 사용자 인증 정보로 애플리케이션 기본 사용자 인증 정보를 설정하세요.

      1. Install the Google Cloud CLI.

      2. To initialize the gcloud CLI, run the following command: 

        gcloud init

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

      자세한 내용은 다음을 참조하세요: Set up authentication for a local development environment.

      REST

      로컬 개발 환경에서 이 페이지의 REST API 샘플을 사용하려면 gcloud CLI에 제공하는 사용자 인증 정보를 사용합니다.

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      자세한 내용은 Google Cloud 인증 문서의 REST 사용 인증을 참조하세요.

필요한 역할

VM에서 가상 디스플레이를 사용 설정하거나 사용 중지하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Compute 인스턴스 관리자(v1)(roles/compute.instanceAdmin.v1) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 VM에서 가상 디스플레이를 사용 설정하거나 사용 중지하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

VM에서 가상 디스플레이를 사용 설정하거나 사용 중지하려면 다음 권한이 필요합니다.

  • 기존 VM에서 가상 디스플레이를 사용 설정 또는 사용 중지: VM에 대한 compute.instances.updateDisplayDevice 권한
  • 가상 디스플레이가 사용 설정된 VM 만들기:
    • 프로젝트에 대한 compute.instances.create 권한
    • 커스텀 이미지를 사용하여 VM 만들기: 이미지에 대한 compute.images.useReadOnly 권한
    • 스냅샷을 사용하여 VM 만들기: 스냅샷에 대한 compute.snapshots.useReadOnly 권한
    • 인스턴스 템플릿을 사용하여 VM 만들기: 인스턴스 템플릿에 대한 compute.instanceTemplates.useReadOnly 권한
    • VM에 기존 네트워크 할당: 프로젝트에 대한 compute.networks.use 권한
    • VM의 고정 IP 주소 지정: 프로젝트에 대한 compute.addresses.use 권한
    • 기존 네트워크 사용 시 VM에 외부 IP 주소 할당: 프로젝트에 대한 compute.networks.useExternalIp 권한
    • VM의 서브넷 지정: 프로젝트 또는 선택한 서브넷에 대한 compute.subnetworks.use 권한
    • VPC 네트워크를 사용할 때 VM에 외부 IP 주소 할당: 프로젝트 또는 선택한 서브넷에 대한 compute.subnetworks.useExternalIp 권한
    • VM에 VM 인스턴스 메타데이터 설정: 프로젝트에 대한 compute.instances.setMetadata 권한
    • VM에 태그 설정: VM에 대한 compute.instances.setTags 권한
    • VM에 라벨 설정: VM에 대한 compute.instances.setLabels 권한
    • VM에 사용할 서비스 계정 설정: VM에 대한 compute.instances.setServiceAccount 권한
    • VM의 새 디스크 만들기: 프로젝트에 대한 compute.disks.create 권한
    • 기존 디스크를 읽기 전용 또는 읽기-쓰기 모드로 연결: 디스크에 대한 compute.disks.use 권한
    • 기존 디스크를 읽기 전용 모드로 연결: 디스크에 대한 compute.disks.useReadOnly 권한

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

가격 책정

VM에서 가상 디스플레이를 사용 설정하거나 사용 중지하는 데는 비용이 들지 않습니다.

제한사항

가상 디스플레이가 사용 설정된 VM의 경우 다음과 같은 제한사항이 적용됩니다.

  • VM이 v20190312 이전 버전의 x64 기반 Windows OS 이미지를 실행하는 경우 VM에 가상 디스플레이를 사용 설정한 후 이 문서의 설명대로 가상 디스플레이 드라이버를 설치해야 합니다. 이후의 OS 이미지 버전을 실행 중인 VM의 경우에는 OS 이미지에 드라이버가 이미 설치되어 있습니다.

  • 게스트 OS가 부팅되고 가상 디스플레이 드라이버를 초기화한 후에만 VM에서 가상 디스플레이 기기를 사용할 수 있습니다.

  • Sandy Bridge CPU 플랫폼을 실행하는 VM에서는 가상 디스플레이 기기를 사용할 수 없습니다.

  • T2A Arm VM에서는 가상 디스플레이 기기를 사용할 수 없습니다.

VM에서 가상 디스플레이 사용 설정

VM에서 가상 디스플레이를 사용 설정하려면 이 문서에 설명된 다음 방법 중 하나를 선택합니다.

VM에서 v20190312 이전 버전의 x64 기반 Windows OS 이미지를 실행하는 경우 VM에 가상 디스플레이를 사용 설정한 후 이 문서의 설명대로 가상 디스플레이 드라이버를 설치합니다.

가상 디스플레이가 사용 설정된 VM 만들기

가상 디스플레이가 사용 설정된 VM을 만들려면 다음 옵션 중 하나를 선택합니다.

콘솔

  1. Google Cloud 콘솔에서 인스턴스 만들기 페이지로 이동합니다.

    인스턴스 만들기로 이동

  2. 이름, 영역, 머신 유형을 포함하여 VM의 속성을 지정합니다.

  3. 디스플레이 기기 섹션에서 디스플레이 기기 사용 설정 체크박스를 선택합니다.

  4. 만들기를 클릭하여 VM을 만듭니다.

gcloud

가상 디스플레이가 사용 설정된 VM을 만들려면 --enable-display-device 플래그와 함께 gcloud compute instances create 명령어를 사용합니다.

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

다음을 바꿉니다.

  • VM_NAME: VM의 이름입니다.

  • MACHINE_TYPE: VM에 사용할 머신 유형입니다.

  • ZONE: VM을 만들 영역입니다.

Terraform

가상 디스플레이가 사용 설정된 VM을 만들려면 enable_display 인수가 true로 설정된 Terraform 리소스를 사용합니다.

예를 들어 us-central1-c 영역에서 가상 디스플레이가 사용 설정된 VM을 만들고 f1-micro를 머신 유형으로 지정하려면 다음 리소스를 사용하세요.


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

가상 디스플레이가 사용 설정된 VM을 만들려면 instances.insert 메서드에 POST 요청을 실행합니다. 요청 본문에 true로 설정된 enableDisplay 필드를 포함합니다.

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"
    }
  ]
}

다음을 바꿉니다.

  • PROJECT_ID: VM을 만들 프로젝트의 ID입니다.

  • ZONE: VM을 만들 영역입니다.

  • VM_NAME: VM의 이름입니다.

  • MACHINE_TYPE: VM에 사용할 머신 유형입니다.

  • IMAGE_PROJECT: OS 이미지가 포함된 이미지 프로젝트입니다(예: debian-cloud). 지원되는 이미지 프로젝트에 대한 자세한 내용은 공개 이미지를 참조하세요.

  • IMAGE: 다음 중 하나를 지정합니다.

    • OS 이미지의 특정 버전입니다(예: debian-12-bookworm-v20240617).

    • 이미지 계열이며 형식은 family/IMAGE_FAMILY여야 합니다. 중단되지 않은 최신 OS 이미지를 지정합니다. 예를 들어 family/debian-12를 지정하면 Debian 12 이미지 계열의 최신 버전이 사용됩니다. 이미지 계열 사용에 대한 자세한 내용은 이미지 계열 권장사항을 참조하세요.

VM 만들기에 대한 자세한 내용은 Compute Engine 인스턴스 만들기 및 시작을 참고하세요.

기존 VM에서 가상 디스플레이 사용 설정

VM에서 가상 디스플레이를 사용 설정하기 전에 VM을 중지해야 합니다.

기존 VM에서 가상 디스플레이를 사용 설정하려면 다음 옵션 중 하나를 선택합니다.

콘솔

  1. Google Cloud 콘솔에서 VM 인스턴스 페이지로 이동합니다.

    VM 인스턴스 페이지로 이동

  2. 이름 열에서 VM의 이름을 클릭합니다.

    VM의 세부정보 페이지가 열립니다.

  3. 수정을 클릭합니다.

    VM 속성을 수정하는 페이지가 열립니다.

  4. 디스플레이 기기 섹션에서 디스플레이 기기 사용 설정 체크박스를 선택합니다.

  5. 저장을 클릭합니다.

gcloud

기존 VM에서 가상 디스플레이를 사용 설정하려면 --enable-display-device 플래그와 함께 gcloud compute instances update 명령어를 사용합니다.

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

다음을 바꿉니다.

  • VM_NAME: VM의 이름입니다.

  • ZONE: VM이 있는 영역입니다.

REST

기존 VM에서 가상 디스플레이를 사용 설정하려면 instances.updateDisplayDevice 메서드에 POST 요청을 실행합니다. 요청 본문에 enableDisplay 필드를 포함하고 true로 설정합니다.

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

{
  "enableDisplay": true
}

다음을 바꿉니다.

  • PROJECT_ID: VM이 있는 프로젝트의 ID입니다.

  • ZONE: VM이 있는 영역입니다.

  • VM_NAME: VM의 이름입니다.

기존 VM에서 가상 디스플레이 사용 중지

VM에서 가상 디스플레이를 사용 중지하기 전에 VM을 중지해야 합니다.

기존 VM에서 가상 디스플레이를 사용 중지하려면 다음 옵션 중 하나를 선택합니다.

콘솔

  1. Google Cloud 콘솔에서 VM 인스턴스 페이지로 이동합니다.

    VM 인스턴스 페이지로 이동

  2. 이름 열에서 VM의 이름을 클릭합니다.

    VM의 세부정보 페이지가 열립니다.

  3. 수정을 클릭합니다.

    VM 속성을 수정하는 페이지가 열립니다.

  4. 디스플레이 기기 섹션에서 디스플레이 기기 사용 설정 체크박스를 선택 취소합니다.

  5. 저장을 클릭합니다.

gcloud

기존 VM에서 가상 디스플레이를 사용 중지하려면 --no-enable-display-device 플래그와 함께 gcloud compute instances update 명령어를 사용합니다.

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

다음을 바꿉니다.

  • VM_NAME: VM의 이름입니다.

  • ZONE: VM이 있는 영역입니다.

REST

기존 VM에서 가상 디스플레이를 사용 중지하려면 instances.updateDisplayDevice 메서드에 대해 POST 요청을 실행합니다. 요청 본문에 enableDisplay 필드를 포함하고 false로 설정합니다.

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

{
  "enableDisplay": false
}

다음을 바꿉니다.

  • PROJECT_ID: VM이 있는 프로젝트의 ID입니다.

  • ZONE: VM이 있는 영역입니다.

  • VM_NAME: VM의 이름입니다.

가상 디스플레이 드라이버 설치

v20190312 이전 버전의 Windows OS 이미지를 실행하는 Windows VM에 가상 디스플레이를 사용 설정한 경우 VM에서 가상 디스플레이 기기를 사용하려면 Google Cloud에서 제공하는 가상 디스플레이 드라이버를 설치해야 합니다. VM에서 최신 OS 이미지 버전을 실행하는 경우 드라이버가 이미 설치되어 있으므로 이 섹션을 건너뛸 수 있습니다.

가상 디스플레이가 사용 설정된 VM에 가상 디스플레이 드라이버를 설치하려면 다음을 수행합니다.

  1. Windows VM에 연결합니다.

  2. 관리자 권한으로 PowerShell 터미널을 엽니다.

  3. google-compute-engine-driver-gga 구성요소를 설치합니다.

    googet install google-compute-engine-driver-gga

  4. VM을 다시 시작합니다.

VM을 다시 시작한 후 다음 섹션에 설명된 대로 드라이버가 올바르게 설치되었는지 확인할 수 있습니다.

가상 디스플레이 드라이버 설치 확인

이전 섹션의 설명대로 Windows VM에 수동으로 가상 디스플레이 드라이버를 설치해야 했던 경우 다음을 수행하여 설치가 성공했는지 확인할 수 있습니다.

  1. 아직 연결하지 않았다면 Windows VM에 연결합니다.

  2. 기기 관리자를 엽니다.

  3. 기기 관리자 목록의 디스플레이 어댑터 목록에 Google 그래픽 배열 (GGA) 드라이버가 나열되어 있는지 확인합니다.

    드라이버가 나열되지 않으면 이 문서에 설명된 대로 가상 디스플레이 드라이버를 다시 설치합니다.

다음 단계