Skip to content

Commit 3522d6d

Browse files
kerneltimedevin-donnelly
authored andcommitted
Update documentation for vsphere cloud provider. (kubernetes#1102)
This update adds the new configuration needed to configure the vsphere cloud provider.
1 parent df7afa6 commit 3522d6d

File tree

1 file changed

+30
-4
lines changed

1 file changed

+30
-4
lines changed

docs/getting-started-guides/vsphere.md

+30-4
Original file line numberDiff line numberDiff line change
@@ -25,10 +25,14 @@ mkdir -p $GOPATH
2525
export PATH=$PATH:$GOPATH/bin
2626
```
2727

28-
4. Install the govc tool to interact with ESXi/vCenter:
28+
4. Install the govc tool to interact with ESXi/vCenter. Head to [govc Releases](https://github.com/vmware/govmomi/releases) to download the latest.
2929

3030
```shell
31-
go get github.com/vmware/govmomi/govc
31+
# Sample commands for v0.8.0 for 64 bit Linux.
32+
curl -OL https://github.com/vmware/govmomi/releases/download/v0.8.0/govc_linux_amd64.gz
33+
gzip -d govc_linux_amd64.gz
34+
chmod +x govc_linux_amd64
35+
mv govc_linux_amd64 /usr/local/bin/govc
3236
```
3337

3438
5. Get or build a [binary release](/docs/getting-started-guides/binary_release)
@@ -43,7 +47,7 @@ md5sum -c kube.vmdk.gz.md5
4347
gzip -d kube.vmdk.gz
4448
```
4549

46-
Import this VMDK into your vSphere datastore:
50+
Configure the environment for govc
4751

4852
```shell
4953
export GOVC_URL='hostname' # hostname of the vc
@@ -52,9 +56,30 @@ export GOVC_PASSWORD='password' # password for the above username
5256
export GOVC_NETWORK='Network Name' # Name of the network the vms should join. Many times it could be "VM Network"
5357
export GOVC_INSECURE=1 # If the host above uses a self-signed cert
5458
export GOVC_DATASTORE='target datastore'
59+
# To get resource pool via govc: govc ls -l 'host/*' | grep ResourcePool | awk '{print $1}' | xargs -n1 -t govc pool.info
5560
export GOVC_RESOURCE_POOL='resource pool or cluster with access to datastore'
5661
export GOVC_GUEST_LOGIN='kube:kube' # Used for logging into kube.vmdk during deployment.
62+
export GOVC_PORT=443 # The port to be used by vSphere cloud provider plugin
63+
# To get datacente via govc: govc datacenter.info
64+
export GOVC_DATACENTER='ha-datacenter' # The datacenter to be used by vSphere cloud provider plugin
65+
```
66+
67+
Sample environment
68+
```shell
69+
export GOVC_URL='10.161.236.217'
70+
export GOVC_USERNAME='administrator'
71+
export GOVC_PASSWORD='MyPassword1'
72+
export GOVC_NETWORK='VM Network'
73+
export GOVC_INSECURE=1
74+
export GOVC_DATASTORE='datastore1'
75+
export GOVC_RESOURCE_POOL='/Datacenter/host/10.20.104.24/Resources'
76+
export GOVC_GUEST_LOGIN='kube:kube'
77+
export GOVC_PORT='443'
78+
export GOVC_DATACENTER='Datacenter'
79+
```
5780

81+
Import this VMDK into your vSphere datastore:
82+
```shell
5883
govc import.vmdk kube.vmdk ./kube/
5984
```
6085

@@ -63,6 +88,7 @@ Verify that the VMDK was correctly uploaded and expanded to ~3GiB:
6388
```shell
6489
govc datastore.ls ./kube/
6590
```
91+
6692
If you need to debug any part of the deployment, the guest login for
6793
the image that you imported is `kube:kube`. It is normally specified
6894
in the GOVC_GUEST_LOGIN parameter above.
@@ -110,7 +136,7 @@ going on (find yourself authorized with your SSH key, or use the password
110136

111137
IaaS Provider | Config. Mgmt | OS | Networking | Docs | Conforms | Support Level
112138
-------------------- | ------------ | ------ | ---------- | --------------------------------------------- | ---------| ----------------------------
113-
Vmware vSphere | Saltstack | Debian | OVS | [docs](/docs/getting-started-guides/vsphere) | | Community ([@imkin](https://github.com/imkin))
139+
Vmware vSphere | Saltstack | Debian | OVS | [docs](/docs/getting-started-guides/vsphere) | | Community ([@imkin](https://github.com/imkin)), ([@abrarshivani](https://github.com/abrarshivani)), ([@kerneltime](https://github.com/kerneltime)), ([@kerneltime](https://github.com/luomiao))
114140

115141
For support level information on all solutions, see the [Table of solutions](/docs/getting-started-guides/#table-of-solutions) chart.
116142

0 commit comments

Comments
 (0)