To use the basic features of Baasil CLI (to run your SocketCluster app locally in a Docker container), you will need to install the following software on your local machine (for each one, follow the installation instructions for your operating system):
If you also want to deploy an auto-scaling SCC service to Kubernetes with the Baasil CLI, you will also need to install
- kubectl (Kubernetes client)
If you're running Linux, you can download the binaries https://coreos.com/kubernetes/docs/latest/configure-kubectl.html (don't worry about configuring kubectl though). On OSX, the easiest way is to install with the command
brew install kubernetes-cli. If you have issues with the previous steps, you can also follow the instructions here: http://kubernetes.io/docs/getting-started-guides/binary_release/
For K8s deployment, you should also sign up for an account with the following services:
Note that you can use your own custom infrastructure with Baasil CLI, but Amazon EC2 is the easiest way to get started (it is currently the best documented approach).
DockerHub allows you to store Docker container images which will be automatically created (and consumed) by Baasil/Rancher/Kubernetes - By default, DockerHub lets you have unlimited public images but it only lets you have a single private image - If you would like more private images (for hosting your private code), you will need to upgrade your DockerHub account or run your own image registry server.
Once you have installed the programs above and signed up for the necessary services.
You should install the
baasil cli tool from
sudo npm install -g baasil
Or on Windows:
npm install -g baasil
This CLI tool isn't absolutely necessary to run and deploy SCC apps but it makes things a lot easier (I.e. it abstracts away more complex
kubectl commands to simplify the workflow). The
baasil CLI is open source and can work with any Kubernetes cluster (not necessarily through the Baasil.io hosted Rancher/K8s service).