pallavithegod commented on code in PR #3358: URL: https://github.com/apache/hugegraph/pull/3358#discussion_r4316702934
########## docker/README.md: ########## @@ -172,6 +172,20 @@ curl -fsS http://localhost:8088/about </details> +### PD health and readiness + +PD's `/v1/ready` returns HTTP 503 while it cannot serve through a Raft quorum. +`/v1/health` remains HTTP 200 during an election or temporary quorum loss, but +returns HTTP 503 after a fatal Raft error or state-machine shutdown. Both health +responses retain the empty text body. Probes read cached state without waiting +for the Raft node lock. + +A failed snapshot, for example after the PD disk fills, leaves JRaft in a terminal +error state. Free disk space before restarting the affected PD; freeing space +alone does not reinitialize its Raft node. Configure liveness against `/v1/health` +with an image containing this fix and gate traffic on `/v1/ready`. Older images Review Comment: Qualified the Docker guidance in e7e66661a: the traffic-readiness recommendation requires an external gate. The same paragraph now explicitly states that the shipped Compose service_healthy dependencies use /v1/health and do not wait for PD quorum readiness. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
