Tsuru Documentation

tsuru Documentation

Release 0.1 timeredbull

June 25, 2014

Contents

1 Using Tsuru

1

1.1 Application Deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

1.2 CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

1.3 Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

2 Running Tsuru

3

2.1 Deploy Tsuru . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

2.2 Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

3 Get Involved

5

3.1 API reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

3.2 Build your own PaaS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

3.3 community . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

3.4 Configuring tsuru . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

3.5 contribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

3.6 Build your own PaaS with tsuru and Docker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

3.7 Build your own PaaS with tsuru and Docker on Centos . . . . . . . . . . . . . . . . . . . . . . . . . 33

3.8 Download . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

3.9 Tsuru Frequently Asked Questions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

3.10 Tsuru Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

3.11 Why Tsuru? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

3.12 Deployment hooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

3.13 Application Deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

3.14 Building your app in tsuru . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

3.15 Coding style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

3.16 Setting up you tsuru development environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

3.17 Installing tsuru clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

3.18 Howto install a dns forwarder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

3.19 Backing up tsuru database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

3.20 Server installation guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

3.21 api workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

3.22 Building your service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

3.23 HOWTO Install a MySQL service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

3.24 Crane usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

3.25 Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

3.26 Client usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

3.27 Deploying PHP applications in tsuru . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

3.28 Deploying Python applications in tsuru . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

i

3.29 Deploying Ruby applications in tsuru . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 3.30 Docker Provisioner Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

ii

? Why Tsuru?. ? Overview ? FAQ.

1.1 Application Deployment

? building your application ? python/django ? ruby/rails ? php ? understanding deployment hooks

1.2 CLI

? clients installation guide ? Tsuru client usage guide

1.3 Services

? using services

CHAPTER 1 Using Tsuru

1

tsuru Documentation, Release 0.1

2

Chapter 1. Using Tsuru

2.1 Deploy Tsuru

? Tsuru and juju ? docker provisioner architecture ? Tsuru and docker on ubuntu ? Tsuru and docker on centos ? configuration ? backing up Tsuru ? api reference

2.2 Services

? building your service ? crane usage guide ? services api workflow

CHAPTER 2 Running Tsuru

3

tsuru Documentation, Release 0.1

4

Chapter 2. Running Tsuru

 ................
................

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download