[v0.0.0-beta] Release

.gitignore

@@ -0,0 +1,3 @@
+config/build-context/context.tar.gz
+node_modules
+dist

.npmrc

@@ -0,0 +1,2 @@
+registry=https://registry.npmjs.org/
+save-exact=true

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 Peter Mikitsh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1,38 +1,93 @@
 <div align="center">
   <img height="300" src="./logo.svg">
+  <img src="./demo.png">
 </div>
 
-> :snowflake: **S**elf-hosted **now** deployments 
+> :snowflake: **S**elf-hosted **now** deployments
 
-Enjoy effortless deployments with a clone of [now](https://github.com/zeit/now-cli) on your own hardware.
+Enjoy effortless deployments with a clone of [now] on a cloud of your choosing.
+
+### Features
+
+- ⚡️ Deploy docker images via `snow` (or `snow deploy`)
+- 🔒 Auto-configured SSL
+- 🔃 Auto-scaling
+
+### This is Magic 🔮
+
+No, it isn't. This CLI abstracts away the complexities of using [Kubernetes], [cert-manager], [Kaniko], and a private [Docker Registry] together, replicating the functionality provided by `now`.
 
 ### Getting started
 
-```
-curl -sSL https://get.snowjs.app/ | sh
-npm i -g snow-cli
-snow
+```sh
+> npm i -g @snowjs/cli
+
+# Install CLI tools
+> snow install
+
+# Create your kubernetes cluster (GCP)
+> snow create
+
+# Get your deployment's IP address
+# And create a DNS 'A' record (e.g., myapp.com A 1.2.3.4)
+> snow ip
+
+# Deploy
+> snow
 ```
 
 ### Supported commands
 
-Without arguments, deploys just like `now`.
-
-| Support | Command                | Description       |
-|---------|------------------------|-------------------|
-| :x:     | \<none\>               | Deploy            |
-| :x:     | `alias`                | Alias deployment  |
-| :x:     | `deploy`               | Deploy            |
-| :x:     | `domains`              | List domains      |
-| :x:     | `domains add [domain]` | Add domain        |
-| :x:     | `domains rm [domain]`  | Remove domain     |
-| :x:     | `login`                | Login             |
-| :x:     | `logout`               | Logout            |
-| :x:     | `ls`                   | List deployments  |
-| :x:     | `rm [name]`            | Remove deployment |
-### Flags
-
-| Support | Command | Flag              | Description          |
-|---------|---------|-------------------|----------------------|
-| :x:     | \<all\> | `--token [token]` | Authentication token |
-| :x:     | `login` | `--host [host]`   | Snow server hostname |
+**Detailed** descriptions of supported commands at [docs/commands.md](docs/commands.md).
+
+| Support            | Command                              | Description                   |
+| ------------------ | ------------------------------------ | ----------------------------- |
+| :white_check_mark: | \<none\>                             | Deploy                        |
+| :white_check_mark: | `alias [ls]`                         | List aliases                  |
+| :white_check_mark: | `alias set <deployment> <alias>`     | Create alias                  |
+| :white_check_mark: | `alias rm <alias>`                   | Remove alias                  |
+| :white_check_mark: | `certs [ls]`                         | List SSL Certificates         |
+| :white_check_mark: | `certs issue <cn> [<cn>]`            | Issue certificate             |
+| :white_check_mark: | `certs rm <cn>`                      | Remove a certificate          |
+| :new:              | `create`                             | Create Kubernetes cluster     |
+| :white_check_mark: | `deploy`                             | Deploy                        |
+| :white_check_mark: | `domains [ls]`                       | List domains                  |
+| :white_check_mark: | `domains add <domain>`               | Add domain                    |
+| :no_entry:         | `domains buy <domain>`               | Buy domain                    |
+| :white_check_mark: | `domains rm <domain>`                | Remove domain                 |
+| :white_check_mark: | `login`                              | Login                         |
+| :white_check_mark: | `logout`                             | Logout                        |
+| :white_check_mark: | `ls`                                 | List deployments              |
+| :new:              | `install`                            | Install CLI tools (via brew)  |
+| :new:              | `ip`                                 | Get IP Address of deployments |
+| :white_check_mark: | `rm <name>`                          | Remove deployment             |
+| :white_check_mark: | `scale <deployment> <min> [<max>]`   | Scale deployment              |
+| :white_check_mark: | `secrets [ls]`                       | List secrets                  |
+| :white_check_mark: | `secrets add <key> <value>`          | Create secret                 |
+| :white_check_mark: | `secrets rename <old-key> <new-key>` | Rename secret                 |
+| :white_check_mark: | `secrets rm <key>`                   | Remove secret                 |
+
+### Tell me more
+
+The essential CLI commands to understand are `snow create` and `snow deploy`.
+
+### Dependencies
+
+The following CLI tools (installable via `snow install`) are necessary to orchestrate the entire end-to-end process, from Kubernetes cluster creation to managing your deployments:
+
+- `kubectl` (for managing deployments, secrets)
+- `helm` (for installing [tiller], [cert-manager], and [ingress-nginx] on your cluster)
+- CLI tool for your cloud provider (e.g., `gcloud`).
+
+If running Kubernetes locally on Minikube, you will additionally need these cli tools:
+
+- `docker` (for running local registry)
+- `minikube` (for running Kubernetes locally)
+- `virtualbox` (for creating docker images)
+
+[cert-manager]: https://github.com/jetstack/cert-manager
+[docker registry]: https://github.com/helm/charts/tree/master/stable/docker-registry
+[now]: https://github.com/zeit/now-cli
+[ingress-nginx]: https://github.com/kubernetes/ingress-nginx
+[kaniko]: https://github.com/GoogleContainerTools/kaniko
+[kubernetes]: https://kubernetes.io/

config/build-context/Dockerfile

@@ -0,0 +1,3 @@
+FROM nginx:alpine
+COPY index.html /usr/share/nginx/html/index.html
+EXPOSE 80

config/build-context/README.md

@@ -0,0 +1,3 @@
+# build-context
+
+This directory is a minimal example of everything you need to create a deployment.

config/build-context/index.html

@@ -0,0 +1,18 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta http-equiv="X-UA-Compatible" content="ie=edge">
+    <title>Hello World - Nginx Docker</title>
+    <style>
+      h1 {
+        font-weight:lighter;
+        font-family: Arial, Helvetica, sans-serif;
+      }
+    </style>
+  </head>
+  <body>
+    <h1>Hello World - Deployed with Snow</h1>
+  </body>
+</html>

config/build-context/now.json

@@ -0,0 +1,9 @@
+{
+  "name": "my-example",
+  "files": [
+    "index.html"
+  ],
+  "alias": [
+    "my-example.minikube"
+  ]
+}

config/deployment-gcp.yaml

@@ -0,0 +1,50 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: helloweb
+  labels:
+    app: hello
+spec:
+  selector:
+    matchLabels:
+      app: hello
+      tier: web
+  template:
+    metadata:
+      labels:
+        app: hello
+        tier: web
+    spec:
+      containers:
+      - name: hello-app
+        image: gcr.io/google-samples/hello-app:1.0
+        ports:
+        - containerPort: 8080
+---
+apiVersion: extensions/v1beta1
+kind: Ingress
+metadata:
+  name: helloweb
+  annotations:
+    kubernetes.io/ingress.global-static-ip-name: helloweb-ip
+  labels:
+    app: hello
+spec:
+  backend:
+    serviceName: helloweb-backend
+    servicePort: 8080
+---
+apiVersion: v1
+kind: Service
+metadata:
+  name: helloweb-backend
+  labels:
+    app: hello
+spec:
+  type: NodePort
+  selector:
+    app: hello
+    tier: web
+  ports:
+  - port: 8080
+    targetPort: 8080

config/deployment-minikube.yaml

@@ -0,0 +1,63 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: whoami-deployment
+spec:
+  replicas: 5
+  selector:
+    matchLabels:
+      app: whoami
+  template:
+    metadata:
+      labels:
+        app: whoami
+    spec:
+      containers:
+      - name: whoami-container
+        image: containous/whoami
+---
+apiVersion: v1
+kind: Service
+metadata:
+  name: whoami-clusterip-service
+spec:
+  type: ClusterIP
+  ports:
+  - name: http
+    targetPort: 80
+    port: 80
+  selector:
+    app: whoami
+---
+apiVersion: extensions/v1beta1
+kind: Ingress
+metadata:
+  name: whoami
+  # annotations:
+  #   kubernetes.io/ingress.class: traefik
+spec:
+  # THE Below will make a 'global default service'
+  # backend:
+  #  serviceName: whoami
+  #  servicePort: 80
+  rules:
+  # whoami.minikube must be in your hosts file (pointing to `minikube ip`)
+  - host: whoami.minikube
+    http:
+      paths:
+      - path: /
+        backend:
+          serviceName: whoami-clusterip-service
+          servicePort: 80
+  # whoami.com must be in your hosts file (pointing to `minikube ip`)
+  - host: whoami.com
+    http:
+      paths:
+      - path: /
+        backend:
+          serviceName: whoami-clusterip-service
+          servicePort: 80
+  # tls:
+  # - hosts:
+  #   - whoami.com
+  #   - whoami.minikube

config/kaniko.yaml

@@ -0,0 +1,71 @@
+apiVersion: v1
+kind: Pod
+metadata:
+  name: kaniko
+spec:
+  initContainers:
+    - name: kaniko-init
+      image: alpine
+      args:
+        - "sh"
+        - "-c"
+        - "while true; do sleep 1; if [ -f /tmp/complete ]; then break; fi done"
+      volumeMounts:
+        - name: empty-folder
+          mountPath: /kaniko/build-context
+        - name: empty-folder
+          mountPath: /kaniko/.docker
+  containers:
+    - name: kaniko
+      image: gcr.io/kaniko-project/executor:latest
+      args:
+        - "--context=dir:///kaniko/build-context"
+        - "--destination=172.17.0.15:5000/foobar:latest"
+        - "--insecure"
+      volumeMounts:
+        - name: empty-folder
+          mountPath: /kaniko/build-context
+        - name: empty-folder
+          mountPath: /kaniko/.docker
+  volumes:
+    - name: empty-folder
+      emptyDir: {}
+
+# apiVersion: v1
+# kind: Pod
+# metadata:
+#   name: kaniko
+# spec:
+#   initContainers:
+#     - name: kaniko-init
+#       image: alpine
+#       args:
+#         - "sh"
+#         - "-c"
+#         - "while true; do sleep 1; if [ -f /tmp/complete ]; then break; fi done"
+#       volumeMounts:
+#         - name: build-context
+#           mountPath: /kaniko/build-context
+#   containers:
+#     - name: kaniko
+#       image: gcr.io/kaniko-project/executor:latest
+#       args:
+#         - "--dockerfile=Dockerfile"
+#         - "--context=dir:///kaniko/build-context"
+#         - "--destination=172.17.0.15:5000/foobar:latest"
+#         - "--insecure"
+#         # - "--skip-tls-verify"
+#         # - "--tarPath=dir://kaniko/foo.tar"
+#         # - "--no-push"
+#         # - "--destination=mytag:latest"
+#       volumeMounts:
+#         - name: build-context
+#           mountPath: /kaniko/build-context
+#         - name: docker-config
+#           mountPath: /kaniko/.docker
+#   volumes:
+#     - name: docker-config
+#       configMap:
+#         name: docker-config
+#     - name: build-context
+#       emptyDir: {}