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

docs: explain Terminus behavior in usage docs #274

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

klesniewski
Copy link

Summary

As I wanted to use Terminus in my project, I struggled to understand how it will behave. In the end, I went through tests and sources to understand its behavior. I have documented it, so it is easier to understand to others new to the project.

Changelog

  • Improve usage docs

Test Plan

  • No changes to test

@klesniewski klesniewski requested a review from a team as a code owner June 20, 2023 09:51
You can use it to start failing readiness probe.
2. Execute and wait for `beforeShutdown`.
Here you can log the fact that shutdown has started.
You can also delay here shutting down HTTP server, so that the service is taken out from load balancer first.

Choose a reason for hiding this comment

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

Suggested change
You can also delay here shutting down HTTP server, so that the service is taken out from load balancer first.
If you perform asynchronous code, this will delay the shutting down of the HTTP server, but if you've configured your readiness probe correctly, your instance may be removed from your load balancer before this completes.


With `healthChecks` you can register multiple health checks, so you can have a separate liveness and readiness probe implementations.

Note, that when `sendFailuredDuringShutdown` is set to `true` (default) and Terminus enters shutting down state, it will return failure without calling provided health check implementation.
Copy link

@jpage-godaddy jpage-godaddy Jun 20, 2023

Choose a reason for hiding this comment

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

Suggested change
Note, that when `sendFailuredDuringShutdown` is set to `true` (default) and Terminus enters shutting down state, it will return failure without calling provided health check implementation.
Note, that when `sendFailuresDuringShutdown` is set to `true` (default) and Terminus enters the shutting down state, it will send failures without calling your provided health check implementation.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants