Goat-one

OpenNebula client for goat - Go Accounting Tool.

The Goat-one client is a command-line tool that connects to an OpenNebula cloud, extracts data about virtual machines, virtual networks, users and images, filters them accordingly and then sends them to a goat server for further processing.

The data are filtered by time. Filter allows the records from time, to time or for a period. It cannot filter the records from/to and records for a period in the same time. Time from and time to can be used independently. Time from has to be earlier than time to.

See goat wiki for more info.

Requirements

• Go 1.11 or newer
• OpenNebula instance
• Goat server

Installation

The recommended way to install this tool is using go get:

go get -u github.com/goat-project/goat-one

Configuration

Usage of goat-one:

Usage:
  goat-one [flags]
  goat-one [command]

Available Commands:
  help        Help about any command
  network     Extract network data
  storage     Extract storage data
  vm          Extract virtual machine data

Flags:
  -d, --debug string                 debug
  -e, --endpoint string              goat server [GOAT_SERVER_ENDPOINT] (required)
  -h, --help                         help for goat-one
  -i, --identifier string            goat identifier [IDENTIFIER] (required)
      --log-path string              path to log file
  -o, --opennebula-endpoint string   OpenNebula endpoint [OPENNEBULA_ENDPOINT] (required)
  -s, --opennebula-secret string     OpenNebula secret [OPENNEBULA_SECRET] (required)
      --opennebula-timeout string    timeout for OpenNebula calls [TIMEOUT_FOR_OPENNEBULA_CALLS] (required)
  -p, --records-for-period string    records for period [TIME PERIOD]
  -f, --records-from string          records from [TIME]
  -t, --records-to string            records to [TIME]
      --version                      version for goat-one

Use "goat-one [command] --help" for more information about a command.

Example

Extract virtual machine data from the last 5 years and save it with identifier 'goat-vm'.

go run goat-one.go vm -p 5y -i goat-vm

Container

The goat should run into the container described in Dockerfile. Build and run commands:

docker image build -t goat-one-image .
docker run --rm -it --network host --name goat-one --volume goat-one:/var/goat-one goat-one-image

Contributing

1. Fork goat-one
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request