Soam VasaniandGitHub
7ddbea59a2
This makes set up easier for new users. Users can still set FISSION_NAMESPACE but it will default to "fission". Users can also still set KUBECONFIG, but it will default to $HOME/.kube/config. Also, update the post-install chart notes.txt and the install guide to use "fission function test" as the first step after install. This means that if there's anything wrong with the setup, the user will see useful errors instead of "internal server error". Also, they can test their setup without worrying about nodeports or ingresses or whatever. All existing functionality of FISSION_URL and FISSION_ROUTER continues to work.
145 lines
3.8 KiB
Markdown
145 lines
3.8 KiB
Markdown
---
|
|
title: "Installation Guide"
|
|
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.5.0/fission-all-0.5.0.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.5.0/fission-all-0.5.0.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.5.0/fission-core-0.5.0.tgz
|
|
```
|
|
|
|
### Install the Fission CLI
|
|
|
|
#### OS X
|
|
|
|
Get the CLI binary for Mac:
|
|
|
|
```
|
|
$ curl -Lo fission https://github.com/fission/fission/releases/download/0.5.0/fission-cli-osx && chmod +x fission && sudo mv fission /usr/local/bin/
|
|
```
|
|
|
|
#### Linux
|
|
|
|
```
|
|
$ curl -Lo fission https://github.com/fission/fission/releases/download/0.5.0/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.5.0/fission-cli-windows.exe)
|
|
|
|
### Run an example
|
|
|
|
Finally, you're ready to use Fission!
|
|
|
|
```
|
|
$ fission env create --name nodejs --image fission/node-env:0.5.0
|
|
|
|
$ curl -LO https://raw.githubusercontent.com/fission/fission/master/examples/nodejs/hello.js
|
|
|
|
$ fission function create --name hello --env nodejs --code hello.js
|
|
|
|
$ fission function test --name 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.
|