diff --git a/docs/getting-started-guides/vsphere.md b/docs/getting-started-guides/vsphere.md index adab2b9027..b3679c56e8 100644 --- a/docs/getting-started-guides/vsphere.md +++ b/docs/getting-started-guides/vsphere.md @@ -25,10 +25,14 @@ mkdir -p $GOPATH export PATH=$PATH:$GOPATH/bin ``` -4. Install the govc tool to interact with ESXi/vCenter: +4. Install the govc tool to interact with ESXi/vCenter. Head to [govc Releases](https://github.com/vmware/govmomi/releases) to download the latest. ```shell -go get github.com/vmware/govmomi/govc +# Sample commands for v0.8.0 for 64 bit Linux. +curl -OL https://github.com/vmware/govmomi/releases/download/v0.8.0/govc_linux_amd64.gz +gzip -d govc_linux_amd64.gz +chmod +x govc_linux_amd64 +mv govc_linux_amd64 /usr/local/bin/govc ``` 5. Get or build a [binary release](/docs/getting-started-guides/binary_release) @@ -43,7 +47,7 @@ md5sum -c kube.vmdk.gz.md5 gzip -d kube.vmdk.gz ``` -Import this VMDK into your vSphere datastore: +Configure the environment for govc ```shell export GOVC_URL='hostname' # hostname of the vc @@ -52,9 +56,30 @@ export GOVC_PASSWORD='password' # password for the above username export GOVC_NETWORK='Network Name' # Name of the network the vms should join. Many times it could be "VM Network" export GOVC_INSECURE=1 # If the host above uses a self-signed cert export GOVC_DATASTORE='target datastore' +# To get resource pool via govc: govc ls -l 'host/*' | grep ResourcePool | awk '{print $1}' | xargs -n1 -t govc pool.info export GOVC_RESOURCE_POOL='resource pool or cluster with access to datastore' export GOVC_GUEST_LOGIN='kube:kube' # Used for logging into kube.vmdk during deployment. +export GOVC_PORT=443 # The port to be used by vSphere cloud provider plugin +# To get datacente via govc: govc datacenter.info +export GOVC_DATACENTER='ha-datacenter' # The datacenter to be used by vSphere cloud provider plugin +``` +Sample environment +```shell +export GOVC_URL='10.161.236.217' +export GOVC_USERNAME='administrator' +export GOVC_PASSWORD='MyPassword1' +export GOVC_NETWORK='VM Network' +export GOVC_INSECURE=1 +export GOVC_DATASTORE='datastore1' +export GOVC_RESOURCE_POOL='/Datacenter/host/10.20.104.24/Resources' +export GOVC_GUEST_LOGIN='kube:kube' +export GOVC_PORT='443' +export GOVC_DATACENTER='Datacenter' +``` + +Import this VMDK into your vSphere datastore: +```shell govc import.vmdk kube.vmdk ./kube/ ``` @@ -63,6 +88,7 @@ Verify that the VMDK was correctly uploaded and expanded to ~3GiB: ```shell govc datastore.ls ./kube/ ``` + If you need to debug any part of the deployment, the guest login for the image that you imported is `kube:kube`. It is normally specified in the GOVC_GUEST_LOGIN parameter above. @@ -110,7 +136,7 @@ going on (find yourself authorized with your SSH key, or use the password IaaS Provider | Config. Mgmt | OS | Networking | Docs | Conforms | Support Level -------------------- | ------------ | ------ | ---------- | --------------------------------------------- | ---------| ---------------------------- -Vmware vSphere | Saltstack | Debian | OVS | [docs](/docs/getting-started-guides/vsphere) | | Community ([@imkin](https://github.com/imkin)) +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)) For support level information on all solutions, see the [Table of solutions](/docs/getting-started-guides/#table-of-solutions) chart.