2017-07-09 14:56:39 -04:00
|
|
|
[![Build Status](https://travis-ci.org/vmware/govmomi.png?branch=master)](https://travis-ci.org/vmware/govmomi)
|
|
|
|
[![Go Report Card](https://goreportcard.com/badge/github.com/vmware/govmomi)](https://goreportcard.com/report/github.com/vmware/govmomi)
|
|
|
|
|
|
|
|
# govmomi
|
|
|
|
|
|
|
|
A Go library for interacting with VMware vSphere APIs (ESXi and/or vCenter).
|
|
|
|
|
2020-01-08 13:22:55 -05:00
|
|
|
In addition to the vSphere API client, this repository includes:
|
|
|
|
|
|
|
|
* [govc](./govc) - vSphere CLI
|
|
|
|
|
|
|
|
* [vcsim](./vcsim) - vSphere API mock framework
|
|
|
|
|
|
|
|
* [toolbox](./toolbox) - VM guest tools framework
|
2017-07-09 14:56:39 -04:00
|
|
|
|
|
|
|
## Compatibility
|
|
|
|
|
2020-01-08 13:22:55 -05:00
|
|
|
This library is built for and tested against ESXi and vCenter 6.0, 6.5 and 6.7.
|
2017-07-09 14:56:39 -04:00
|
|
|
|
2020-01-08 13:22:55 -05:00
|
|
|
It may work with versions 5.5 and 5.1, but neither are officially supported.
|
2017-07-09 14:56:39 -04:00
|
|
|
|
|
|
|
## Documentation
|
|
|
|
|
|
|
|
The APIs exposed by this library very closely follow the API described in the [VMware vSphere API Reference Documentation][apiref].
|
|
|
|
Refer to this document to become familiar with the upstream API.
|
|
|
|
|
|
|
|
The code in the `govmomi` package is a wrapper for the code that is generated from the vSphere API description.
|
|
|
|
It primarily provides convenience functions for working with the vSphere API.
|
|
|
|
See [godoc.org][godoc] for documentation.
|
|
|
|
|
|
|
|
[apiref]:http://pubs.vmware.com/vsphere-6-5/index.jsp#com.vmware.wssdk.apiref.doc/right-pane.html
|
|
|
|
[godoc]:http://godoc.org/github.com/vmware/govmomi
|
|
|
|
|
2020-01-08 13:22:55 -05:00
|
|
|
## Installation
|
2017-07-09 14:56:39 -04:00
|
|
|
|
2020-01-08 13:22:55 -05:00
|
|
|
```sh
|
|
|
|
go get -u github.com/vmware/govmomi
|
|
|
|
```
|
2017-07-09 14:56:39 -04:00
|
|
|
|
|
|
|
## Discussion
|
|
|
|
|
|
|
|
Contributors and users are encouraged to collaborate using GitHub issues and/or
|
|
|
|
[Slack](https://vmwarecode.slack.com/messages/govmomi).
|
|
|
|
Access to Slack requires a [VMware {code} membership](https://code.vmware.com/join/).
|
|
|
|
|
|
|
|
## Status
|
|
|
|
|
|
|
|
Changes to the API are subject to [semantic versioning](http://semver.org).
|
|
|
|
|
|
|
|
Refer to the [CHANGELOG](CHANGELOG.md) for version to version changes.
|
|
|
|
|
|
|
|
## Projects using govmomi
|
|
|
|
|
|
|
|
* [Docker Machine](https://github.com/docker/machine/tree/master/drivers/vmwarevsphere)
|
|
|
|
|
2020-01-08 13:22:55 -05:00
|
|
|
* [Docker InfraKit](https://github.com/docker/infrakit/tree/master/pkg/provider/vsphere)
|
|
|
|
|
|
|
|
* [Docker LinuxKit](https://github.com/linuxkit/linuxkit/tree/master/src/cmd/linuxkit)
|
|
|
|
|
2017-07-09 14:56:39 -04:00
|
|
|
* [Kubernetes](https://github.com/kubernetes/kubernetes/tree/master/pkg/cloudprovider/providers/vsphere)
|
|
|
|
|
2020-01-08 13:22:55 -05:00
|
|
|
* [Kubernetes Cloud Provider](https://github.com/kubernetes/cloud-provider-vsphere)
|
|
|
|
|
|
|
|
* [Kubernetes Cluster API](https://github.com/kubernetes-sigs/cluster-api-provider-vsphere)
|
|
|
|
|
|
|
|
* [Kubernetes kops](https://github.com/kubernetes/kops/tree/master/upup/pkg/fi/cloudup/vsphere)
|
|
|
|
|
|
|
|
* [Terraform](https://github.com/terraform-providers/terraform-provider-vsphere)
|
|
|
|
|
|
|
|
* [Packer](https://github.com/jetbrains-infra/packer-builder-vsphere)
|
2017-07-09 14:56:39 -04:00
|
|
|
|
|
|
|
* [VMware VIC Engine](https://github.com/vmware/vic)
|
|
|
|
|
|
|
|
* [Travis CI](https://github.com/travis-ci/jupiter-brain)
|
|
|
|
|
|
|
|
* [collectd-vsphere](https://github.com/travis-ci/collectd-vsphere)
|
|
|
|
|
|
|
|
* [Gru](https://github.com/dnaeon/gru)
|
|
|
|
|
|
|
|
* [Libretto](https://github.com/apcera/libretto/tree/master/virtualmachine/vsphere)
|
|
|
|
|
2020-01-08 13:22:55 -05:00
|
|
|
* [Telegraf](https://github.com/influxdata/telegraf/tree/master/plugins/inputs/vsphere)
|
|
|
|
|
|
|
|
* [Open Storage](https://github.com/libopenstorage/openstorage/tree/master/pkg/storageops/vsphere)
|
|
|
|
|
|
|
|
* [Juju](https://github.com/juju/juju)
|
|
|
|
|
2017-07-09 14:56:39 -04:00
|
|
|
## Related projects
|
|
|
|
|
|
|
|
* [rbvmomi](https://github.com/vmware/rbvmomi)
|
|
|
|
|
|
|
|
* [pyvmomi](https://github.com/vmware/pyvmomi)
|
|
|
|
|
|
|
|
## License
|
|
|
|
|
2020-01-08 13:22:55 -05:00
|
|
|
govmomi is available under the [Apache 2 license](LICENSE.txt).
|