tsuru is an extensible and open source Platform as a Service (PaaS) that makes application deployments faster and easier. With tsuru, you don’t need to think about servers at all. As an application developer, you can:
- Write apps in the programming language of your choice
- Back apps with add-on resources such as SQL and NoSQL databases, including memcached, Redis, and many others
- Manage apps using the
tsurucommand-line tool
Links:
- Landing page: https://tsuru.io
- Full Documentation: https://docs.tsuru.io/main/
- How to Contribute: https://docs.tsuru.io/stable/contributing/
- Repository & Issue Tracker: https://github.com/tsuru/tsuru
- Talk to us on Gitter: https://gitter.im/tsuru/tsuru
Popular platforms supported:
Download the latest release for your platform at: https://github.com/tsuru/tsuru-client/releases/
Example for release 1.1.1 and OS X:
$ curl -sSL https://github.com/tsuru/tsuru-client/releases/download/1.1.1/tsuru-1.1.1-darwin_amd64.tar.gz | tar xz
If everything's gone well you have the tsuru running in a Kubernetes Cluster.
Call app list to see tsuru working, this command needs to return one app called tsuru-dashboard.
$ tsuru app list
Before starting, make sure you have the following tools installed:
You'll also need the Tsuru Client to interact with the Tsuru API. If you haven't installed it yet, please do so.
For macOS users: We recommend using the qemu driver with socket_vmnet for Minikube clusters. For more information on installing qemu and socket_vmnet, refer to the following links:
Note: If you are using Docker-compatible alternatives like Podman, be sure to specify the DOCKER variable with the
correct binary when running make commands. For example: make local.run DOCKER=podman.
To run the Tsuru API locally, you'll need to first set up the local environment. This setup process is crucial because it creates the default configuration files, initializes required dependencies, and prepares your local system to host the Tsuru API. The following command will handle all these tasks:
make local.setupOnce the setup is complete, you won’t need to run this command again unless you want to reset your environment.
After the initial setup, you can start the Tsuru API and its dependencies using the following command:
make local.runOnce the Tsuru API is running, open a new terminal window and configure your Tsuru CLI to point to the local-dev target.
This target tells the CLI to interact with your local Tsuru API instance rather than a remote server.
You can set the target using this command:
tsuru target-set local-devTsuru's targets function similarly to Kubernetes' kubectl config contexts, allowing you to switch between different environments easily.
To confirm that everything is set up correctly, you can log in and list the clusters managed by your Tsuru API instance:
tsuru login [email protected] # password: admin@123
tsuru cluster listIf everything is working as expected, you should see your local Minikube cluster listed as the default provisioner.
When you're done working with your local environment, it's important to stop the services to free up system resources. You can stop the dependencies using:
make local.stopIf you want to fully reset your environment, or if you no longer need the Tsuru API and its dependencies on your local machine, you can remove all associated resources using:
make local.cleanup
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent