Skip to content

Troubleshooting

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.

Wrong branch

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.

SSL error

Your SSL certificates may be inappropriately configured. Check cert-manager.

Timeout

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

Container logs

Check the following logs

system-github-event

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

buildkit

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.

buildshiprun

Are there any issues deploying? Look for non 2xx status codes.

kubectl logs -n openfaas-fn deploy/buildshiprun

github-status

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

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