Delete VMs

This document explains how to delete a virtual machine (VM) instance in Google Distributed Cloud (GDC) air-gapped.

Deleting a virtual machine (VM) removes the VM and its associated resources from your project. If you don't want to delete an instance, you can temporarily stop it. For more information, see Stop and start a VM.

This document is for developers in platform administrator or application operator groups that delete VMs in a Distributed Cloud environment. For more information, see Audiences for GDC air-gapped documentation.

Before you begin

To use gdcloud command-line interface (CLI) commands, ensure that you have downloaded, installed, and configured the gdcloud CLI. All commands for Distributed Cloud use the gdcloud or kubectl CLI, and require an operating system (OS) environment.

Get the kubeconfig file path

To run commands against the Management API server, ensure you have the following resources:

  1. Sign in and generate the kubeconfig file for the Management API server if you don't have one.

  2. Use the path to the kubeconfig file of the Management API server to replace MANAGEMENT_API_SERVER in these instructions.

Request permissions and access

Request IAM roles

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

  • Project VirtualMachine Admin (project-vm-admin): create, modify, list, and delete VMs in the project namespace.

  • Project Viewer(project-viewer): view all resources within the project namespaces.

All VM roles must bind to the namespace of the project where the VM resides. Follow the steps to verify your access.

Delete a VM

Delete a VM by using the GDC console or kubectl. The VM must not be in a terminating or unknown state.

Console

  1. In the navigation menu, click Virtual Machines > Instances.

  2. In the list of VMs, select the checkbox for the VM that you want to delete.

  3. Click Delete.

  4. In the confirmation dialog, click Delete.

gdcloud

To delete a VM:

gdcloud compute instances delete VM_NAME \
  --project PROJECT
  • Replace VM_NAME with the name of the VM.
  • Replace PROJECT with the name of the GDC project in which the VM lives.

kubectl

  1. Delete the VM:

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
  -n PROJECT \
  delete virtualmachines.virtualmachine.gdc.goog VM_NAME

  2. Replace VM_NAME and PROJECT with the name and project name, respectively, of the VM.

  3. Verify that you've deleted the VM:

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
  -n PROJECT \
  get virtualmachines.virtualmachine.gdc.goog VM_NAME

    Replace PROJECT with the VM project name.