Skip to content
This repository was archived by the owner on Nov 30, 2021. It is now read-only.

docs(managing-workflow) Document k8s annotation for AWS ELB idle timeout#745

Merged
bacongobbler merged 1 commit intodeis:masterfrom
felixbuenemann:patch-1
Feb 28, 2017
Merged

docs(managing-workflow) Document k8s annotation for AWS ELB idle timeout#745
bacongobbler merged 1 commit intodeis:masterfrom
felixbuenemann:patch-1

Conversation

@felixbuenemann
Copy link
Copy Markdown
Contributor

This updates the docs to describe how to persist the AWS ELB idle timeout by using the proper k8s service annotation instead of following the manual instructions, which get reset if k8s re-configures the ELB.

The annotation was added in kubernetes/kubernetes#30695 and merged targeting k8s v1.4 in August 2016. I have verified that it works as expected on k8s v1.4.6.

This updates the docs to describe how to persist the AWS ELB idle timeout by using the proper k8s service annotation instead of following the manual instructions, which get reset if k8s re-configures the ELB.

The annotation was added in kubernetes/kubernetes#30695 and merged targeting k8s v1.4 in August 2016. I have verified that it works as expected on k8s v1.4.6.
If a load balancer such as the one described above does exist (whether created automatically or manually) and if you intend on handling any long-running requests, the load balancer (or similar) may require some manual configuration to increase the idle connection timeout. Typically, this is most applicable to AWS and Elastic Load Balancers, but may apply in other cases as well. It does not apply to Google Container Engine, as the idle connection timeout cannot be configured there, but also works as-is.

If, for instance, Deis Workflow were installed on kube-aws, this timeout should be increased to a recommended value of 1200 seconds. This will ensure the load balancer does not hang up on the client during long-running operations like an application deployment. Directions for this can be found [here](http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/config-idle-timeout.html).
If, for instance, Deis Workflow were installed on kube-aws, this timeout should be increased to a recommended value of 1200 seconds. This will ensure the load balancer does not hang up on the client during long-running operations like an application deployment.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is 1200 seconds the longest AWS allows? I think we should suggest the maximum value here, and explicitly call out that we are doing so. Just my thoughts from going through this in kops.

Copy link
Copy Markdown
Contributor Author

@felixbuenemann felixbuenemann Feb 27, 2017

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No, it is not the longest, but the deis-controller times out requests after 20 minutes, which is why the docs recommend to set the same timeout. According to the AWS docs the value must be between 1 and 3600 seconds.

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants