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.
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.