shinanca / oneview-golang

Golang bindings for OneView api's

HPE OneView golang bindings

HPE OneView allows you to treat your physical infrastructure as code, and now you can integrate your favorite tools based in golang with HPE OneView.

Build requirements

We use docker to build and test, run this project on a system that has docker. If you don't use docker, you will need to install and setup go-lang locally as well as any other make requirements. You can use USE_CONTAINER=false environment setting for make to avoid using docker. Otherwise make sure to have these tools:

• docker client and daemon
• gnu make tools

Environment Variables

Following environment variables can be set for testing:

# Required
export ONEVIEW_OV_ENDPOINT=<ov_endpoint>

export ONEVIEW_OV_USER=<ov_username>
export ONEVIEW_OV_PASSWORD=<ov_password>
export ONEVIEW_OV_DOMAIN=LOCAL
export ONEVIEW_SSLVERIFY=false
export ONEVIEW_APIVERSION=<ov_apiversion>

Note: Currently this SDK supports OneView API 1200 minimally where we can test OneView API 1200 version with this SDK. No new fields have been added/deleted to support API 1200 version. Complete support will be done in next releases.

Testing your changes

From a container

make test

Without docker

• Install golang 1.5 or higher(We recommend using Go 1.11)
• Install go packages listed in .travis.yml

USE_CONTAINER=false make test

Contributing

We welcome your contributions to the HPE OneView golang SDK. See CONTRIBUTING.md for more details.

Hacking Guide

Use the hacking guide to run local acceptance testing and debugging local contributions. Currently test cases are not supported portion of our CI/CD approval process but might be made available from this test suite in the future. Contributions to the test suite is appreciated.

License

This project is licensed under the Apache License, Version 2.0. See LICENSE for full license text.