Troubleshooting OpenFaaS Cloud¶
Got something wrong?¶
At any time you can reset the cluster and start over. This is better than editing files individually and prevents inadvertently missing something.
Not found error for dashboard¶
You cannot access the dashboard or gateway via IP address. You need to use the DNS A records for your cluster which correspond to the root domain used for your installation.
Find the IP address of the LoadBalancer or IP address of one of your nodes if using Host networking and create these records:
system.example.com-> Create DNS A record
auth.system.example.com-> Create DNS A record
user.example.com/function-> Create as DNS A record
If you do not have access to DNS you can edit your
/etc/hosts file and add entries there for local testing.
Something else not working?¶
Make sure that you clearly followed all the instructions in the README for ofc-bootstrap, read them through and check them off one-by-one.
Make sure that you edited
init.yaml, read all the comments and updated the values that you needed to. If in doubt, ask questions on Slack.
No functions appear¶
If no functions appear on your dashboard then try the following.
No GitHub status checks¶
Start by ensuring you have installed your GitHub App on your chosen GitHub repo and that you picked the correct permissions for your GitHub App.
stack.yml not found¶
You must name your function's YAML file
stack.yml, you can place multiple function definitions within the same file.
You must use the
master branch. You cannot deploy from any other branch at this time.
SealedSecret name mis-match¶
See the secrets reference on how to configure your SealedSecrets correctly.
Webhook secret / HMAC incorrect¶
The webhook secret used by GitHub and your cluster must match.
GitHub App Advanced page¶
For anything else head over to your GitHub App and check the "Advanced" page.
Look for a
push event and examine the request/response. If you need to you can redeliver a failed message.
Your SSL certificates may be inappropriately configured. Check cert-manager.
You may need to adjust the maximum timeout for building, pushing and deploying a function.
GitHub App private key or AppID mismatch¶
Cross-check your GitHub App's private key and AppID with the one loaded into the cluster or in
Check the following logs
Did the event from GitHub get handled correctly? Is there a mismatch on the webhook secret / HMAC SHA?
kubectl logs -n openfaas-fn deploy/system-github-event
Is BuildKit functioning correctly and pushing to the remote registry?
kubectl logs -n openfaas deploy/of-builder -c of-builder kubectl logs -n openfaas deploy/of-builder -c of-buildkit
If your credentials or registry are set incorrectly, you may see that of-builder passes successfully, but of-buildkit may show an authorization error.
Are there any issues deploying? Look for non 2xx status codes.
kubectl logs -n openfaas-fn deploy/buildshiprun
Were there issues updating the GitHub statuses?
kubectl logs -n openfaas-fn deploy/github-status
If so, then perhaps your GitHub App doesn't have the correct permissions.
OAuth / Auth¶
Check the auth service:
kubectl describe -n openfaas deploy/auth kubectl logs -n openfaas deploy/auth
client_id is set correctly along with the direct URL and cookie domain.
Still not working?¶
Head over to OpenFaaS Slack and join #openfaas-cloud.