Update docs-site

2018-01-23 13:27:10 +08:00
parent 8df520721c
commit 01bcfad44a
428 changed files with 6789 additions and 29646 deletions
@@ -0,0 +1,181 @@
+---
+title: "Installation Guide"
+date: 2017-09-07T20:10:05-07:00
+draft: false
+weight: 20
+---
+
+Welcome! This guide will get you up and running with Fission on a
+Kubernetes cluster.
+
+### Cluster preliminaries
+
+If you don't have a Kubernetes cluster, [here's a quick guide to set
+one up](../kubernetessetup).
+
+Let's ensure you have the Kubernetes CLI and Helm installed and
+ready. If you already have helm, [skip ahead to the fission install](#install-fission).
+
+#### Kubernetes CLI
+
+Ensure you have the Kubernetes CLI.
+
+You can get the Kubernetes CLI for OSX like this:
+```
+$ curl -LO https://storage.googleapis.com/kubernetes-release/release/$(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt)/bin/darwin/amd64/kubectl && chmod +x kubectl && sudo mv kubectl /usr/local/bin
+```
+
+Or, for Linux:
+```
+$ curl -LO https://storage.googleapis.com/kubernetes-release/release/$(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt)/bin/linux/amd64/kubectl && chmod +x kubectl && sudo mv kubectl /usr/local/bin
+```
+
+Ensure you have access to a cluster; use kubectl to check your
+Kubernetes version:
+
+```
+$ kubectl version
+```
+
+We need at least Kubernetes 1.6 (older versions may work, but we don't
+test them).
+
+#### Helm
+
+Helm is an installer for Kubernetes.  If you already use helm, [skip to
+the next section](#install-fission).
+
+First, you'll need the helm CLI:
+
+On __OS X__:
+```
+$ curl -LO https://storage.googleapis.com/kubernetes-helm/helm-v2.7.0-darwin-amd64.tar.gz
+
+$ tar xzf helm-v2.7.0-darwin-amd64.tar.gz
+
+$ mv darwin-amd64/helm /usr/local/bin
+```
+
+On __Linux__:
+```
+$ curl -LO https://storage.googleapis.com/kubernetes-helm/helm-v2.7.0-linux-amd64.tar.gz
+
+$ tar xzf helm-v2.7.0-linux-amd64.tar.gz
+
+$ mv linux-amd64/helm /usr/local/bin
+```
+
+Next, install the Helm server on your Kubernetes cluster:
+
+```
+$ helm init
+```
+
+### Install Fission
+
+#### Minikube
+
+```
+$ helm install --namespace fission --set serviceType=NodePort https://github.com/fission/fission/releases/download/0.4.1/fission-all-0.4.1.tgz
+```
+
+The serviceType variable allows configuring the type of Kubernetes
+service outside the cluster.  You can use `ClusterIP` if you don't
+want to expose anything outside the cluster.
+
+#### Cloud hosted clusters (GKE, AWS, Azure etc.)
+
+```
+$ helm install --namespace fission https://github.com/fission/fission/releases/download/0.4.1/fission-all-0.4.1.tgz
+```
+
+#### Minimal version
+
+The fission-all helm chart installs a full set of services including
+the NATS message queue, influxDB for logs, etc. If you want a more
+minimal setup, you can install the fission-core chart instead:
+
+```
+$ helm install --namespace fission https://github.com/fission/fission/releases/download/0.4.1/fission-core-0.4.1.tgz
+```
+
+### Install the Fission CLI
+
+#### OS X
+
+Get the CLI binary for Mac:
+
+```
+$ curl -Lo fission https://github.com/fission/fission/releases/download/0.4.1/fission-cli-osx && chmod +x fission && sudo mv fission /usr/local/bin/
+```
+
+#### Linux
+
+```
+$ curl -Lo fission https://github.com/fission/fission/releases/download/0.4.1/fission-cli-linux && chmod +x fission && sudo mv fission /usr/local/bin/
+```
+
+#### Windows
+
+For Windows, you can use the linux binary on WSL. Or you can download
+this windows executable: [fission.exe](https://github.com/fission/fission/releases/download/0.4.1/fission-cli-windows.exe)
+
+### Set environment vars
+
+Set the FISSION_URL and FISSION_ROUTER environment variables.
+FISSION_URL is used by the fission CLI to find the server.
+(FISSION_ROUTER is only needed for the examples below to work.)
+
+#### Minikube
+
+If you're using minikube, use these commands:
+
+```
+  $ export FISSION_URL=http://$(minikube ip):31313
+  $ export FISSION_ROUTER=$(minikube ip):31314
+```
+#### Cloud setups
+
+Save the external IP addresses of controller and router services in
+FISSION_URL and FISSION_ROUTER, respectively.  Wait for services to
+get IP addresses (check this with ```kubectl --namespace fission get
+svc```).  Then:
+
+##### AWS
+```
+  $ export FISSION_URL=http://$(kubectl --namespace fission get svc controller -o=jsonpath='{..hostname}')
+  $ export FISSION_ROUTER=$(kubectl --namespace fission get svc router -o=jsonpath='{..hostname}')
+```
+
+##### GCP
+```
+  $ export FISSION_URL=http://$(kubectl --namespace fission get svc controller -o=jsonpath='{..ip}')
+  $ export FISSION_ROUTER=$(kubectl --namespace fission get svc router -o=jsonpath='{..ip}')
+```
+
+### Run an example
+
+Finally, you're ready to use Fission!
+
+```
+$ fission env create --name nodejs --image fission/node-env:0.4.1
+
+$ curl -LO https://raw.githubusercontent.com/fission/fission/master/examples/nodejs/hello.js
+
+$ fission function create --name hello --env nodejs --code hello.js
+
+$ fission route create --method GET --url /hello --function hello
+
+$ curl http://$FISSION_ROUTER/hello
+Hello, world!
+```
+
+### What's next?
+
+If something went wrong, we'd love to help -- please [drop by the
+slack channel](http://slack.fission.io) and ask for help.
+
+Check out the
+[examples](https://github.com/fission/fission/tree/master/examples)
+for some example functions.
+