> [!IMPORTANT]
> **Important:** Google Distributed Cloud (GDC) air-gapped supports standard GA virtual machine (VM) families (N2 and N3-standard general-purpose and A2, A3, and A4 GPU-enabled shapes) for bounded workloads that support AI and Kubernetes solutions. Standalone high performance computing (HPC), large-scale data warehousing, unconstrained relational databases, and non-standard high-memory shapes are outside standard GDC focus and require pre-flight validation through the Rack Configurator and Hardware Validation Suite as well as formal Deal Review sign-off.

This document explains how to create high-performance VMs in
GDC for memory-intensive workloads.

This type of VM uses a non-standard N4 high-memory machine shape, which
requires the pre-flight validation and Deal Review sign-off described in the
preceding notice, for applications that require consistent throughput and low
latency. For more information on how shapes optimize compute and
virtualization, see
[Virtual Machine Types](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/application/ao-user/vms/manage-vms/operations-and-lifecycle/view-vm-machine-type.md.txt).

This document is for platform administrators within platform administrator groups
responsible for creating virtual machines. For more information, see
[Audiences for GDC air-gapped documentation](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/resources/audiences.md.txt).

## Before you begin

Open a ticket to request that the Infrastructure Operator provisions the
necessary `o3-highmem1-192-gdc-metal` servers and enables HPC optimizations.
When the ticket is resolved, you can create a high performance VM.

### Request IAM roles

Contact your IAM Project Admin to request the following roles on your project:

- **Virtual Machine Project Admin** (`project-vm-admin`): create, modify, list, and delete standard and high-performance VMs in the project namespace.

All VM roles must bind to the namespace of the project where the VM resides.
Follow the steps to [verify](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/application/ao-user/vms/preparation.md.txt#verify-user-access)
your access.

## Create a high performance VM

To enable high performance computing (HPC) on a VM, you add the
`virtualmachine.gdc.goog/enable-high-perf: "true"` label to the `VirtualMachine`
manifest. When this label is applied, taints and labels are automatically added
to the VM to ensure it runs on dedicated, optimized nodes.

1. To create a disk for your VM, save the following `VirtualMachineDisk`
   manifest as `DISK_NAME.yaml`:

   ```yaml
   apiVersion: virtualmachine.gdc.goog/v1
   kind: VirtualMachineDisk
   metadata:
     name: DISK_NAME
   spec:
     source:
       image:
         name: VM_IMAGE
         namespace: vm-system
     size: 20Gi
   ```
2. Create the disk:

   ```bash
   kubectl apply -f DISK_NAME.yaml
   ```
3. To create the high-performance VM, save the following `VirtualMachine`
   manifest as `VM_NAME.yaml`. Note the inclusion of the `virtualmachine.gdc.goog/enable-high-perf: "true"` label.

   ```yaml
   apiVersion: virtualmachine.gdc.goog/v1
   kind: VirtualMachine
   metadata:
     name: VM_NAME
     labels:
       virtualmachine.gdc.goog/enable-high-perf: "true"
   spec:
     compute:
       virtualMachineType: VM_TYPE
     disks:
     - virtualMachineDiskRef:
         name: DISK_NAME
       boot: true
       autoDelete: true
     shieldConfig:
       bootType: uefi
       enableSecureBoot: true
       enableVtpm: false
   ```
4. Create the VM:

   ```bash
   kubectl apply -f VM_NAME.yaml
   ```

## What's next

- Review [GDC-supported images](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/application/ao-user/vms/create-a-vm/supported-vm-images.md.txt)
- [Create and start a VM](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/application/ao-user/vms/create-a-vm/create-and-start.md.txt) instance that uses your image.
- [Create a boot disk](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/application/ao-user/vms/manage-vm-boot-disks/create-customized-boot-disk.md.txt) for your VM.