Home

Awesome

Gasper

Your Cloud in a Binary

<img align="right" width="350px" height="400px" src="./docs/content/assets/logo/gasperlogo.svg">

Build Status Docs codecov Go Report Card License

Gasper is an intelligent Platform as a Service (PaaS) used for deploying and managing applications and databases in any cloud topology.

Contents

Overview

The Dilemma

Imagine you have a couple of Bare Metal Servers and/or Virtual Machines (collectively called nodes) at your disposal. Now you want to deploy a couple of applications/services to these nodes in such a manner so as to not put too much load on a single node.

Naive Approach

Your 1st option is to manually decide which application goes to which node, then use ssh/telnet to manually setup all of your applications in each node one by one.

A Wise Choice

But you are smarter than that, hence you go for the 2nd option which is Kubernetes. You setup Kubernetes in all of your nodes which forms a cluster, and now you can deploy your applications without worrying about load distribution. But Kubernetes requires a lot of configuration for each application(deployments, services, stateful-sets etc) not to mention pipelines for creating the corresponding docker image.

The Ultimatum

Here comes (🥁drumroll please 🥁) Gasper, your 3rd option!<br> Gasper builds and runs applications in docker containers directly from source code instead of docker images. It requires minimal parameters for deploying an application, so minimal that you can count them on fingers in one hand 🤚. Same goes for Gasper provisioned databases. Gone are the days of hard labour (writing configurations).

Features

Fear not because the reduction in complexity doesn't imply the reduction in features. You can rest assured because Gasper has:-

Supported Languages

Gasper currently supports applications of the following types:-

It ain't much but it's honest work 🥳

Supported Databases

The following databases are supported by Gasper:-

It ain't.... (complete the rest yourself)

Documentation

You can find the complete documentation of Gasper at https://gasper-docs.netlify.com/

Dependencies

The following softwares are required for running Gasper:-

Download

Assuming you have the dependencies installed, head over to Gasper's releases page and grab the latest binary according to your operating system and system architecture

Run the downloaded binary with the sample configuration file

$ ./gasper --conf ./config.toml

Development

You need to have Golang 1.13.x or higher installed along with the mentioned dependencies

Open your favourite terminal and perform the following tasks:-

  1. Cross-check your golang version.

    $ go version
go version go1.13.5 darwin/amd64

  2. Clone this repository.

    $ git clone https://github.com/sdslabs/gasper

  3. Go inside the cloned directory and list available makefile commands.

    $ cd gasper && make help

Gasper: Your cloud in a binary

install   Install missing dependencies
build     Build the project binary
tools     Install development tools
release   Build release binaries
start     Start in development mode with hot-reload enabled
clean     Clean build files
fmt       Format entire codebase
vet       Vet entire codebase
lint      Check codebase for style mistakes
test      Run tests
help      Display this help

  4. Setup project configuration and make changes if required. The configuration file is well-documented so you won't have a hard time looking around.

    $ cp config.sample.toml config.toml

  5. Start the development server.

    $ make start

Contributing

If you'd like to contribute to this project, refer to the contributing documentation.

Meet the A-Team

Contact

If you have a query regarding the product or just want to say hello then feel free to visit chat.sdslabs.co or drop a mail at contact@sdslabs.co.in