Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rgee0/openfaas-on-digitalocean
Ansible playbook to create a Digital Ocean droplet and deploy OpenFaaS onto it.
https://github.com/rgee0/openfaas-on-digitalocean
ansible digital-ocean droplet k8s kubernetes kubernetes-setup openfaas playbook serverless
Last synced: 8 days ago
JSON representation
Ansible playbook to create a Digital Ocean droplet and deploy OpenFaaS onto it.
- Host: GitHub
- URL: https://github.com/rgee0/openfaas-on-digitalocean
- Owner: rgee0
- License: mit
- Created: 2018-04-28T11:51:19.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2018-12-28T17:27:11.000Z (almost 6 years ago)
- Last Synced: 2024-10-24T07:41:53.746Z (17 days ago)
- Topics: ansible, digital-ocean, droplet, k8s, kubernetes, kubernetes-setup, openfaas, playbook, serverless
- Size: 31.3 KB
- Stars: 59
- Watchers: 3
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-list-ansible - openfaas-on-digitalocean
README
## OpenFaaS-on-DigitalOcean
Ansible Playbook to get you up and running with OpenFaas on [DigitalOcean](https://m.do.co/c/2962aa9e56a1). This is intended for evaluation / testing where quick and repeatable access to a clean instance is desired.
Please be aware this playbook is not idempotent, specifically in droplet creation; if you run it _n_ times you will get _n_ droplets.
Both swarm and kubernetes deployments are possible by passing `-e "orchestrator=swarm"` or `-e "orchestrator=k8s"`.
### Pre-requisites
These vary depending on the mechanism by which Ansible is being invoked. If Ansible is being installed onto a control machine then all three apply. Alternatively a Docker image has been made available at `rgee0/ansible-playbook:2.6.0` which includes the first two pre-reqs.
* [Install Ansible](http://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html) (Skip if using Docker image)
* [PIP](https://pip.pypa.io/en/stable/installing/) and [DOPY](https://pypi.org/project/dopy) (Skip if using Docker image)
* [DigitalOcean](https://m.do.co/c/2962aa9e56a1) account
### Configure Variables
Configure the [create_droplet role variables](create_droplet/vars/main.yml) according to your needs.
```yml
token:
sshid:
size_slug:
region:
image: ubuntu-17-10-x64
```
* token
Click API in the DigitalOcean Dashboard, then under Tokens/Keys click “Generate New Token”. Select Read & Write scopes.
* sshid
The ssh key IDs can be found by running:
```sh
$ export DOTOKEN=
$ curl -X GET -H 'Content-Type: application/json' -H 'Authorization: Bearer '$DOTOKEN "https://api.digitalocean.com/v2/account/keys" 2>/dev/null | python -m json.tool
```
Look at the “ssh_keys” section and pick one of the SSH keys you want to use to log into the new droplet we will create. Use the “name” field to identify the key and then copy the “id” field
* size_slug
Its recommended that `s-2vcpu-4gb` is used as a minimum. Further options can be found on [DigitalOcean](https://developers.digitalocean.com/documentation/changelog/api-v2/new-size-slugs-for-droplet-plan-changes/)
or through the API:
```sh
$ curl -X GET -H 'Content-Type: application/json' -H 'Authorization: Bearer '$DOTOKEN "https://api.digitalocean.com/v2/sizes" 2>/dev/null | python -m json.tool
```
* region
```
$ curl -X GET -H 'Content-Type: application/json' -H 'Authorization: Bearer '$DOTOKEN "https://api.digitalocean.com/v2/regions" 2>/dev/null | python -m json.tool
```
### Run the playbook
* Using Swarm (Ansible via Docker)
Ensure the path to, and key names, are adjusted according to your set-up.
```sh
$ docker run --rm -it -v $(pwd):/ansible/playbooks \
-v ~/.ssh/id_rsa:/root/.ssh/id_rsa \
-v ~/.ssh/id_rsa.pub:/root/.ssh/id_rsa.pub \
rgee0/ansible-playbook:2.6.0 site.yml -e "orchestrator=swarm"
```
* Using Kubernetes (Ansible via Docker)
Ensure the path to, and key names, are adjusted according to your set-up.
```sh
$ docker run --rm -it -v $(pwd):/ansible/playbooks \
-v ~/.ssh/id_rsa:/root/.ssh/id_rsa \
-v ~/.ssh/id_rsa.pub:/root/.ssh/id_rsa.pub \
rgee0/ansible-playbook:2.6.0 site.yml -e "orchestrator=k8s"
```
* Using Swarm (local Ansible installation)
```sh
$ ansible-playbook site.yml -e "orchestrator=swarm"
```
* Using Kubernetes (local Ansible installation)
```sh
$ ansible-playbook site.yml -e "orchestrator=k8s"
```
### Head over to the UI
Check the output of the final task to find the location of the OpenFaaS UI. For example:
```
ok: [209.97.188.227] => {
"msg": [
"OpenFaaS Gateway: http://209.97.188.227:8080",
"Gateway User: admin ",
"Gateway Password: c2db2b6d59df518392a81eff57c52486f9f2f46e2480d9de150904bbce0560bc",
"CLI Gateway Login: echo -n c2db2b6d59df518392a81eff57c52486f9f2f46e2480d9de150904bbce0560bc | faas-cli login --username=admin --password-stdin -g http://209.97.188.227:8080"
]
}
PLAY RECAP **************************************************************************************************************************
209.97.188.227 : ok=12 changed=6 unreachable=0 failed=0
localhost : ok=6 changed=2 unreachable=0 failed=0
```
As this deploys to public cloud basic auth is enabled by default for both orchestrators.