Interact with Pivotal Network from the command-line.
Binaries for various operating systems are provided with each release on the releases page.
Install for OSX via homebrew as follows:
brew install pivotal/tap/pivnet-cli
Using the Pivnet CLI requires a valid Pivotal Network API token.
Refer to the official docs for more details on obtaining a Pivotal Network API token.
Example usage:
$ pivnet --api-token='my-api-token' products
+-----+------------------------------------------------------+--------------------------------+
| ID | SLUG | NAME |
+-----+------------------------------------------------------+--------------------------------+
| 60 | elastic-runtime | Pivotal Cloud Foundry Elastic |
| | | Runtime |
+-----+------------------------------------------------------+--------------------------------+
$ pivnet --api-token='my-api-token' r -p elastic-runtime -r 1.8.8 --format json \
| jq '{"id": .id, "release_date": .release_date, "release_type": .release_type}'
{
"id": 2555,
"release_date": "2016-10-13",
"release_type": "Security Release"
}
A valid install of golang >= 1.6 is required.
Dependencies are vendored in the vendor
directory, according to the
golang 1.5 vendor experiment.
No action is require to fetch the vendored dependencies.
Install the ginkgo executable with:
go get -u github.com/onsi/ginkgo/ginkgo
The tests require a valid Pivotal Network API token and host.
Refer to the official docs for more details on obtaining a Pivotal Network API token.
It is advised to run the acceptance tests against the Pivotal Network integration
environment endpoint i.e. HOST='https://pivnet-integration.cfapps.io'
.
Run the tests with the following command:
API_TOKEN=my-token \
HOST='https://pivnet-integration.cfapps.io' \
./bin/test_all
Please make all pull requests to the develop
branch, and
ensure the tests pass locally.
The CI for this project can be found at https://sunrise.ci.cf-app.com and the scripts can be found in the pivnet-resource-ci repo.
The roadmap is captured in Pivotal Tracker.