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

feat: Use command probe for increased accuracy (#344) #359

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

Conversation

Javex
Copy link

@Javex Javex commented Mar 8, 2025

Description of the change

The liveness & readiness probes previously checked that the web server was up, but did not check that FTL was running. There are conditions under which the web server starts, but FTL fails to start. Using HTTP probes does not catch those conditions, but the web server offers an endpoint that returns the DNS status. If the web server is not up, this probe will continue to fail since it can't curl the endpoint. In addition, it will now also fail if the DNS server is down.

Benefits

Increased accuracy in both readiness & liveness check

Possible drawbacks

  • If someone has swapped out their Pi-Hole image for one without curl this is a breaking change. I think it's highly unlikely, as curl is in just about every image.
  • Then /login endpoint is used when visiting the login screen, so it doesn't require auth but gets information about the DNS server. However, I don't know if this might not change at some point in the future. I think it's worth the risk, it's an easy fix if Pi-Hole changes this endpoint.

Applicable issues

Additional information

Checklist

The liveness & readiness probes previously checked that the web server
was up, but did not check that FTL was running. There are conditions
under which the web server starts, but FTL fails to start. Using HTTP
probes does not catch those conditions, but the web server offers an
endpoint that returns the DNS status. If the web server is not up, this
probe will continue to fail since it can't `curl` the endpoint. In
addition, it will now also fail if the DNS server is down.

Signed-off-by: javex <code@inexplicity.de>
@auto-assign auto-assign bot requested a review from MoJo2600 March 8, 2025 21:58
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.

Pi-Hole API as default startup probe
2 participants