Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update vSphere Prereq Doc #6670

Merged
merged 3 commits into from
Oct 3, 2023
Merged

Update vSphere Prereq Doc #6670

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
8297c30
Update vSphere Prereq Doc
tatlat Sep 8, 2023
8c123f9
fix relref
tatlat Oct 2, 2023
db0c91c
fix typo in relref
tatlat Oct 3, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/content/en/docs/getting-started/vsphere/customize/vsphere-ovas.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ description: >

If you want to specify an OVA template, you will need to import OVA files into vSphere before you can use it in your EKS Anywhere cluster.
This guide was written using VMware Cloud on AWS,
but the [VMware OVA import guide can be found here](https://docs.vmware.com/en/VMware-vSphere/7.0/com.vmware.vsphere.vm_admin.doc/GUID-17BEDA21-43F6-41F4-8FB2-E01D275FE9B4.html).
but the [VMware OVA import guide can be found here.](https://docs.vmware.com/en/VMware-vSphere/7.0/com.vmware.vsphere.vm_admin.doc/GUID-17BEDA21-43F6-41F4-8FB2-E01D275FE9B4.html)

{{% alert title="Note" color="primary" %}}
If you don't specify a template in the cluster spec file, EKS Anywhere will use the proper default one for the Kubernetes minor version and OS family you specified in the spec file.
Expand All @@ -29,7 +29,7 @@ EKS Anywhere supports the following operating system families
* Ubuntu
* RHEL

A list of OVAs for this release can be found on the [artifacts page]({{< relref "../../../osmgmt/artifacts" >}}).
A list of OVAs for this release can be found on the [artifacts page.]({{< relref "../../../osmgmt/artifacts" >}})

## Using vCenter Web User Interface

Expand Down
22 changes: 11 additions & 11 deletions docs/content/en/docs/getting-started/vsphere/vsphere-prereq.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,15 +15,15 @@ Set up an Administrative machine as described in [Install EKS Anywhere ]({{< rel

### Prepare a VMware vSphere environment
To prepare a VMware vSphere environment to run EKS Anywhere, you need the following:
* A vSphere 7+ environment running vCenter
* Capacity to deploy 6-10 VMs
* [DHCP service]({{< relref "customize/vsphere-dhcp/" >}}) running in vSphere environment in the primary VM network for your workload cluster
* A vSphere 7+ environment running vCenter.
* Capacity to deploy 6-10 VMs.
* [DHCP service]({{< relref "customize/vsphere-dhcp/" >}}) running in vSphere environment in the primary VM network for your workload cluster.
* [Prepare DHCP IP addresses pool]({{< relref "../../clustermgmt/cluster-upgrades/vsphere-and-cloudstack-upgrades.md/#prepare-dhcp-ip-addresses-pool" >}})
* One network in vSphere to use for the cluster. EKS Anywhere clusters need access to vCenter through the network to enable self-managing and storage capabilities.
* An [OVA]({{< relref "customize/vsphere-ovas/" >}}) imported into vSphere and converted into a template for the workload VMs
* User credentials to create VMs and attach networks, etc
* It's critical that you set up your [vSphere user credentials properly.]({{< relref "./vsphere-preparation#configuring-vsphere-user-group-and-roles" >}})
* One IP address routable from cluster but excluded from DHCP offering.
This IP address is to be used as the [Control Plane Endpoint IP]({{< relref "./vsphere-spec/#controlplaneconfigurationendpointhost-required" >}})
This IP address is to be used as the [Control Plane Endpoint IP.]({{< relref "./vsphere-spec/#controlplaneconfigurationendpointhost-required" >}})

Below are some suggestions to ensure that this IP address is never handed out by your DHCP server.

Expand All @@ -50,10 +50,10 @@ The administrative machine and the target workload environment will need network
You need to get the following information before creating the cluster:

* **Static IP Addresses**:
You will need one IP address for the management cluster control plane endpoint, and a separate one for the controlplane of each workload cluster you add.
You will need one IP address for the management cluster control plane endpoint, and a separate IP address for the control plane of each workload cluster you add.

Let’s say you are going to have the management cluster and two workload clusters.
For those, you would need three IP addresses, one for each.
For those, you would need three IP addresses, one for each cluster.
All of those addresses will be configured the same way in the configuration file you will generate for each cluster.

A static IP address will be used for each control plane VM in your EKS Anywhere cluster.
Expand All @@ -79,14 +79,14 @@ A separate IP address must be assigned for each workload cluster.
* **thumbprint** (required if insecure=false): The SHA1 thumbprint of the vCenter server certificate which is only required if you have a self-signed certificate for your vSphere endpoint.

There are several ways to obtain your vCenter thumbprint.
If you have [govc installed](https://github.com/vmware/govmomi/blob/master/govc/README.md), you can run the following command in the Administrative machine terminal, and take a note of the output:
If you have [govc installed,](https://github.com/vmware/govmomi/blob/master/govc/README.md) you can run the following command in the Administrative machine terminal, and take a note of the output:

```bash
govc about.cert -thumbprint -k
```

* **template**: The VM template to use for your EKS Anywhere cluster.
This template was created when you imported the OVA file into vSphere.
This template was created when you imported the [OVA file]({{< relref "./vsphere-preparation#deploy-an-ova-template" >}}) into vSphere.

![Import ova wizard](/images/ovatemplate.png)

Expand All @@ -96,14 +96,14 @@ This template was created when you imported the OVA file into vSphere.


* **folder**:
The folder parameter in VSphereMachineConfig allows you to organize the VMs of an EKS Anywhere cluster.
The [folder]({{< relref "./vsphere-preparation#configuring-folder-resources" >}}) parameter in VSphereMachineConfig allows you to organize the VMs of an EKS Anywhere cluster.
With this, each cluster can be organized as a folder in vSphere.
You will have a separate folder for the management cluster and each cluster you are adding.

![Import ova wizard](/images/folder.png)


* **resourcePool**:
The vSphere Resource pools for your VMs in the EKS Anywhere cluster. If there is a resource pool: `/<datacenter>/host/<resource-pool-name>/Resources`
The vSphere resource pools for your VMs in the EKS Anywhere cluster. If there is a resource pool: `/<datacenter>/host/<resource-pool-name>/Resources`

![Import ova wizard](/images/resourcepool.png)