This is a beginner's guide to help you get started with Baasil CLI (open source CLI tool) and Baasil.io (a hosted Rancher/Kubernetes control panel/service).
The Baasil CLI allows you to perform deployment of SCC-based (SocketCluster) services/apps without having to know anything about Kubernetes (K8s) or how to scale SocketCluster. Baasil CLI offers a simplified interface for running
kubectl commands - It should work with any Kubernetes cluster (but it was tested with Rancher). Baasil CLI is optimized for maximum flexibility - You can use
baasil commands in conjunction with more advanced
kubectl commands to get fine-tuned control over your cluster and services.
It is recommended that you go through each section of this guide sequentially since each section builds on top of the previous one. If you just want to run SC locally inside a Docker container, then you only need to go through the first two guides 'Setting up' and 'Running your app locally'.
The guides on K8s should require a bit more time to go through but once you've completed the initial setup and deployment, adding new hosts and deploying services should be really easy (single-line command for deployments).
This guide tries to be as thorough as possible in its descriptions - You don't need to know how to use EC2 or Docker/DockerHub in order to setup and use Baasil CLI or Baasil.io. All the steps in this guide have been tested on both Linux (Ubuntu) and OSX.