Deployment guide for Docker Swarm¶
Note: If you need to use
sudoto access the
dockerCLI then you should prefix this behind any shell scripts or CLIs used in this guide or any related tutorials.
1.0 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.
This is how you initialize your master node:
$ docker swarm init
If you have more than one IP address you may need to pass a string like
--advertise-addr eth0 to this command.
Take a note of the join token
1.1 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.
Check whether you need to enable firewall rules for the Docker Swarm ports listed here.
2.0 Deploy the stack¶
Clone OpenFaaS and then checkout the latest stable release:
$ git clone https://github.com/openfaas/faas && \ cd faas && \ ./deploy_stack.sh
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.1 Store your admin credentials¶
The default configuration will create a username and password combination for you:
Attempting to create credentials for gateway.. ... [Credentials] username: admin password: <some_hash_secret> echo -n <some_hash_secret> | faas-cli login --username=admin -- password-stdin
Run the command as you see it in your console, do not copy/paste the login command. Once you run
faas-cli login your password will be stored as a hash at
You will need the password for the CLI, UI and REST API on the gateway, but you can invoke your functions without it.
2.1 Test out the UI¶
Within a few seconds (or minutes if on a poor WiFi connection) the API gateway and associated OpenFaaS images will be pulled into your local Docker library and you will be able to access the UI at:
If you're running on Linux you may find that accessing
localhost times out. We recommend using an IPv4 address such as http://127.0.0.1:8080 to prevent any ambiguity.
2.2 Deploy the sample functions¶
git clone included a set of sample functions in
stack.yml, to deploy them install the OpenFaaS CLI and run:
$ faas deploy -f \ https://raw.githubusercontent.com/openfaas/faas/master/stack.yml
3.0 Start the hands-on labs¶
Learn how to build serverless functions with OpenFaaS and Python in our half-day workshop. You can follow along online at your own pace.
If you are running into any issues please check out the troubleshooting guide and search the documentation / past issues before raising na issue.