faas-rs/faas
1
0
Fork 0
mirror of https://github.com/openfaas/faas.git synced 2025-06-25 16:23:26 +00:00
Code Issues Packages Projects Releases Wiki Activity

Pad out explanations

Browse Source
This commit is contained in:
Alex Ellis
2017-09-25 17:42:13 +01:00
committed by GitHub
parent c52c6decc6
commit 770437109e
1 changed files with 24 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
guide/deployment_swarm.md
View File

@ -4,7 +4,7 @@
## Initialize Swarm Mode
Use either a single host or multi-node setup.
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.05 or greater. You can also run these commands on a Linux VM or cloud host.
This is how you initialize your master node:
@ -14,19 +14,39 @@ This is how you initialize your master node:
If you have more than one IP address you may need to pass a string like `--advertise-addr eth0` to this command.
Then copy any join token commands you see and run them on your worker nodes.
Take a note of the join token
* 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.
It's also important to pass the `--advertise-addr` string to any hosts which have a public IP address.
> Note: check whether you need to enable firewall rules for the [Docker Swarm ports listed here](https://docs.docker.com/engine/swarm/swarm-tutorial/).
## Deploy the stack
Clone OpenFaaS and then checkout the latest stable release:
```
$ git clone https://github.com/alexellis/faas && \
$ git clone https://github.com/openfaas/faas && \
cd faas && \
git checkout 0.6.5 && \
./deploy_stack.sh
```
## Test the UI
`./deploy_stack.sh` can be run at any time and includes a set of sample functions. You can read more about these in the [TestDrive document](https://github.com/openfaas/faas/blob/master/TestDrive.md)
## Test out the UI
Within a few seconds (or minutes if on a poor WiFi connection) the API gateway and sample functions will be pulled into your local Docker library and you will be able to access the UI at:
http://localhost:8080
If you're running on Linux you may find that `localhost` times out. In this case force an IPv4 address such as http://127.0.0.1:8080.
## Learn the CLI
You can now grab a coffee and start learning how to create your first function with the CLI:
[Morning coffee with the OpenFaaS CLI](https://blog.alexellis.io/quickstart-openfaas-cli/)