richard
/
kubespray
mirror of https://github.com/kubernetes-sigs/kubespray.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
2369 Commits
29 Branches
80 Tags
156 MiB
Tree: b135bcb9d9
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'b135bcb9d9'
${ noResults }
kubespray/docs/vsphere.md

61 lines
5.1 KiB
Raw Normal View History

add vsphere cloud provider doc fix typo
7 years ago
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
  1. # vSphere cloud provider
  3. Kubespray can be deployed with vSphere as Cloud provider. This feature supports
  4. - Volumes
  5. - Persistent Volumes
  6. - Storage Classes and provisioning of volumes.
  7. - vSphere Storage Policy Based Management for Containers orchestrated by Kubernetes.
  9. ## Prerequisites
  11. You need at first to configure you vSphere environement by following the [official documentation](https://kubernetes.io/docs/getting-started-guides/vsphere/#vsphere-cloud-provider).
  13. After this step you should have:
  14. - UUID activated for each VM where Kubernetes will be deployed
  15. - A vSphere account with required privileges
  17. ## Kubespray configuration
  19. Fist you must define the cloud provider in `inventory/group_vars/all.yml` and set it to `vsphere`.
  20. ```yml
  21. cloud_provider: vsphere
  22. ```
  24. Then, in the same file, you need to declare your vCenter credential following the description bellow.
  26. | Variable | Required | Type | Choices | Default | Comment |
  27. |------------------------------|----------|---------|----------------------------|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
  28. | vsphere_vcenter_ip | TRUE | string | | | IP/URL of the vCenter |
  29. | vsphere_vcenter_port | TRUE | integer | | | Port of the vCenter API. Commonly 443 |
  30. | vsphere_insecure | TRUE | integer | 1, 0 | | set to 1 if the host above uses a self-signed cert |
  31. | vsphere_user | TRUE | string | | | User name for vCenter with required privileges |
  32. | vsphere_password | TRUE | string | | | Password for vCenter |
  33. | vsphere_datacenter | TRUE | string | | | Datacenter name to use |
  34. | vsphere_datastore | TRUE | string | | | Datastore name to use |
  35. | vsphere_working_dir | TRUE | string | | | Working directory from the view "VMs and template" in the vCenter where VM are placed |
  36. | vsphere_scsi_controller_type | TRUE | string | buslogic, pvscsi, parallel | pvscsi | SCSI controller name. Commonly "pvscsi". |
  37. | vsphere_vm_uuid | FALSE | string | | | VM Instance UUID of virtual machine that host K8s master. Can be retrieved from instanceUuid property in VmConfigInfo, or as vc.uuid in VMX file or in `/sys/class/dmi/id/product_serial` |
  38. | vsphere_public_network | FALSE | string | | Blank | Name of the network the VMs are joined to |
  40. Example configuration
  41. ```yml
  42. vsphere_vcenter_ip: "myvcenter.domain.com"
  43. vsphere_vcenter_port: 443
  44. vsphere_insecure: 1
  45. vsphere_user: "k8s@vsphere.local"
  46. vsphere_password: "K8s_admin"
  47. vsphere_datacenter: "DATACENTER_name"
  48. vsphere_datastore: "DATASTORE_name"
  49. vsphere_working_dir: "Docker_hosts"
  50. vsphere_scsi_controller_type: "pvscsi"
  51. ```
  53. ## Deployment
  55. Once the configuration is set, you can execute the playbook again to apply the new configuration
  56. ```
  57. cd kubespray
  58. ansible-playbook -i inventory/inventory.cfg -b -v cluster.yml
  59. ```
  61. You'll find some usefull examples [here](https://github.com/kubernetes/kubernetes/tree/master/examples/volumes/vsphere) to test your configuration.