Add instructions for ARM/RPi into main guides

- Fixes: #106

Signed-off-by: Alex Ellis (VMware) <[email protected]>

Author: alexellis

docs/deployment/docker-swarm.md

@@ -2,7 +2,25 @@
 
 > Note: If you need to use `sudo` to access the `docker` CLI then you should prefix this behind any shell scripts or CLIs used in this guide or any related tutorials.
 
-## 1.0 Initialize Swarm Mode
+## 1.0 Install the `faas-cli`
+
+You can install the OpenFaaS CLI using `brew` or a `curl` script.
+
+* via `brew`:
+
+```bash
+brew install faas-cli
+```
+
+* via `curl`:
+
+```bash
+$ curl -sL https://cli.openfaas.com | sudo sh
+```
+
+If you run the script as a normal non-root user then the script will be downloaded to the current folder.
+
+## 1.1 Initialize Swarm Mode
 
 You can create a single-host Docker Swarm on your laptop with a single command. You don't need any additional software to Docker 17.06 or greater. You can also run these commands on a Linux VM or cloud host.
 
@@ -16,7 +34,7 @@ If you have more than one IP address you may need to pass a string like `--adver
 
 Take a note of the join token
 
-## 1.1 Join any workers you need
+## 1.2 Join any workers you need
 
 Log into your worker node and type in the output from `docker swarm init` on the master. If you've lost this info then type in `docker swarm join-token worker` and then enter that on the worker.
 
@@ -38,6 +56,22 @@ $ git clone https://github.com/openfaas/faas && \
 !!! info
     As of OpenFaaS 0.8.6 basic authentication will be enabled by default when running ./deploy\_stack.sh. If you need to disable it pass the flag `--no-auth` to the ./deploy_stack.sh script as above.
 
+### 2.0.1 Raspberry Pi / 32-bit ARM
+
+> For a complete tutorial on setting up OpenFaaS for Raspberry Pi / 32-bit ARM using Docker Swarm see the following blog post from Alex Ellis: [Your Serverless Raspberry Pi cluster with Docker](https://blog.alexellis.io/your-serverless-raspberry-pi-cluster/).
+
+If you are using Raspberry Pi or 32-bit ARM devices then please run the following instead:
+
+```bash
+$ git clone https://github.com/openfaas/faas && \
+  cd faas && \
+  ./deploy_stack.armhf.sh
+```
+
+When creating new functions please use the templates with a suffix of `-armhf` such as `go-armhf` and `python-armhf` to ensure you get the correct versions for your devices.
+
+> Note: you cannot deploy the sample functions to ARM devices, but you can use the function store in the gateway UI or via `faas-cli store list --yaml https://raw.githubusercontent.com/openfaas/store/master/store-armhf.json`
+
 ### 2.1 Store your admin credentials
 
 The default configuration will create a username and password combination for you:

docs/deployment/kubernetes.md

@@ -25,6 +25,24 @@ A guide is available for configuring minikube here:
       --user="$(gcloud config get-value core/account)"
     ```
 
+### Install the `faas-cli`
+
+You can install the OpenFaaS CLI using `brew` or a `curl` script.
+
+* via `brew`:
+
+```bash
+brew install faas-cli
+```
+
+* via `curl`:
+
+```bash
+$ curl -sL https://cli.openfaas.com | sudo sh
+```
+
+If you run the script as a normal non-root user then the script will be downloaded to the current folder.
+
 ### Pick helm or YAML files for deployment (A or B)
 
 It is recommended to use `helm` to install OpenFaaS so that you can configure your installation to suit your needs. This configuration is considered to be production-ready.
@@ -37,7 +55,6 @@ A Helm chart is provided in the `faas-netes` repository. Follow the link below t
 
 * [OpenFaaS Helm chart](https://github.com/openfaas/faas-netes/blob/master/HELM.md)
 
-
 ##### Tiller-less Helm install
 If you have issues using `helm` in a locked-down environment then you can still use the `helm template` command to generate a custom set of YAML to apply using `kubectl`. See the [Chart readme](https://github.com/openfaas/faas-netes/blob/master/chart/openfaas/README.md#deployment-with-helm-template) for detailed instructions.
 
@@ -74,6 +91,27 @@ This step assumes you are running `kubectl` on a master host.
     !!! note
         For deploying on a cloud that supports Kubernetes *LoadBalancers* you may also want to apply the configuration in: `cloud/lb.yml`.
 
+#### B. Deploy using kubectl/YAML (Raspberry Pi / 32-bit ARM)
+
+> For a complete tutorial on setting up OpenFaaS for Raspberry Pi / 32-bit ARM using Kubernetes see the following blog post from Alex Ellis: [Serverless Kubernetes home-lab with your Raspberry Pis](https://blog.alexellis.io/serverless-kubernetes-on-raspberry-pi/).
+
+For Raspberry Pi or 32-bit ARM devices please do the following:
+
+```bash
+$ kubectl apply -f https://raw.githubusercontent.com/openfaas/faas-netes/master/namespaces.yml
+```
+
+Now deploy OpenFaaS:
+
+```bash
+$ cd faas-netes && \
+kubectl apply -f ./yaml_armhf
+```
+
+When creating new functions please use the templates with a suffix of `-armhf` such as `go-armhf` and `python-armhf` to ensure you get the correct versions for your devices.
+
+> Note: you cannot deploy the sample functions to ARM devices, but you can use the function store in the gateway UI or via `faas-cli store list --yaml https://raw.githubusercontent.com/openfaas/store/master/store-armhf.json`
+
 #### Use OpenFaaS
 
 After deploying OpenFaaS you can start using one of the guides or blog posts to create Serverless functions or test [community functions](https://github.com/openfaas/faas/blob/master/community.md).
@@ -100,14 +138,6 @@ There are currently no sample functions built into this stack, but we can deploy
 
 #### Use the CLI
 
-* Install the CLI
-
-    ```bash
-    $ curl -sL https://cli.openfaas.com | sudo sh
-    ```
-
-    If you like you can also run the script via a non-root user. Then the faas-cli binary is downloaded to the current working directory instead.
-
 * Then clone some samples to deploy on your cluster.
 
     ```bash

docs/tutorials/featured.md

@@ -1,9 +1,12 @@
 # Featured tutorials
 
-* OpenFaaS deployment guides for Kubernetes in the Cloud:
+* OpenFaaS deployment guides for Kubernetes
   - [Amazon EKS](https://www.weave.works/blog/getting-started-with-openfaas-kubernetes-operator-on-eks)
   - [Azure AKS](https://medium.com/@ericstoekl/deploying-openfaas-on-kubernetes-azure-aks-4eea99d0743f)
   - [Google GKE](https://www.openfaas.com/blog/gke-multi-stage/)
+  - [DigitalOcean Kubernetes Service](https://blog.alexellis.io/digitalocean-kubernetes-engine/)
+  - [Kubernetes in Docker (kind)](https://blog.alexellis.io/be-kind-to-yourself/)
+  - [minikube](https://medium.com/devopslinks/getting-started-with-openfaas-on-minikube-634502c7acdf)
 
 * [Serverless: Databases with OpenFaaS and Mongo](https://blog.alexellis.io/serverless-databases-with-openfaas-and-mongo/)