Skip to content

Fix server reload race: use Shutdown, serialize reloads, eliminate data races#2094

Open
sky333999 wants to merge 1 commit intomainfrom
sky333999/logging
Open

Fix server reload race: use Shutdown, serialize reloads, eliminate data races#2094
sky333999 wants to merge 1 commit intomainfrom
sky333999/logging

Conversation

@sky333999
Copy link
Copy Markdown
Contributor

Description of the issue

Follow up to #1957.
When the CertWatcher detects TLS certificate changes, it calls reloadServer which closes the old HTTPS server and starts a new one. The previous implementation used Close() which returns before the listener fully releases the port, causing intermittent 'address already in use' errors on the new ListenAndServeTLS call.

Additionally, rapid fsnotify events (e.g. kubelet cert sync triggering remove+create) could invoke reloadServer concurrently, racing on s.httpsServer and the shared tls.Config.

Description of changes

  • Replace Close() with Shutdown() to wait for the port to be freed
  • Add sync.Mutex to serialize concurrent reloadServer calls
  • Capture server in local variable before goroutine to prevent data race on s.httpsServer field
  • Clone tls.Config to prevent race between old server shutdown and new server startup
  • Filter http.ErrServerClosed in both Start and reloadServer since it is expected during reload

License

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

Tests

Updated unit tests to simulate race conditions

Requirements

Before commiting your code, please do the following steps.

  1. Run make fmt and make fmt-sh
  2. Run make lint

Integration Tests

To run integration tests against this PR, add the ready for testing label.

…ta races

When the CertWatcher detects TLS certificate changes, it calls
reloadServer which closes the old HTTPS server and starts a new one.
The previous implementation used Close() which returns before the
listener fully releases the port, causing intermittent 'address already
in use' errors on the new ListenAndServeTLS call.

Additionally, rapid fsnotify events (e.g. kubelet cert sync triggering
remove+create) could invoke reloadServer concurrently, racing on
s.httpsServer and the shared tls.Config.

Changes:
- Replace Close() with Shutdown() to wait for the port to be freed
- Add sync.Mutex to serialize concurrent reloadServer calls
- Capture server in local variable before goroutine to prevent data
  race on s.httpsServer field
- Clone tls.Config to prevent race between old server shutdown and
  new server startup
- Filter http.ErrServerClosed in both Start and reloadServer since
  it is expected during reload
@sky333999 sky333999 requested a review from a team as a code owner April 21, 2026 02:02
@github-actions
Copy link
Copy Markdown
Contributor

This PR was marked stale due to lack of activity.

@github-actions github-actions Bot added the Stale label Apr 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant