Manually importing Open Virtual Appliances (OVAs) into vSphere lets you stage
node OS images as VM templates when `gkectl prepare` can't import them for
you. Typical workflows don't require this procedure. However, you need it if
your security policies block your admin workstation from accessing your ESXi
hosts, or if you want to use Windows Server for some user cluster nodes.

## Why manually import?

During typical cluster creation, `gkectl` automatically imports the required
OVAs as part of the standard deployment procedure. The typical procedure is as
follows:

1. Create an admin workstation.
2. On your admin workstation, create a cluster configuration file.
3. Run `gkectl prepare`. This command fetches the OVAs from a Cloud Storage bucket, imports the OVAs to vSphere, and marks the OVAs as templates.
4. Run `gkectl create` to create a cluster.

You must manually import OVAs in the following scenarios:

- If your security policies don't allow your admin workstation to have access to your ESXi hosts, `gkectl prepare` cannot automatically import OVAs to vSphere.
- If you want to use Windows Server for some of your user cluster nodes, you must manually import an OVA. For more information, see [Windows Server](https://docs.cloud.google.com/kubernetes-engine/distributed-cloud/vmware/docs/how-to/manual-import-ova.md.txt#windows-server).

## Determine which OVAs you need

Before you create an admin cluster, you fill in an admin cluster configuration
file. In the configuration file, you set the
[`osImageType`](https://docs.cloud.google.com/kubernetes-engine/distributed-cloud/vmware/docs/how-to/admin-cluster-configuration-file-latest.md.txt#osimagetype)
field to specify the type of OS image you want to use for your admin cluster
nodes. The options are:

- Ubuntu with containerd
- Ubuntu
- Container Optimized OS (COS)

Before you create a user cluster, you fill in a user cluster configuration
file. In the configuration file, you specify one or more
[node pools](https://docs.cloud.google.com/kubernetes-engine/distributed-cloud/vmware/docs/how-to/user-cluster-configuration-file-latest.md.txt#nodepools-section).
For each node pool, you specify the
[type of OS image](https://docs.cloud.google.com/kubernetes-engine/distributed-cloud/vmware/docs/how-to/user-cluster-configuration-file-latest.md.txt#nodepool-osimagetype-field)
you want to use for the nodes in the pool.

The options are:

- Ubuntu with containerd
- Ubuntu
- Container Optimized OS (COS)
- Windows Server

For each OS that you plan to use in an admin cluster or user cluster, you need
to download the OS image from Cloud Storage and import it to vSphere.

## Ubuntu or Ubuntu with containerd

Download the Ubuntu OVA from Cloud Storage:

```
gcloud storage cp gs://gke-on-prem-release/node-os-ubuntu/gke-on-prem-ubuntu-VERSION.ova ./
```

Replace `VERSION` with the complete version number, for
example, `1.36.300-gke.150`. To get the version number,
see [Versioning](https://docs.cloud.google.com/kubernetes-engine/distributed-cloud/vmware/docs/version-history.md.txt#supported-versions).

Import the OVA to vSphere and mark it as a template:

```
govc import.ova -options - gke-on-prem-release/node-os-ubuntu/gke-on-prem-ubuntu-VERSION.ova <<EOF
{
  "DiskProvisioning": "thin",
  "MarkAsTemplate": true
}
EOF
```

## Container Optimized OS

Download the COS OVA from Cloud Storage:

```
gcloud storage cp gs://gke-on-prem-release/node-os-cos/gke-on-prem-cos-VERSION.ova ./
```

Replace `VERSION` with the complete version number, for
example, `1.36.300-gke.150`. To get the version number,
see [Versioning](https://docs.cloud.google.com/kubernetes-engine/distributed-cloud/vmware/docs/version-history.md.txt#supported-versions).

Import the OVA to vSphere and mark it as a template:

```
govc import.ova -options - gke-on-prem-release/node-os-cos/gke-on-prem-cos-VERSION.ova <<EOF
{
  "DiskProvisioning": "thin",
  "MarkAsTemplate": true
}
EOF
```

## Windows Server

Follow these steps:
[Create a VMware vSphere template for Windows Server 2019](https://docs.microsoft.com/en-us/azure/cloud-adoption-framework/manage/hybrid/server/best-practices/vmware-windows-template).

For more information, see
[Windows Server node pools](https://docs.cloud.google.com/kubernetes-engine/distributed-cloud/vmware/docs/how-to/user-guide-for-windows-server-os-node-pools.md.txt).