Installing tsuru clients¶
tsuru contains three clients: tsuru, tsuru-admin and crane.
- tsuru is the command line utility used by application developers, that will allow users to create, list, bind and manage apps. For more details, check tsuru usage;
- crane is used by service administrators. For more detail, check crane usage;
- tsuru-admin is used by cloud administrators. Whoever is allowed to use it has gotten super powers :-)
This document describes how you can install those clients, using pre-compiled binaries or building them from source.
Using homebrew (Mac OS X only)¶
Mavericks note: Go 1.1 fails to compile with clang. In order to install Tsuru on Mavericks, you will need to install Go 1.2rc, running brew install go --devel.
If you use Mac OS X and homebrew, you may use a custom tap to install tsuru, crane and tsuru-admin. First you need to add the tap:
$ brew tap globocom/homebrew-tsuru
Now you can install tsuru, tsuru-admin and crane:
$ brew install tsuru $ brew install tsuru-admin $ brew install crane
Whenever a new version of any of tsuru’s clients is out, you can just run:
$ brew update $ brew upgrade <formula> # tsuru/tsuru-admin/crane
For more details on taps, check homebrew documentation.
NOTE: Tsuru requires Go 1.1 or higher. Make sure you have the last version of Go installed in your system.
Using the PPA (Ubuntu only)¶
Ubuntu users can install Tsuru clients using apt-get and the Tsuru PPA. You’ll need to add the PPA repository locally and run an apt-get update:
$ sudo apt-add-repository ppa:tsuru/ppa $ sudo apt-get update
Now you can install Tsuru’s clients:
$ sudo apt-get install tsuru $ sudo apt-get install crane $ sudo apt-get install tsuru-admin
Pre-built binaries (Linux and Mac OS X)¶
tsuru clients are also distributed in binary version, so you can just download an executable and put them somewhere in your PATH.
It’s important to note that all binaries are platform dependent. Currently, we provide each of them in three flavors:
- darwin_amd64: This is Mac OS X, 64 bits. Make sure the command uname -ms prints “Darwin x86_64”, otherwise this binary will not work in your system;
- linux_386: This is Linux, 32 bits. Make sure the command uname -ms prints “Linux x86”, otherwise this binary will not work in your system;
- linux_amd64: This is Linux, 64 bits. Make sure the command uname -ms prints “Linux x86_64”, otherwise this binary will not work in your system.
Below are the links to the binaries, you can just download, extract the archive and put the binary somewhere in your PATH:
- tsuru: https://s3.amazonaws.com/tsuru/dist-cmd/tsuru-darwin-amd64.tar.gz
- tsuru-admin: https://s3.amazonaws.com/tsuru/dist-cmd/tsuru-admin-darwin-amd64.tar.gz
- crane: https://s3.amazonaws.com/tsuru/dist-cmd/crane-darwin-amd64.tar.gz
- tsuru: https://s3.amazonaws.com/tsuru/dist-cmd/tsuru-linux-386.tar.gz
- tsuru-admin: https://s3.amazonaws.com/tsuru/dist-cmd/tsuru-admin-linux-386.tar.gz
- crane: https://s3.amazonaws.com/tsuru/dist-cmd/crane-linux-386.tar.gz
Build from source (Linux and Mac OS X)¶
With Go installed and configured, you can use go get to install any of tsuru’s clients:
$ go get github.com/globocom/tsuru/cmd/tsuru $ go get github.com/globocom/tsuru/cmd/tsuru-admin $ go get github.com/globocom/tsuru/cmd/crane