[PR #2941] [CLOSED] feat: add PingNode RPC protobuf definitions #2948

Closed
opened 2025-12-29 04:19:46 +01:00 by adam · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/juanfont/headscale/pull/2941
Author: @roganlynch
Created: 12/6/2025
Status: Closed

Base: mainHead: pr4a-grpc-proto


📝 Commits (4)

  • 3b8bad4 feat(mapper): add SendDirectUpdate method for direct MapResponse delivery
  • 27e7d10 feat(ping): add core PingRequest/Response implementation
  • e4f6362 Add ping scheduler for node liveness checks
  • 85bab21 Add PingNode RPC protobuf definitions

📊 Changes

16 files changed (+1323 additions, -78 deletions)

View changed files

📝 config-example.yaml (+29 -0)
📝 gen/go/headscale/v1/headscale.pb.go (+71 -66)
📝 gen/go/headscale/v1/headscale.pb.gw.go (+81 -0)
📝 gen/go/headscale/v1/headscale_grpc.pb.go (+38 -0)
📝 gen/go/headscale/v1/node.pb.go (+179 -12)
📝 gen/openapiv2/headscale/v1/headscale.swagger.json (+86 -0)
📝 hscontrol/app.go (+15 -0)
📝 hscontrol/mapper/batcher.go (+1 -0)
📝 hscontrol/mapper/batcher_lockfree.go (+32 -0)
📝 hscontrol/noise.go (+75 -0)
hscontrol/ping.go (+280 -0)
hscontrol/ping_scheduler.go (+281 -0)
hscontrol/ping_scheduler_test.go (+111 -0)
📝 hscontrol/types/config.go (+21 -0)
📝 proto/headscale/v1/headscale.proto (+7 -0)
📝 proto/headscale/v1/node.proto (+16 -0)

📄 Description

Adds PingNode RPC protobuf definitions for the gRPC API.

Changes

  • PingNodeRequest: Protobuf message definition for ping requests
  • PingNodeResponse: Protobuf message definition for ping responses
  • RPC service definition: Adds PingNode method to the HeadscaleService
  • Generated code: Includes compiled protobuf Go code

Implementation Details

Defines the gRPC contract for the PingNode API, allowing clients to request node pings through the headscale control API. The request includes node identification, and the response provides ping status and results.

Context

Part of the work discussed in #2902 to add ping functionality to headscale.

Dependencies

  • Requires PR #2940 (ping scheduler)

Note: This code was generated with assistance from Claude Sonnet 4.5 via cline.bot


🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/juanfont/headscale/pull/2941 **Author:** [@roganlynch](https://github.com/roganlynch) **Created:** 12/6/2025 **Status:** ❌ Closed **Base:** `main` ← **Head:** `pr4a-grpc-proto` --- ### 📝 Commits (4) - [`3b8bad4`](https://github.com/juanfont/headscale/commit/3b8bad4252652995d5b95467d39befc79a1a26db) feat(mapper): add SendDirectUpdate method for direct MapResponse delivery - [`27e7d10`](https://github.com/juanfont/headscale/commit/27e7d10285d373c26fc389f20deab4c1458924bb) feat(ping): add core PingRequest/Response implementation - [`e4f6362`](https://github.com/juanfont/headscale/commit/e4f6362853ca2334cc5cec49f32e7d18e3139977) Add ping scheduler for node liveness checks - [`85bab21`](https://github.com/juanfont/headscale/commit/85bab21ba23bee9e4c954cd18f4c2d8c9d51e37e) Add PingNode RPC protobuf definitions ### 📊 Changes **16 files changed** (+1323 additions, -78 deletions) <details> <summary>View changed files</summary> 📝 `config-example.yaml` (+29 -0) 📝 `gen/go/headscale/v1/headscale.pb.go` (+71 -66) 📝 `gen/go/headscale/v1/headscale.pb.gw.go` (+81 -0) 📝 `gen/go/headscale/v1/headscale_grpc.pb.go` (+38 -0) 📝 `gen/go/headscale/v1/node.pb.go` (+179 -12) 📝 `gen/openapiv2/headscale/v1/headscale.swagger.json` (+86 -0) 📝 `hscontrol/app.go` (+15 -0) 📝 `hscontrol/mapper/batcher.go` (+1 -0) 📝 `hscontrol/mapper/batcher_lockfree.go` (+32 -0) 📝 `hscontrol/noise.go` (+75 -0) ➕ `hscontrol/ping.go` (+280 -0) ➕ `hscontrol/ping_scheduler.go` (+281 -0) ➕ `hscontrol/ping_scheduler_test.go` (+111 -0) 📝 `hscontrol/types/config.go` (+21 -0) 📝 `proto/headscale/v1/headscale.proto` (+7 -0) 📝 `proto/headscale/v1/node.proto` (+16 -0) </details> ### 📄 Description Adds PingNode RPC protobuf definitions for the gRPC API. ## Changes - **PingNodeRequest**: Protobuf message definition for ping requests - **PingNodeResponse**: Protobuf message definition for ping responses - **RPC service definition**: Adds PingNode method to the HeadscaleService - **Generated code**: Includes compiled protobuf Go code ## Implementation Details Defines the gRPC contract for the PingNode API, allowing clients to request node pings through the headscale control API. The request includes node identification, and the response provides ping status and results. ## Context Part of the work discussed in #2902 to add ping functionality to headscale. ## Dependencies - Requires PR #2940 (ping scheduler) --- *Note: This code was generated with assistance from Claude Sonnet 4.5 via cline.bot* --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
adam added the pull-request label 2025-12-29 04:19:46 +01:00
adam closed this issue 2025-12-29 04:19:46 +01:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/headscale#2948