This repository has been archived by the owner. It is now read-only.
NO LONGER MAINTAINED
Java
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
src
.gitignore
README.md
pom.xml

README.md

JiBoCo: JiffyBox Console


A simple command-line utility to interact with the JiffyBox API.

JiffyBox is a German VPS hosting company similar to Linode but with pricing per hour like Amazon EC2. They offer API access to their service allowing customers to provision, start, stop and delete VPS instances via an HTTP REST interface in addition to their own web interface. The API also allows access to advanced features such as conducting backups and modifing the pricing plan.

Building and Installing

Requirements

  • Java 1.6 JDK
  • Maven 2.0 +

Build the JiBoCo JAR as follows:

            cd jiboco
            mvn clean install

A JAR file will be generated in the jiboco/target directory named jiboco-VERSION.jar. The JAR is self-contained and executable so it be moved and renamed if desired or left right where it is.

Running

The JAR is executable so run it as follows:

            java -jar jiboco.jar

Before doing so, you will need to create a file with your JiffyBox API token. Create a file in your home directory named .jiffybox ($HOME/.jiffybox). In this file add the following line with your API token:

            token=<API TOKEN>

Features

  • Commands to list, start and stop VPS instances.
  • Minimal external dependencies. Currently only using google-gson JSON library and the internal Java HTTP client.
  • Code contains a main class encapsulating all logic that is separate from the console code. This can be used apart from this project.

Syntax

	java -jar jiboco.jar <cmd>

Commands

	help [cmd]			Show help.
	ls  [box-id]		List JiffyBox instances.
	box <box-id> <cmd>	Start, stop, freeze or kill a JiffyBox instance.

Examples

	java -jar jiboco.jar ls
	id         name       status     IP             
	12345      Test       STOPPED    188.93.14.176 

	java -jar jiboco.jar box 12345 start
	status: UPDATING            
	status: UPDATING            
	status: READY            

Roadmap

  • add support for provisioning new VPS instances and deleting existing VPS instances.