From 10d5dd62df64293d509205b6b6e014f614d127a6 Mon Sep 17 00:00:00 2001 From: Richard Gee Date: Thu, 10 Jan 2019 18:22:18 +0000 Subject: [PATCH] Add notes about GKE load-balancer default timeouts At the time of writing the default load-balancer timeout within GKE is 30 seconds. This change adds notes within the Kubernetes deployment guide and the troubleshooting section to highlight that there may be timeout configuration outside of OpenFaaS while also drawing attention specifically to GKE. Signed-off-by: Richard Gee --- docs/deployment/kubernetes.md | 2 ++ docs/deployment/troubleshooting.md | 4 ++++ 2 files changed, 6 insertions(+) diff --git a/docs/deployment/kubernetes.md b/docs/deployment/kubernetes.md index 9996ffb2..9d5fa13e 100644 --- a/docs/deployment/kubernetes.md +++ b/docs/deployment/kubernetes.md @@ -25,6 +25,8 @@ A guide is available for configuring minikube here: --user="$(gcloud config get-value core/account)" ``` + Also, ensure any [default load-balancer timeouts within GKE](https://cloud.google.com/load-balancing/docs/https/#timeouts_and_retries) are understood and configured appropriately. + ### Install the `faas-cli` You can install the OpenFaaS CLI using `brew` or a `curl` script. diff --git a/docs/deployment/troubleshooting.md b/docs/deployment/troubleshooting.md index f84d1cd5..9080c8c3 100644 --- a/docs/deployment/troubleshooting.md +++ b/docs/deployment/troubleshooting.md @@ -154,6 +154,10 @@ For asynchronous invocations of functions a separate timeout can be configured a If the `ack_wait` is exceeded the task will not be acknowledge and the queue system will retry the invocation. +### Timeouts - Cloud Service Providers + +There are situations where timeout values external to OpenFaaS may impact successful function execution. A typical scenario is where a cloud platform's load balancer product is fronting the cluster in which OpenFaaS is running. A common example is when using the [GCP Kubernetes product, GKE](https://cloud.google.com/load-balancing/docs/https/#timeouts_and_retries). + ## Function execution logs By default the functions will not log out the result, but just show how long the process took to run and the length of the result in bytes.