Skip to content

Commit

Permalink
Update DO instructions for remote cluster
Browse files Browse the repository at this point in the history
Signed-off-by: Alex Ellis <[email protected]>
  • Loading branch information
alexellis committed Apr 3, 2019
1 parent 83de7b2 commit 9cafb52
Show file tree
Hide file tree
Showing 3 changed files with 35 additions and 12 deletions.
14 changes: 10 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,13 +32,19 @@ If you're taking an instructor-led workshops then a link will be shared to join

## Pick your track

* Swarm track (this page)
In Lab 1 you will pick your track and then throughout the labs look out for any special commands needed for the container orchestrator for your track.

The easiest and simplest way to learn about OpenFaaS is through Docker Swarm. The knowledge you build up and the functions you create are both transferrable and portable between Swarm and Kubernetes.
### Docker Swarm (beginners)

* Kubernetes track (click link below)
The easiest and simplest way to learn about OpenFaaS is by deploying Docker Swarm, this is because it is already built into the Docker distribution and has more limited extensibility.

You can also learn about OpenFaaS through Kubernetes. We have a preview available for learning OpenFaaS with Kubernetes. [Switch to the Kubernetes track](https://github.com/openfaas/workshop/tree/kubernetes-preview).
The knowledge you build up and the functions you create are both transferrable and portable between Docker Swarm and Kubernetes.

### Kubernetes (intermediate)

You can also learn about Serverless on Kubernetes using OpenFaaS.

The recommendation from the OpenFaaS community is that you run Kubernetes in production, but all the knowledge you can is transferrable and functions do not have to be rebuilt.

## [Lab 1 - Prepare for OpenFaaS](./lab1.md)

Expand Down
7 changes: 4 additions & 3 deletions lab1.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,8 +44,9 @@ curl -sSL https://raw.githubusercontent.com/openfaas/faas/master/docker-compose.
This should offset the impact on the workshop WiFi of multiple attendees trying to pull the images at the same time.

### Setup a single-node cluster
If you're taking part in a workshop event then the organiser will probably ask you to use Docker Swarm because it's much easier to set up in a short period of time.

In order to set up OpenFaaS with Docker Swarm, go to [Lab 1a](./lab1a.md)
If you're taking part in an instructor-lead event then the organiser may ask you to use Docker Swarm, because it's much quicker and easier to set up in a short period of time. For some workshops you will use Kubernetes, but if you are working independently then choice is entirely your own.

If you're going to use Kubernetes, follow [Lab 1b](./lab1b.md)
* In order to set up OpenFaaS with Docker Swarm, go to [Lab 1a](./lab1a.md)

* If you're going to use Kubernetes, follow [Lab 1b](./lab1b.md)
26 changes: 21 additions & 5 deletions lab1b.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,14 @@ You can choose different options to run Kubernetes on your machine.

Before proceeding, [Install kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/)

#### _With Minikube_
#### Create a local cluster on your laptop

##### _Docker for Mac_

* [Install Docker for Mac](https://docs.docker.com/v17.12/docker-for-mac/install/)
> Note that Kubernetes is only available in Docker for Mac 17.12 CE and higher
##### _With Minikube_

* To install Minikube download the proper installer from [latest release](https://github.com/kubernetes/minikube/releases) depending on your platform.
* [Install Helm client](https://docs.helm.sh/using_helm/#installing-the-helm-client)
Expand All @@ -36,12 +43,21 @@ $ helm init
The minikube VM is exposed to the host system via a host-only IP address. Check this IP with `minikube ip`.
This is the IP you will later use for the gateway URL.

#### _Docker for Mac_
#### Create a remote cluster on the cloud

* [Install Docker for Mac](https://docs.docker.com/v17.12/docker-for-mac/install/)
> Note that Kubernetes is only available in Docker for Mac 17.12 CE and higher
You can create a remote cluster in the cloud and enjoy the same experience as if you were developing locally whilst saving on RAM/CPU and battery. The costs for running a cluster for 1-2 days is minimal.

##### _Run on DigitalOcean's Kubernetes Service_

You can use free credits to create a cluster through DigitalOcean's UI.

The DigitalOcean dashboard will then guide you through how to configure your `kubectl` and `KUBECONFIG` file for use in the labs.

* [Claim your free credits - $100 in credit over 60 days](https://m.do.co/c/8d4e75e9886f)

> Note: Even if you have already claimed free credit, the running costs for a 2-3 node cluster for 24-48 hours is negligible.
#### _Run on GKE (Google Kubernetes Engine)_
##### _Run on GKE (Google Kubernetes Engine)_

* Install [Google Cloud SDK](https://cloud.google.com/sdk/docs)

Expand Down

0 comments on commit 9cafb52

Please sign in to comment.