kops/vendor/github.com/vmware/govmomi
Justin Santa Barbara 6b6f9db0ef Run make dep-ensure to use dep for vendor directory 2018-02-04 22:08:16 -05:00
..
find gazelle updates with new bazel version 2017-11-05 17:41:53 -07:00
govc/test Run make dep-ensure to use dep for vendor directory 2018-02-04 22:08:16 -05:00
list Run make dep-ensure to use dep for vendor directory 2018-02-04 22:08:16 -05:00
object Run make dep-ensure to use dep for vendor directory 2018-02-04 22:08:16 -05:00
property Run make dep-ensure to use dep for vendor directory 2018-02-04 22:08:16 -05:00
scripts Run make dep-ensure to use dep for vendor directory 2018-02-04 22:08:16 -05:00
session Run make dep-ensure to use dep for vendor directory 2018-02-04 22:08:16 -05:00
task Run make dep-ensure to use dep for vendor directory 2018-02-04 22:08:16 -05:00
vim25 Run make dep-ensure to use dep for vendor directory 2018-02-04 22:08:16 -05:00
.drone.yml Added govmomi project as a submodule in kops 2017-04-11 10:08:22 -07:00
.gitignore Added govmomi project as a submodule in kops 2017-04-11 10:08:22 -07:00
.mailmap Populate vendor 2017-07-02 13:10:28 -04:00
.travis.yml Added govmomi project as a submodule in kops 2017-04-11 10:08:22 -07:00
BUILD.bazel Run make dep-ensure to use dep for vendor directory 2018-02-04 22:08:16 -05:00
CHANGELOG.md Populate vendor 2017-07-02 13:10:28 -04:00
CONTRIBUTING.md Added govmomi project as a submodule in kops 2017-04-11 10:08:22 -07:00
CONTRIBUTORS Populate vendor 2017-07-02 13:10:28 -04:00
LICENSE.txt Added govmomi project as a submodule in kops 2017-04-11 10:08:22 -07:00
Makefile Added govmomi project as a submodule in kops 2017-04-11 10:08:22 -07:00
README.md Populate vendor 2017-07-02 13:10:28 -04:00
client.go Added govmomi project as a submodule in kops 2017-04-11 10:08:22 -07:00

README.md

Build Status Go Report Card

govmomi

A Go library for interacting with VMware vSphere APIs (ESXi and/or vCenter).

For govc, a CLI built on top of govmomi, check out the govc directory and USAGE document.

Compatibility

This library is built for and tested against ESXi and vCenter 5.5, 6.0 and 6.5.

If you're able to use it against older versions of ESXi and/or vCenter, please leave a note and we'll include it in this compatibility list.

Documentation

The APIs exposed by this library very closely follow the API described in the VMware vSphere API Reference Documentation. 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 for documentation.

Building with CI

Merges to this repository will trigger builds in both Travis and Drone.

To build locally with Drone:

  • Ensure that you have Docker 1.6 or higher installed.
  • Install the Drone command line tools.
  • Run drone exec from within the root directory of the govmomi repository.

Discussion

Contributors and users are encouraged to collaborate using GitHub issues and/or Slack. Access to Slack requires a VMware {code} membership.

Status

Changes to the API are subject to semantic versioning.

Refer to the CHANGELOG for version to version changes.

Projects using govmomi

License

govmomi is available under the Apache 2 license.