Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add a k8s guide section on traffic splitting via service weights. #3556

Conversation

timoreimann
Copy link
Contributor

What does this PR do?

Explain service weights in the Kubernetes guide.

Motivation

To ease adoption of the feature for users.

Additional Notes

Complements #3112.

@dtomcej PTAL

/cc @yue9944882

Copy link
Contributor

@yue9944882 yue9944882 left a comment

Choose a reason for hiding this comment

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

Thanks! Overall LGTM😃


- The associated service backends must share the same path and host.
- The total percentage shared across all service backends must yield 100% (see the section on [omitting the final service](#omitting-the-final-service), however).
- The percentage values are interpreted as floating point numbers to a supported precision as defined in the [configuration details](/configuration/backends/kubernetes).
Copy link
Contributor

Choose a reason for hiding this comment

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

Could we add an anchor of this document? It's a long document and I don't think users might find the detail of this annotation easily.

/configuration/backends/kubernetes#specify-weight

Copy link
Contributor Author

Choose a reason for hiding this comment

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

A deep link seems tricky to do unless we resort to using custom HTML in markdown. For now, I decided to point to the annotations section. Let me know what you think.

@timoreimann
Copy link
Contributor Author

Pushed another commit that removes the canary use case example from the backend docs as we now have that in the user guide. I replaced it with a link.

Copy link
Contributor

@ldez ldez left a comment

Choose a reason for hiding this comment

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

LGTM

Copy link
Member

@mmatur mmatur left a comment

Choose a reason for hiding this comment

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

LGTM

@ldez ldez force-pushed the kubernetes/describe-service-weights-in-guide branch from 09deb4f to 45fe392 Compare July 3, 2018 09:18
Copy link
Contributor

@nmengin nmengin left a comment

Choose a reason for hiding this comment

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

LGTM 📖

Copy link
Contributor

@dtomcej dtomcej left a comment

Choose a reason for hiding this comment

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

LGTM
:shipit:

@traefiker traefiker force-pushed the kubernetes/describe-service-weights-in-guide branch from 45fe392 to e55d75c Compare July 3, 2018 14:46
@traefiker traefiker merged commit 41eb4f1 into traefik:master Jul 3, 2018
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

7 participants