vultr

command module

v0.0.0-...-acabab9 Latest Latest Go to latest Published: May 27, 2016 License: MIT Imports: 2 Imported by: 0

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Repository

github.com/LunaNode/vultr

README ¶

vultr

Vultr CLI and API client library, written in Go

Screenshot

Everybody likes screenshots, even of command line tools.. 😄

Installation

Download the latest release for your OS: https://github.com/JamesClonk/vultr/releases
Unzip the file
Place the vultr binary somewhere into your PATH
Export your Vultr API key into a VULTR_API_KEY env variable. You can get the API key from the admin panel

$ export VULTR_API_KEY=87dFbC91rJjkL/18zJEQxS

Run it

$ vultr version
Client version:         v1.8
Vultr API endpoint:     https://api.vultr.com/
Vultr API version:      v1
OS/Arch (client):       linux/amd64
Go version:             go1.5.3

Installation from source

Install the latest version of Go
Make sure your GOPATH is set
Add $GOPATH/bin to your PATH
Use "go get" to download, compile and install the source

$ go get github.com/JamesClonk/vultr

Export your Vultr API key into a VULTR_API_KEY env variable. You can get the API key from the admin panel

$ export VULTR_API_KEY=89dFbb91rGjkL/12zJEQxS

Run it

$ vultr version
Client version:         v1.8
Vultr API endpoint:     https://api.vultr.com/
Vultr API version:      v1
OS/Arch (client):       linux/amd64
Go version:             go1.5.3

Usage

Vultr CLI is a command line tool for using the Vultr API. It allows you to create and manage your virtual machines, SSH public keys, snapshots and startup scripts on your Vultr account. You can also use it to directly SSH into a Vultr virtual machine through the vultr ssh command.

Here a some usage examples:

show help text for a command

$ vultr snapshot --help

Usage: vultr snapshot  COMMAND [arg...]

modify snapshots

Commands:
  create       create a snapshot from an existing virtual machine
  delete       delete a snapshot
  list         list all snapshots on current account

Run 'vultr snapshot COMMAND --help' for more information on a command

list available plans for region

$ vultr plans -r 9

VPSPLANID NAME                                VCPU  RAM   DISK  BANDWIDTH PRICE
30        1024 MB RAM,20 GB SSD,2.00 TB BW    1     1024  20    2.00      7.00
29        768 MB RAM,15 GB SSD,1.00 TB BW     1     768   15    1.00      5.00
3         2048 MB RAM,40 GB SSD,3.00 TB BW    2     2048  40    3.00      15.00
28        8192 MB RAM,120 GB SSD,5.00 TB BW   4     8192  120   5.00      70.00
27        4096 MB RAM,65 GB SSD,4.00 TB BW    2     4096  65    4.00      35.00

add SSH public key

$ vultr sshkey create -n sampleKey --key="$(cat ~/.ssh/id_rsa.pub)"

SSH key create success!

SSHKEYID        NAME        KEY
24c81f53be692   sampleKey   ssh-rsa AAAB3NzaC1yc2EQABAQClpsNAM+huOB2dpxM..

create new virtual machine

$ vultr server create -n "test-server" -r 9 -p 29 -o 127

Virtual machine create success!

SUBID           NAME            DCID    VPSPLANID       OSID
1685097         test-server     9       29              127

show information about virtual machine

$ vultr server show 1685097

Id (SUBID):             1685097
Name:                   test-server
Operating system:       CentOS 6 x64
Status:                 active
Power status:           running
Location:               Frankfurt
Region (DCID):          9
VCPU count:             1
RAM:                    768 MB
Disk:                   Virtual 15 GB
Allowed bandwidth:      1000
Current bandwidth:      0
Cost per month:         5.00
Pending charges:        0.01
Plan (VPSPLANID):       29
IP:                     107.62.131.240
Netmask:                255.255.254.0
Gateway:                107.62.131.1
Internal IP:
#1 IPv6 IP:
#1 IPv6 Network:        ::
#1 IPv6 Network Size:   0
Created date:           2015-02-08 12:36:36
Default password:       sbiecxo8yk!5
Auto backups:           no
KVM URL:                https://my.vultr.com/subs/vps/novnc/api.php?data=ILXS..

SSH into virtual machine

$ vultr ssh 1685097

Welcome to Ubuntu 14.04.1 LTS (GNU/Linux 3.13.0-37-generic x86_64)

 * Documentation:  https://help.ubuntu.com/
Last login: Thu Oct 16 21:49:35 2014 from 10.0.2.2
root@vultr:~#

Documentation ¶

There is no documentation for this package.

Source Files ¶

View all Source files

vultr.go

Directories ¶

Path	Synopsis
Godeps
_workspace/src/github.com/jawher/mow.cli Package cli provides a framework to build command line applications in Go with most of the burden of arguments parsing and validation placed on the framework instead of the user.	Package cli provides a framework to build command line applications in Go with most of the burden of arguments parsing and validation placed on the framework instead of the user.
_workspace/src/github.com/juju/ratelimit The ratelimit package provides an efficient token bucket implementation that can be used to limit the rate of arbitrary things.	The ratelimit package provides an efficient token bucket implementation that can be used to limit the rate of arbitrary things.
_workspace/src/github.com/stretchr/testify/assert Package assert provides a set of comprehensive testing tools for use with the normal Go testing system.	Package assert provides a set of comprehensive testing tools for use with the normal Go testing system.
_workspace/src/golang.org/x/crypto/curve25519 Package curve25519 provides an implementation of scalar multiplication on the elliptic curve known as curve25519.	Package curve25519 provides an implementation of scalar multiplication on the elliptic curve known as curve25519.
_workspace/src/golang.org/x/crypto/ssh Package ssh implements an SSH client and server.	Package ssh implements an SSH client and server.
_workspace/src/golang.org/x/crypto/ssh/agent Package agent implements a client to an ssh-agent daemon.	Package agent implements a client to an ssh-agent daemon.
_workspace/src/golang.org/x/crypto/ssh/terminal Package terminal provides support functions for dealing with terminals, as commonly found on UNIX systems.	Package terminal provides support functions for dealing with terminals, as commonly found on UNIX systems.
_workspace/src/golang.org/x/crypto/ssh/test This package contains integration tests for the golang.org/x/crypto/ssh package.	This package contains integration tests for the golang.org/x/crypto/ssh package.
cmd
lib

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL