pivotal-cf/pivnet-cli

Name: pivnet-cli

Owner: Pivotal Cloud Foundry

Description: CLI to interact with Pivotal Network

Created: 2016-10-17 13:55:52.0

Updated: 2018-05-15 17:03:46.0

Pushed: 2018-05-15 17:03:07.0

Homepage:

Size: 8042

Language: Go

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

Pivnet CLI

Interact with Pivotal Network from the command-line.

Installing

Binaries for various operating systems are provided with each release on the releases page.

Install for OSX via homebrew as follows:

 install pivotal/tap/pivnet-cli

To install on linux, download the latest binary (see latest release) and ensure the file is executable and on the path.

Usage

Using the Pivnet CLI requires a valid Pivotal Network API token or UAA Refresh Token.

Refer to the official docs for more details on obtaining a Pivotal Network API token.

Example usage:

vnet login --api-token='my-api-token'
vnet products

--+------------------------------------------------------+--------------------------------+
  |                         SLUG                         |              NAME              |
--+------------------------------------------------------+--------------------------------+
0 | elastic-runtime                                      | Pivotal Cloud Foundry Elastic  |
  |                                                      | Runtime                        |
--+------------------------------------------------------+--------------------------------+

vnet r -p elastic-runtime -r 1.8.8 --format json \
jq '{"id": .id, "release_date": .release_date, "release_type": .release_type}'


d": 2555,
elease_date": "2016-10-13",
elease_type": "Security Release"

Developing

Prerequisites

A valid install of golang >= 1.6 is required.

Dependencies

Dependencies are vendored in the vendor directory, according to the golang 1.5 vendor experiment.

No action is require to fetch the vendored dependencies.

Running the tests

Install the ginkgo executable with:

et -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:

TOKEN=my-token \
='https://pivnet-integration.cfapps.io' \
n/test_all

Contributing

Please make all pull requests to the develop branch, and ensure the tests pass locally.

Project management

The CI for this project can be found here and the scripts can be found in the pivnet-resource-ci repo.

The roadmap is captured in Pivotal Tracker.