Binary Environment (#256)

Adds a fission environment for arbitrary linux binaries.

examples/binary/README.md

@@ -0,0 +1,80 @@
+# Binary Environment Examples
+
+The `binary` runtime is a go server that uses a subprocess to invoke executables or execute shell scripts.
+
+For more info read the [environment README](../../environments/binary/README.md).
+
+## Requirements
+
+First, set up your fission deployment with the binary environment.
+
+```bash
+fission env create --name binary-env --image fission/binary-env
+```
+
+## Example Usage
+
+### hello.sh
+`hello.sh` is an very basic shell script that returns `"Hello, World!"`.
+
+```bash
+# Upload the function to fission
+fission function create --name hello --env binary-env --code hello.sh
+
+# Map /hello to the hello function
+fission route create --method GET --url /hello --function hello
+
+# Run the function
+curl http://$FISSION_ROUTER/hello
+```
+
+This should return a HTTP response with the body `Hello World!`
+
+### echo.sh
+`echo.sh` shows the the use of STDIN to read the request body, echoing the input back in the response.
+
+```bash
+# Upload the function to fission
+fission function create --name echo --env binary-env --code echo.sh
+
+# Map /hello to the hello function
+fission route create --method POST --url /echo --function echo
+
+# Run the function
+curl -XPOST -d 'Echoooooo!'  http://$FISSION_ROUTER/echo
+```
+This should return a HTTP response with the body `... Echoooooo!`.
+
+
+### headers.sh
+`headers.sh` shows the access to the environment variables that hold the HTTP headers, returning the set HTTP headers.
+
+```bash
+# Upload the function to fission
+fission function create --name headers --env binary-env --code headers.sh
+
+# Map /hello to the hello function
+fission route create --url /headers --function headers
+
+# Run the function
+curl -H 'X-FOO: BAR'  http://$FISSION_ROUTER/headers
+```
+This should return a HTTP response with the body `... Echoooooo!`.
+
+### hello..go
+This example shows the differences between using shell scripts and binaries. `hello.go` returns `Hello World!` + the 
+environment variables it received from the server.
+
+```bash
+# Build the function targeted at the right architecture
+GOOS=linux GOARCH=386 go build -o hello-go-func hello.go
+
+# Upload the function to fission
+fission function create --name hello-go --env binary-env --code hello-go-func
+
+# Map /hello to the hello function
+fission route create --url /hello-go --function hello-go
+
+# Run the function
+curl -H 'X-GO: AWESOME!'  http://$FISSION_ROUTER/hello-go
+```

examples/binary/echo.sh

@@ -0,0 +1,4 @@
+#!/bin/sh
+
+printf "... "
+cat -

examples/binary/headers.sh

@@ -0,0 +1,3 @@
+#!/bin/sh
+
+env | grep "^HTTP_"

examples/binary/hello.go

@@ -0,0 +1,12 @@
+package main
+
+import (
+	"fmt"
+	"os"
+)
+
+// See README.md in the examples/binary directory for instructions
+func main() {
+	fmt.Println("Hello World!")
+	fmt.Printf("Environment: %v", os.Environ())
+}

examples/binary/hello.sh

@@ -0,0 +1,3 @@
+#!/bin/sh
+
+echo "Hello World!"