diff --git a/Dockerfile b/Dockerfile index 765e1ea..84da623 100644 --- a/Dockerfile +++ b/Dockerfile @@ -10,8 +10,5 @@ RUN CGO_ENABLED=0 go build -ldflags "-X main.Version=${CHECKER_VERSION}" -o /che FROM scratch COPY --from=builder /checker-dummy /checker-dummy -USER 65534:65534 EXPOSE 8080 -HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \ - CMD ["/checker-dummy", "-healthcheck"] ENTRYPOINT ["/checker-dummy"] diff --git a/Makefile b/Makefile index 3271216..6ccbd22 100644 --- a/Makefile +++ b/Makefile @@ -6,7 +6,7 @@ CHECKER_SOURCES := main.go $(wildcard checker/*.go) GO_LDFLAGS := -X main.Version=$(CHECKER_VERSION) -.PHONY: all plugin docker test clean +.PHONY: all plugin docker clean all: $(CHECKER_NAME) @@ -21,8 +21,5 @@ $(CHECKER_NAME).so: $(CHECKER_SOURCES) $(wildcard plugin/*.go) docker: docker build --build-arg CHECKER_VERSION=$(CHECKER_VERSION) -t $(CHECKER_IMAGE) . -test: - go test -tags standalone ./... - clean: rm -f $(CHECKER_NAME) $(CHECKER_NAME).so diff --git a/NOTICE b/NOTICE deleted file mode 100644 index ae61715..0000000 --- a/NOTICE +++ /dev/null @@ -1,26 +0,0 @@ -checker-dummy -Copyright (c) 2026 The happyDomain Authors - -This product is licensed under the MIT License (see LICENSE). - -------------------------------------------------------------------------------- -Third-party notices -------------------------------------------------------------------------------- - -This product includes software developed as part of the checker-sdk-go -project (https://git.happydns.org/happyDomain/checker-sdk-go), licensed -under the Apache License, Version 2.0: - - checker-sdk-go - Copyright 2020-2026 The happyDomain Authors - - This product includes software developed as part of the happyDomain - project (https://happydomain.org). - - Portions of this code were originally written for the happyDomain - server (licensed under AGPL-3.0 and a commercial license) and are - made available there under the Apache License, Version 2.0 to enable - a permissively licensed ecosystem of checker plugins. - -You may obtain a copy of the Apache License 2.0 at: - http://www.apache.org/licenses/LICENSE-2.0 diff --git a/README.md b/README.md index 6e7c166..1070be4 100644 --- a/README.md +++ b/README.md @@ -19,12 +19,11 @@ Use this as a template when you create your own checker. - [Step 5: Write Evaluation Rules](#step-5-write-evaluation-rules) - [Step 6: Wire It Up (main.go)](#step-6-wire-it-up-maingo) - [Step 7: Create the Plugin Entrypoint](#step-7-create-the-plugin-entrypoint) -5. [Optional: Standalone Human UI (`CheckerInteractive`)](#optional-standalone-human-ui-checkerinteractive) -6. [Running the Checker](#running-the-checker) -7. [Testing with curl](#testing-with-curl) -8. [Deploying to happyDomain](#deploying-to-happydomain) -9. [License & happyDomain compatibility](#license--happydomain-compatibility) -10. [Going Further](#going-further) +5. [Running the Checker](#running-the-checker) +6. [Testing with curl](#testing-with-curl) +7. [Deploying to happyDomain](#deploying-to-happydomain) +8. [License & happyDomain compatibility](#license--happydomain-compatibility) +9. [Going Further](#going-further) --- @@ -41,30 +40,18 @@ Every checker does three things: ## Architecture Overview -A checker can run in three modes: +A checker can run in two modes: -### Built-in Checker +### Standalone HTTP Server (External Checker) -The checker package can be imported directly into the happyDomain server and registered at init time: no plugin loading, no separate process. This avoids the operational burden of Go's plugin system (matching toolchain versions, CGO, `.so` distribution) entirely. +The checker runs as its own process and exposes an HTTP API. happyDomain communicates with it over the network. This is the most flexible option: you can write your checker in any language, deploy it independently, and scale it separately. -```go -// happydomain/checkers/ping.go -package checkers - -import ( - ping "git.happydns.org/checker-ping/checker" - "git.happydns.org/internal/checker" -) - -func init() { - checker.RegisterObservationProvider(ping.Provider()) - checker.RegisterExternalizableChecker(ping.Definition()) -} ``` - -This mode is reserved for checkers maintained as part of the happyDomain project itself. Or if you compile yourself your own version of happyDomain. - -**Both standalone, plugin and built-in modes use the same checker code; only the entry point differs.** +┌─────────────┐ HTTP ┌─────────────────┐ +│ happyDomain │ ──────────► │ checker-dummy │ +│ server │ ◄────────── │ (this program) │ +└─────────────┘ └─────────────────┘ +``` ### In-Process Plugin @@ -83,16 +70,28 @@ The checker is compiled as a Go plugin (`.so` file) and loaded directly into the └──────────────────────────────────────┘ ``` -### Standalone HTTP Server (External Checker) +### Built-in Checker -The checker runs as its own process and exposes an HTTP API. happyDomain communicates with it over the network. This is the most flexible option: you can write your checker in any language, deploy it independently, and scale it separately. +The checker package can be imported directly into the happyDomain server and registered at init time: no plugin loading, no separate process. This avoids the operational burden of Go's plugin system (matching toolchain versions, CGO, `.so` distribution) entirely. +```go +// happydomain/checkers/ping.go +package checkers + +import ( + ping "git.happydns.org/happyDomain/checker-ping/checker" + "git.happydns.org/happyDomain/internal/checker" +) + +func init() { + checker.RegisterObservationProvider(ping.Provider()) + checker.RegisterExternalizableChecker(ping.Definition()) +} ``` -┌─────────────┐ HTTP ┌─────────────────┐ -│ happyDomain │ ──────────► │ checker-dummy │ -│ server │ ◄────────── │ (this program) │ -└─────────────┘ └─────────────────┘ -``` + +This mode is reserved for checkers maintained as part of the happyDomain project itself. Or if you compile yourself your own version of happyDomain. + +**Both standalone, plugin and built-in modes use the same checker code; only the entry point differs.** ## Repository Structure @@ -161,7 +160,6 @@ You can also implement optional interfaces to unlock additional features: | `CheckerDefinitionProvider` | `/definition` and `/evaluate` endpoints | | `CheckerMetricsReporter` | `/report` endpoint (JSON metrics) | | `CheckerHTMLReporter` | `/report` endpoint (HTML) | -| `CheckerInteractive` | `GET`/`POST /check` human-friendly HTML UI | In this example, we implement all three optional interfaces: @@ -293,19 +291,19 @@ A rule implements the `CheckRule` interface: type CheckRule interface { Name() string Description() string - Evaluate(ctx context.Context, obs ObservationGetter, opts CheckerOptions) []CheckState + Evaluate(ctx context.Context, obs ObservationGetter, opts CheckerOptions) CheckState } ``` Optionally, your rule can also implement `ValidateOptions(opts) error` for early validation. -The `Evaluate` method receives an `ObservationGetter` to retrieve the collected data and returns a **slice** of `CheckState`, one entry per element being evaluated: +The `Evaluate` method receives an `ObservationGetter` to retrieve the collected data: ```go -func (r *dummyRule) Evaluate(ctx context.Context, obs ObservationGetter, opts CheckerOptions) []CheckState { +func (r *dummyRule) Evaluate(ctx context.Context, obs ObservationGetter, opts CheckerOptions) CheckState { var data DummyData if err := obs.Get(ctx, ObservationKeyDummy, &data); err != nil { - return []CheckState{{Status: StatusError, Message: "..."}} + return CheckState{Status: StatusError, Message: "..."} } warningThreshold := sdk.GetFloatOption(opts, "warningThreshold", 50) @@ -313,52 +311,16 @@ func (r *dummyRule) Evaluate(ctx context.Context, obs ObservationGetter, opts Ch switch { case data.Score < criticalThreshold: - return []CheckState{{Status: StatusCrit, ...}} + return CheckState{Status: StatusCrit, ...} case data.Score < warningThreshold: - return []CheckState{{Status: StatusWarn, ...}} + return CheckState{Status: StatusWarn, ...} default: - return []CheckState{{Status: StatusOK, ...}} + return CheckState{Status: StatusOK, ...} } } ``` -**Contract**: `Evaluate` must return at least one state. If a rule has nothing to evaluate, return a single `CheckState` describing that fact (typically `StatusInfo` or `StatusOK`). The SDK server injects a `StatusUnknown` placeholder if a rule returns an empty or nil slice. - -**The `CheckState` struct**: - -```go -type CheckState struct { - Status Status - Message string - RuleName string // set automatically by the server, do not set yourself - Code string // optional, use to distinguish kinds of finding within one rule - Subject string // opaque per-element identifier (hostname, cert serial, …) - Meta map[string]any -} -``` - -- **`Subject`** identifies the element a state refers to (a hostname, a certificate serial, a nameserver FQDN, …). Leave empty for rules that produce a single global result. Do **not** repeat the subject inside `Message`, the UI renders it separately. -- **`RuleName`** is stamped automatically by the server with `rule.Name()` on every returned state. UIs should use `RuleName` (not `Code`) to group, filter, or offer "disable this rule" controls. -- **`Code`** is left untouched by the server. Set it only when your rule emits several kinds of finding (e.g. `too_many_lookups` vs `syntax_error`). - -**One state per subject**: a rule that iterates over N elements should emit N states (one per `Subject`) instead of concatenating them into a single `Message`: - -```go -func (r *CertExpiryRule) Evaluate(...) []CheckState { - out := make([]CheckState, 0, len(certs)) - for _, cert := range certs { - s := evalCert(cert) - s.Subject = cert.Host - out = append(out, s) - } - if len(out) == 0 { - return []CheckState{{Status: StatusInfo, Message: "no certificate to evaluate"}} - } - return out -} -``` - -**Status values**: `StatusOK`, `StatusWarn`, `StatusCrit`, `StatusError`, `StatusUnknown`, `StatusInfo`. +**Status values**: `StatusOK`, `StatusWarn`, `StatusCrit`, `StatusError`, `StatusUnknown`. You can define **multiple rules** per checker. Each rule evaluates the same collected data from a different angle. Users can enable/disable rules individually in the UI. @@ -389,7 +351,6 @@ func main() { | `GET /definition` | - | `CheckerDefinitionProvider` | | `POST /evaluate` | - | `CheckerDefinitionProvider` | | `POST /report` | - | `CheckerMetricsReporter` or `CheckerHTMLReporter` | -| `GET`/`POST /check` | - | `CheckerInteractive` | ### Step 7: Create the Plugin Entrypoint @@ -401,13 +362,13 @@ For in-process plugin mode, the entrypoint must be a `package main` that exposes package main import ( - sdk "git.happydns.org/checker-sdk-go/checker" - dummy "git.happydns.org/checker-dummy/checker" + dummy "git.happydns.org/happyDomain/checker-dummy/checker" + "git.happydns.org/happyDomain/model" ) var Version = "custom-build" -func NewCheckerPlugin() (*sdk.CheckerDefinition, sdk.ObservationProvider, error) { +func NewCheckerPlugin() (*happydns.CheckerDefinition, happydns.ObservationProvider, error) { // Propagate the plugin's version to the checker package. dummy.Version = Version return dummy.Definition(), dummy.Provider(), nil @@ -425,53 +386,6 @@ Then drop the resulting `checker-dummy.so` into one of happyDomain's configured --- -## Optional: Standalone Human UI (`CheckerInteractive`) - -The SDK provides an optional `CheckerInteractive` interface that exposes a browser-friendly `/check` route, letting your checker be used as a standalone DNS-probing tool without a happyDomain instance in front of it. - -```go -type CheckerInteractive interface { - RenderForm() []CheckerOptionField - ParseForm(r *http.Request) (CheckerOptions, error) -} -``` - -When a provider implements it, `NewServer` automatically registers: - -- `GET /check`, renders an HTML form derived from `RenderForm()`. -- `POST /check`, calls `ParseForm`, runs the standard `Collect` → `Evaluate` → `GetHTMLReport` / `ExtractMetrics` pipeline, and returns a consolidated HTML page (states table, metrics table, sandboxed iframe around the HTML report). - -### Why it exists - -Over the HTTP `/evaluate` endpoint, happyDomain fills `AutoFill*`-backed options (zone records, service payload, …) from its execution context. A human hitting `/check` has no such host, `ParseForm` is where the checker does whatever lookups are needed (typically direct DNS queries) to turn a minimal human input (e.g. a domain name) into the full `CheckerOptions` that `Collect` expects. - -### When to implement it - -- You want the checker to be usable as a standalone DNS-probing tool (debug, demo, one-off runs) without a happyDomain instance. -- You are fine doing the auto-fill work yourself from the user's inputs. Checkers whose `Collect` intrinsically requires data only happyDomain can provide (e.g. a full zone diff) should skip this. - -### Minimal implementation - -```go -func (p *dummyProvider) RenderForm() []sdk.CheckerOptionField { - return []sdk.CheckerOptionField{ - {Id: "message", Type: "string", Label: "Custom message", - Placeholder: "Hello!", Required: false}, - } -} - -func (p *dummyProvider) ParseForm(r *http.Request) (sdk.CheckerOptions, error) { - return sdk.CheckerOptions{ - "message": strings.TrimSpace(r.FormValue("message")), - }, nil -} -``` - -Returning an error from `ParseForm` re-renders the form with the error message displayed so the user can correct and resubmit. - ---- - - ## Running the Checker ### Build and run locally @@ -553,15 +467,12 @@ Response (score 42.5 is below the warning threshold of 50): { "status": 3, "message": "Score: 42.5 - test", - "rule_name": "dummy_score_check", "code": "dummy_score_check" } ] } ``` -Each entry in `states` carries a `rule_name` (server-stamped) and may include a `subject` field when the rule evaluates multiple elements. - Status codes: `1` = OK, `3` = Warning, `4` = Critical. ### Extract metrics @@ -600,15 +511,13 @@ curl -X POST http://localhost:8080/report \ This template is released under the **MIT License**, so you're free to use it as a starting point for any checker, including proprietary ones. -The types and helpers your checker depends on live in [`checker-sdk-go`](https://git.happydns.org/checker-sdk-go), a separate module released under the **Apache License 2.0**. happyDomain itself depends on the same SDK, so plugins and the host share a common, permissively licensed contract instead of linking against AGPL code. - -**What this means for the deployment mode you choose:** +**Important caveat about the deployment mode you choose:** - **Standalone HTTP checker:** your checker is a separate process communicating with happyDomain over the network. It is *not* a derivative work of happyDomain and you can license it however you want (proprietary, MIT, GPL, anything). -- **In-process plugin (`.so`):** your checker is loaded into the happyDomain process via `plugin.Open`, but it only links against the Apache-licensed SDK, not against any AGPL code. You are free to license your plugin however you want. -- **Built-in checker** (imported directly into the happyDomain source tree): same as above on the linking side. Built-in checkers maintained inside the happyDomain repository are conventionally distributed under AGPL-3.0 to stay consistent with the rest of the project, but this is a project policy, not a legal requirement coming from the SDK. +- **In-process plugin (`.so`):** your checker is loaded into the happyDomain process via `plugin.Open` and links against happyDomain's types at runtime. The FSF considers this a derivative work, so your plugin must be licensed under a license compatible with happyDomain's **AGPL-3.0** (typically AGPL-3.0 itself, or GPL-3.0). +- **Built-in checker** (imported directly into the happyDomain source tree): same constraint: AGPL-3.0. -If your checker imports anything *else* from the happyDomain repository (for example service abstractions like `happydns.ServiceMessage`), then that code *is* AGPL-licensed and the AGPL constraint comes back. The SDK alone is safe; the rest of happyDomain is not. +If in doubt, pick the standalone mode: it gives you the most licensing freedom and avoids Go's plugin toolchain headaches. --- @@ -622,7 +531,7 @@ Now that you understand the structure, here are ideas for your own checker: - **HTTP checker:** send an HTTP request to a domain's web server and check the status code, response time, ... - **Business logic:** probe your own application from the outside and verify it behaves as expected, e.g. log into your SaaS with a synthetic account and check that the dashboard loads, place a test order and confirm it reaches the order pipeline, hit an internal health endpoint that aggregates queue depth / worker lag / replication status, or check that a license server still hands out valid tokens. This turns happyDomain into a lightweight synthetic-monitoring dashboard for your own services. -For a real-world example, look at [checker-ping](https://git.happydns.org/checker-ping), which implements ICMP ping monitoring with multiple targets, packet loss detection, and RTT metrics. +For a real-world example, look at [checker-ping](https://git.happydns.org/happyDomain/checker-ping), which implements ICMP ping monitoring with multiple targets, packet loss detection, and RTT metrics. ### Tips diff --git a/checker/collect.go b/checker/collect.go index 15b75d9..9175f83 100644 --- a/checker/collect.go +++ b/checker/collect.go @@ -5,7 +5,8 @@ import ( "math/rand/v2" "time" - sdk "git.happydns.org/checker-sdk-go/checker" + "git.happydns.org/happyDomain/model" + sdk "git.happydns.org/happyDomain/sdk/checker" ) // Collect gathers observation data. This is called by happyDomain (or the @@ -24,7 +25,7 @@ import ( // Return: // - any: the observation data (will be JSON-serialised by the SDK). // - error: non-nil if collection failed entirely. -func (p *dummyProvider) Collect(ctx context.Context, opts sdk.CheckerOptions) (any, error) { +func (p *dummyProvider) Collect(ctx context.Context, opts happydns.CheckerOptions) (any, error) { // Read user-configurable options using the SDK helpers. // These helpers handle type coercion gracefully - the value may come as // a native Go type (in-process plugin) or as a JSON-decoded float64/string diff --git a/checker/definition.go b/checker/definition.go index 3c4d99e..dbb5b65 100644 --- a/checker/definition.go +++ b/checker/definition.go @@ -3,7 +3,7 @@ package checker import ( "time" - sdk "git.happydns.org/checker-sdk-go/checker" + "git.happydns.org/happyDomain/model" ) // Version is the checker version reported in CheckerDefinition.Version. @@ -21,8 +21,8 @@ var Version = "built-in" // A CheckerDefinition tells happyDomain everything it needs to know about // your checker: its identity, where it can be applied, what options it // accepts, what rules it provides, and how often it should run. -func Definition() *sdk.CheckerDefinition { - return &sdk.CheckerDefinition{ +func Definition() *happydns.CheckerDefinition { + return &happydns.CheckerDefinition{ // ID is a unique, stable identifier for this checker. It is stored in // the database, so never change it after release. ID: "dummy", @@ -43,13 +43,13 @@ func Definition() *sdk.CheckerDefinition { // Here we apply it at the domain level, which means users will see // this checker in the "Domain checks" section and it does not require // a specific service to be present. - Availability: sdk.CheckerAvailability{ + Availability: happydns.CheckerAvailability{ ApplyToDomain: true, }, // ObservationKeys lists the keys this checker produces. This ties // the definition to the provider(s) that generate the data. - ObservationKeys: []sdk.ObservationKey{ObservationKeyDummy}, + ObservationKeys: []happydns.ObservationKey{ObservationKeyDummy}, // Options documents what configuration the checker accepts. Options // are grouped by audience (admin, user, domain, service, run): @@ -62,8 +62,8 @@ func Definition() *sdk.CheckerDefinition { // // Each option has an Id (used as the key in CheckerOptions), a Type // for the UI widget, a Label, and optionally a Default value. - Options: sdk.CheckerOptionsDocumentation{ - UserOpts: []sdk.CheckerOptionDocumentation{ + Options: happydns.CheckerOptionsDocumentation{ + UserOpts: []happydns.CheckerOptionDocumentation{ { Id: "message", Type: "string", @@ -86,11 +86,11 @@ func Definition() *sdk.CheckerDefinition { Default: float64(20), }, }, - DomainOpts: []sdk.CheckerOptionDocumentation{ + DomainOpts: []happydns.CheckerOptionDocumentation{ { Id: "domain_name", Label: "Domain name", - AutoFill: sdk.AutoFillDomainName, + AutoFill: happydns.AutoFillDomainName, }, }, }, @@ -98,12 +98,12 @@ func Definition() *sdk.CheckerDefinition { // Rules lists the evaluation rules provided by this checker. Each // rule will appear in the UI, and users can enable/disable them // individually. - Rules: []sdk.CheckRule{ + Rules: []happydns.CheckRule{ Rule(), }, // Interval specifies how often the check should run. - Interval: &sdk.CheckIntervalSpec{ + Interval: &happydns.CheckIntervalSpec{ Min: 1 * time.Minute, Max: 1 * time.Hour, Default: 5 * time.Minute, diff --git a/checker/provider.go b/checker/provider.go index 9aee115..fc6fcb2 100644 --- a/checker/provider.go +++ b/checker/provider.go @@ -4,7 +4,7 @@ import ( "encoding/json" "time" - sdk "git.happydns.org/checker-sdk-go/checker" + "git.happydns.org/happyDomain/model" ) // Provider returns a new dummy observation provider. @@ -19,7 +19,7 @@ import ( // // In this example, the provider implements all three optional interfaces // so you can see how each one works. -func Provider() sdk.ObservationProvider { +func Provider() happydns.ObservationProvider { return &dummyProvider{} } @@ -30,27 +30,27 @@ type dummyProvider struct{} // Key returns the observation key for this provider. This must match the key // used in your CheckerDefinition's ObservationKeys list so happyDomain knows // which provider produces which data. -func (p *dummyProvider) Key() sdk.ObservationKey { +func (p *dummyProvider) Key() happydns.ObservationKey { return ObservationKeyDummy } -// Definition implements sdk.CheckerDefinitionProvider. +// Definition implements happydns.CheckerDefinitionProvider. // Returning a definition enables the /definition and /evaluate HTTP endpoints // in the SDK server, and lets happyDomain discover this checker's metadata. -func (p *dummyProvider) Definition() *sdk.CheckerDefinition { +func (p *dummyProvider) Definition() *happydns.CheckerDefinition { return Definition() } -// ExtractMetrics implements sdk.CheckerMetricsReporter. +// ExtractMetrics implements happydns.CheckerMetricsReporter. // This is called when happyDomain (or the /report endpoint) needs to turn // raw observation data into time-series metrics for graphing. -func (p *dummyProvider) ExtractMetrics(ctx sdk.ReportContext, collectedAt time.Time) ([]sdk.CheckMetric, error) { +func (p *dummyProvider) ExtractMetrics(raw json.RawMessage, collectedAt time.Time) ([]happydns.CheckMetric, error) { var data DummyData - if err := json.Unmarshal(ctx.Data(), &data); err != nil { + if err := json.Unmarshal(raw, &data); err != nil { return nil, err } - return []sdk.CheckMetric{ + return []happydns.CheckMetric{ { Name: "dummy_score", Value: data.Score, diff --git a/checker/rule.go b/checker/rule.go index 85c3475..1759891 100644 --- a/checker/rule.go +++ b/checker/rule.go @@ -4,7 +4,8 @@ import ( "context" "fmt" - sdk "git.happydns.org/checker-sdk-go/checker" + "git.happydns.org/happyDomain/model" + sdk "git.happydns.org/happyDomain/sdk/checker" ) // Rule returns a new dummy check rule. @@ -12,11 +13,11 @@ import ( // A rule evaluates collected observation data and returns a status (OK, // Warning, Critical, Error). Each checker can define multiple rules that // inspect the same data from different angles. -func Rule() sdk.CheckRule { +func Rule() happydns.CheckRule { return &dummyRule{} } -// dummyRule implements the sdk.CheckRule interface. +// dummyRule implements the happydns.CheckRule interface. type dummyRule struct{} // Name returns a unique, stable identifier for this rule. It is used as the @@ -31,7 +32,7 @@ func (r *dummyRule) Description() string { // ValidateOptions is called before evaluation to verify that the options are // well-formed. Return an error to reject invalid configuration early, before // any data collection happens. -func (r *dummyRule) ValidateOptions(opts sdk.CheckerOptions) error { +func (r *dummyRule) ValidateOptions(opts happydns.CheckerOptions) error { warning := sdk.GetFloatOption(opts, "warningThreshold", 50) critical := sdk.GetFloatOption(opts, "criticalThreshold", 20) @@ -58,15 +59,15 @@ func (r *dummyRule) ValidateOptions(opts sdk.CheckerOptions) error { // The ObservationGetter.Get method deserialises the stored JSON into your data // struct. Always check the error: the observation may not be available if // collection failed. -func (r *dummyRule) Evaluate(ctx context.Context, obs sdk.ObservationGetter, opts sdk.CheckerOptions) []sdk.CheckState { +func (r *dummyRule) Evaluate(ctx context.Context, obs happydns.ObservationGetter, opts happydns.CheckerOptions) happydns.CheckState { // Retrieve the observation data by key. var data DummyData if err := obs.Get(ctx, ObservationKeyDummy, &data); err != nil { - return []sdk.CheckState{{ - Status: sdk.StatusError, + return happydns.CheckState{ + Status: happydns.StatusError, Message: fmt.Sprintf("Failed to get dummy data: %v", err), Code: "dummy_error", - }} + } } // Read thresholds from options. @@ -74,17 +75,17 @@ func (r *dummyRule) Evaluate(ctx context.Context, obs sdk.ObservationGetter, opt criticalThreshold := sdk.GetFloatOption(opts, "criticalThreshold", 20) // Determine the status based on the score and thresholds. - var status sdk.Status + var status happydns.Status switch { case data.Score < criticalThreshold: - status = sdk.StatusCrit + status = happydns.StatusCrit case data.Score < warningThreshold: - status = sdk.StatusWarn + status = happydns.StatusWarn default: - status = sdk.StatusOK + status = happydns.StatusOK } - return []sdk.CheckState{{ + return happydns.CheckState{ Status: status, Message: fmt.Sprintf("Score: %.1f - %s", data.Score, data.Message), Code: "dummy_score_check", @@ -92,5 +93,5 @@ func (r *dummyRule) Evaluate(ctx context.Context, obs sdk.ObservationGetter, opt "score": data.Score, "message": data.Message, }, - }} + } } diff --git a/go.mod b/go.mod index 1b83b1e..58c7d56 100644 --- a/go.mod +++ b/go.mod @@ -1,5 +1,44 @@ -module git.happydns.org/checker-dummy +module git.happydns.org/happyDomain/checker-dummy go 1.25.0 -require git.happydns.org/checker-sdk-go v1.5.0 +require git.happydns.org/happyDomain v0.6.0 + +require ( + github.com/bytedance/gopkg v0.1.3 // indirect + github.com/bytedance/sonic v1.15.0 // indirect + github.com/bytedance/sonic/loader v0.5.0 // indirect + github.com/cloudwego/base64x v0.1.6 // indirect + github.com/gabriel-vasile/mimetype v1.4.13 // indirect + github.com/gin-contrib/sse v1.1.0 // indirect + github.com/gin-gonic/gin v1.12.0 // indirect + github.com/go-playground/locales v0.14.1 // indirect + github.com/go-playground/universal-translator v0.18.1 // indirect + github.com/go-playground/validator/v10 v10.30.1 // indirect + github.com/goccy/go-json v0.10.5 // indirect + github.com/goccy/go-yaml v1.19.2 // indirect + github.com/json-iterator/go v1.1.13-0.20220915233716-71ac16282d12 // indirect + github.com/klauspost/cpuid/v2 v2.3.0 // indirect + github.com/leodido/go-urn v1.4.0 // indirect + github.com/mattn/go-isatty v0.0.20 // indirect + github.com/miekg/dns v1.1.72 // indirect + github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd // indirect + github.com/modern-go/reflect2 v1.0.2 // indirect + github.com/pelletier/go-toml/v2 v2.2.4 // indirect + github.com/quic-go/qpack v0.6.0 // indirect + github.com/quic-go/quic-go v0.59.0 // indirect + github.com/twitchyliquid64/golang-asm v0.15.1 // indirect + github.com/ugorji/go/codec v1.3.1 // indirect + go.mongodb.org/mongo-driver/v2 v2.5.0 // indirect + golang.org/x/arch v0.24.0 // indirect + golang.org/x/crypto v0.49.0 // indirect + golang.org/x/mod v0.33.0 // indirect + golang.org/x/net v0.51.0 // indirect + golang.org/x/sync v0.20.0 // indirect + golang.org/x/sys v0.42.0 // indirect + golang.org/x/text v0.35.0 // indirect + golang.org/x/tools v0.42.0 // indirect + google.golang.org/protobuf v1.36.11 // indirect +) + +replace git.happydns.org/happyDomain => ../happydomain3 diff --git a/go.sum b/go.sum index c389c68..64bf1f5 100644 --- a/go.sum +++ b/go.sum @@ -1,2 +1,98 @@ -git.happydns.org/checker-sdk-go v1.5.0 h1:5uD5Cm6xJ+lwnhbJ09iCXGHbYS9zRh+Yh0NeBHkAPBY= -git.happydns.org/checker-sdk-go v1.5.0/go.mod h1:aNAcfYFfbhvH9kJhE0Njp5GX0dQbxdRB0rJ0KvSC5nI= +github.com/bytedance/gopkg v0.1.3 h1:TPBSwH8RsouGCBcMBktLt1AymVo2TVsBVCY4b6TnZ/M= +github.com/bytedance/gopkg v0.1.3/go.mod h1:576VvJ+eJgyCzdjS+c4+77QF3p7ubbtiKARP3TxducM= +github.com/bytedance/sonic v1.15.0 h1:/PXeWFaR5ElNcVE84U0dOHjiMHQOwNIx3K4ymzh/uSE= +github.com/bytedance/sonic v1.15.0/go.mod h1:tFkWrPz0/CUCLEF4ri4UkHekCIcdnkqXw9VduqpJh0k= +github.com/bytedance/sonic/loader v0.5.0 h1:gXH3KVnatgY7loH5/TkeVyXPfESoqSBSBEiDd5VjlgE= +github.com/bytedance/sonic/loader v0.5.0/go.mod h1:AR4NYCk5DdzZizZ5djGqQ92eEhCCcdf5x77udYiSJRo= +github.com/cloudwego/base64x v0.1.6 h1:t11wG9AECkCDk5fMSoxmufanudBtJ+/HemLstXDLI2M= +github.com/cloudwego/base64x v0.1.6/go.mod h1:OFcloc187FXDaYHvrNIjxSe8ncn0OOM8gEHfghB2IPU= +github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= +github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= +github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc h1:U9qPSI2PIWSS1VwoXQT9A3Wy9MM3WgvqSxFWenqJduM= +github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= +github.com/gabriel-vasile/mimetype v1.4.13 h1:46nXokslUBsAJE/wMsp5gtO500a4F3Nkz9Ufpk2AcUM= +github.com/gabriel-vasile/mimetype v1.4.13/go.mod h1:d+9Oxyo1wTzWdyVUPMmXFvp4F9tea18J8ufA774AB3s= +github.com/gin-contrib/sse v1.1.0 h1:n0w2GMuUpWDVp7qSpvze6fAu9iRxJY4Hmj6AmBOU05w= +github.com/gin-contrib/sse v1.1.0/go.mod h1:hxRZ5gVpWMT7Z0B0gSNYqqsSCNIJMjzvm6fqCz9vjwM= +github.com/gin-gonic/gin v1.12.0 h1:b3YAbrZtnf8N//yjKeU2+MQsh2mY5htkZidOM7O0wG8= +github.com/gin-gonic/gin v1.12.0/go.mod h1:VxccKfsSllpKshkBWgVgRniFFAzFb9csfngsqANjnLc= +github.com/go-playground/assert/v2 v2.2.0 h1:JvknZsQTYeFEAhQwI4qEt9cyV5ONwRHC+lYKSsYSR8s= +github.com/go-playground/assert/v2 v2.2.0/go.mod h1:VDjEfimB/XKnb+ZQfWdccd7VUvScMdVu0Titje2rxJ4= +github.com/go-playground/locales v0.14.1 h1:EWaQ/wswjilfKLTECiXz7Rh+3BjFhfDFKv/oXslEjJA= +github.com/go-playground/locales v0.14.1/go.mod h1:hxrqLVvrK65+Rwrd5Fc6F2O76J/NuW9t0sjnWqG1slY= +github.com/go-playground/universal-translator v0.18.1 h1:Bcnm0ZwsGyWbCzImXv+pAJnYK9S473LQFuzCbDbfSFY= +github.com/go-playground/universal-translator v0.18.1/go.mod h1:xekY+UJKNuX9WP91TpwSH2VMlDf28Uj24BCp08ZFTUY= +github.com/go-playground/validator/v10 v10.30.1 h1:f3zDSN/zOma+w6+1Wswgd9fLkdwy06ntQJp0BBvFG0w= +github.com/go-playground/validator/v10 v10.30.1/go.mod h1:oSuBIQzuJxL//3MelwSLD5hc2Tu889bF0Idm9Dg26cM= +github.com/goccy/go-json v0.10.5 h1:Fq85nIqj+gXn/S5ahsiTlK3TmC85qgirsdTP/+DeaC4= +github.com/goccy/go-json v0.10.5/go.mod h1:oq7eo15ShAhp70Anwd5lgX2pLfOS3QCiwU/PULtXL6M= +github.com/goccy/go-yaml v1.19.2 h1:PmFC1S6h8ljIz6gMRBopkjP1TVT7xuwrButHID66PoM= +github.com/goccy/go-yaml v1.19.2/go.mod h1:XBurs7gK8ATbW4ZPGKgcbrY1Br56PdM69F7LkFRi1kA= +github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8= +github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU= +github.com/google/gofuzz v1.0.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg= +github.com/json-iterator/go v1.1.13-0.20220915233716-71ac16282d12 h1:9Nu54bhS/H/Kgo2/7xNSUuC5G28VR8ljfrLKU2G4IjU= +github.com/json-iterator/go v1.1.13-0.20220915233716-71ac16282d12/go.mod h1:TBzl5BIHNXfS9+C35ZyJaklL7mLDbgUkcgXzSLa8Tk0= +github.com/klauspost/cpuid/v2 v2.3.0 h1:S4CRMLnYUhGeDFDqkGriYKdfoFlDnMtqTiI/sFzhA9Y= +github.com/klauspost/cpuid/v2 v2.3.0/go.mod h1:hqwkgyIinND0mEev00jJYCxPNVRVXFQeu1XKlok6oO0= +github.com/leodido/go-urn v1.4.0 h1:WT9HwE9SGECu3lg4d/dIA+jxlljEa1/ffXKmRjqdmIQ= +github.com/leodido/go-urn v1.4.0/go.mod h1:bvxc+MVxLKB4z00jd1z+Dvzr47oO32F/QSNjSBOlFxI= +github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY= +github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y= +github.com/miekg/dns v1.1.72 h1:vhmr+TF2A3tuoGNkLDFK9zi36F2LS+hKTRW0Uf8kbzI= +github.com/miekg/dns v1.1.72/go.mod h1:+EuEPhdHOsfk6Wk5TT2CzssZdqkmFhf8r+aVyDEToIs= +github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q= +github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd h1:TRLaZ9cD/w8PVh93nsPXa1VrQ6jlwL5oN8l14QlcNfg= +github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q= +github.com/modern-go/reflect2 v1.0.2 h1:xBagoLtFs94CBntxluKeaWgTMpvLxC4ur3nMaC9Gz0M= +github.com/modern-go/reflect2 v1.0.2/go.mod h1:yWuevngMOJpCy52FWWMvUC8ws7m/LJsjYzDa0/r8luk= +github.com/pelletier/go-toml/v2 v2.2.4 h1:mye9XuhQ6gvn5h28+VilKrrPoQVanw5PMw/TB0t5Ec4= +github.com/pelletier/go-toml/v2 v2.2.4/go.mod h1:2gIqNv+qfxSVS7cM2xJQKtLSTLUE9V8t9Stt+h56mCY= +github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= +github.com/pmezard/go-difflib v1.0.1-0.20181226105442-5d4384ee4fb2 h1:Jamvg5psRIccs7FGNTlIRMkT8wgtp5eCXdBlqhYGL6U= +github.com/pmezard/go-difflib v1.0.1-0.20181226105442-5d4384ee4fb2/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= +github.com/quic-go/qpack v0.6.0 h1:g7W+BMYynC1LbYLSqRt8PBg5Tgwxn214ZZR34VIOjz8= +github.com/quic-go/qpack v0.6.0/go.mod h1:lUpLKChi8njB4ty2bFLX2x4gzDqXwUpaO1DP9qMDZII= +github.com/quic-go/quic-go v0.59.0 h1:OLJkp1Mlm/aS7dpKgTc6cnpynnD2Xg7C1pwL6vy/SAw= +github.com/quic-go/quic-go v0.59.0/go.mod h1:upnsH4Ju1YkqpLXC305eW3yDZ4NfnNbmQRCMWS58IKU= +github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME= +github.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw= +github.com/stretchr/objx v0.5.0/go.mod h1:Yh+to48EsGEfYuaHDzXPcE3xhTkx73EhmCGUpEOglKo= +github.com/stretchr/objx v0.5.2/go.mod h1:FRsXN1f5AsAjCGJKqEizvkpNtU+EGNCLh3NxZ/8L+MA= +github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg= +github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU= +github.com/stretchr/testify v1.8.4/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo= +github.com/stretchr/testify v1.10.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY= +github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U= +github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U= +github.com/twitchyliquid64/golang-asm v0.15.1 h1:SU5vSMR7hnwNxj24w34ZyCi/FmDZTkS4MhqMhdFk5YI= +github.com/twitchyliquid64/golang-asm v0.15.1/go.mod h1:a1lVb/DtPvCB8fslRZhAngC2+aY1QWCk3Cedj/Gdt08= +github.com/ugorji/go/codec v1.3.1 h1:waO7eEiFDwidsBN6agj1vJQ4AG7lh2yqXyOXqhgQuyY= +github.com/ugorji/go/codec v1.3.1/go.mod h1:pRBVtBSKl77K30Bv8R2P+cLSGaTtex6fsA2Wjqmfxj4= +go.mongodb.org/mongo-driver/v2 v2.5.0 h1:yXUhImUjjAInNcpTcAlPHiT7bIXhshCTL3jVBkF3xaE= +go.mongodb.org/mongo-driver/v2 v2.5.0/go.mod h1:yOI9kBsufol30iFsl1slpdq1I0eHPzybRWdyYUs8K/0= +go.uber.org/mock v0.6.0 h1:hyF9dfmbgIX5EfOdasqLsWD6xqpNZlXblLB/Dbnwv3Y= +go.uber.org/mock v0.6.0/go.mod h1:KiVJ4BqZJaMj4svdfmHM0AUx4NJYO8ZNpPnZn1Z+BBU= +golang.org/x/arch v0.24.0 h1:qlJ3M9upxvFfwRM51tTg3Yl+8CP9vCC1E7vlFpgv99Y= +golang.org/x/arch v0.24.0/go.mod h1:dNHoOeKiyja7GTvF9NJS1l3Z2yntpQNzgrjh1cU103A= +golang.org/x/crypto v0.49.0 h1:+Ng2ULVvLHnJ/ZFEq4KdcDd/cfjrrjjNSXNzxg0Y4U4= +golang.org/x/crypto v0.49.0/go.mod h1:ErX4dUh2UM+CFYiXZRTcMpEcN8b/1gxEuv3nODoYtCA= +golang.org/x/mod v0.33.0 h1:tHFzIWbBifEmbwtGz65eaWyGiGZatSrT9prnU8DbVL8= +golang.org/x/mod v0.33.0/go.mod h1:swjeQEj+6r7fODbD2cqrnje9PnziFuw4bmLbBZFrQ5w= +golang.org/x/net v0.51.0 h1:94R/GTO7mt3/4wIKpcR5gkGmRLOuE/2hNGeWq/GBIFo= +golang.org/x/net v0.51.0/go.mod h1:aamm+2QF5ogm02fjy5Bb7CQ0WMt1/WVM7FtyaTLlA9Y= +golang.org/x/sync v0.20.0 h1:e0PTpb7pjO8GAtTs2dQ6jYa5BWYlMuX047Dco/pItO4= +golang.org/x/sync v0.20.0/go.mod h1:9xrNwdLfx4jkKbNva9FpL6vEN7evnE43NNNJQ2LF3+0= +golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.42.0 h1:omrd2nAlyT5ESRdCLYdm3+fMfNFE/+Rf4bDIQImRJeo= +golang.org/x/sys v0.42.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw= +golang.org/x/text v0.35.0 h1:JOVx6vVDFokkpaq1AEptVzLTpDe9KGpj5tR4/X+ybL8= +golang.org/x/text v0.35.0/go.mod h1:khi/HExzZJ2pGnjenulevKNX1W67CUy0AsXcNubPGCA= +golang.org/x/tools v0.42.0 h1:uNgphsn75Tdz5Ji2q36v/nsFSfR/9BRFvqhGBaJGd5k= +golang.org/x/tools v0.42.0/go.mod h1:Ma6lCIwGZvHK6XtgbswSoWroEkhugApmsXyrUmBhfr0= +google.golang.org/protobuf v1.36.11 h1:fV6ZwhNocDyBLK0dj+fg8ektcVegBBuEolpbTQyBNVE= +google.golang.org/protobuf v1.36.11/go.mod h1:HTf+CrKn2C3g5S8VImy6tdcUvCska2kB7j23XfzDpco= +gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= +gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM= +gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA= +gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM= diff --git a/main.go b/main.go index 9360f60..436f5fc 100644 --- a/main.go +++ b/main.go @@ -4,8 +4,8 @@ import ( "flag" "log" - dummy "git.happydns.org/checker-dummy/checker" - "git.happydns.org/checker-sdk-go/checker/server" + dummy "git.happydns.org/happyDomain/checker-dummy/checker" + sdk "git.happydns.org/happyDomain/sdk/checker" ) // Version is the standalone binary's version. It defaults to "custom-build" @@ -23,8 +23,8 @@ func main() { // CheckerDefinition.Version. dummy.Version = Version - srv := server.New(dummy.Provider()) - if err := srv.ListenAndServe(*listenAddr); err != nil { + server := sdk.NewServer(dummy.Provider()) + if err := server.ListenAndServe(*listenAddr); err != nil { log.Fatalf("server error: %v", err) } } diff --git a/plugin/plugin.go b/plugin/plugin.go index cc6499e..48ac857 100644 --- a/plugin/plugin.go +++ b/plugin/plugin.go @@ -5,8 +5,8 @@ package main import ( - dummy "git.happydns.org/checker-dummy/checker" - sdk "git.happydns.org/checker-sdk-go/checker" + dummy "git.happydns.org/happyDomain/checker-dummy/checker" + "git.happydns.org/happyDomain/model" ) // Version is the plugin's version. It defaults to "custom-build" and is @@ -18,7 +18,7 @@ var Version = "custom-build" // NewCheckerPlugin is the symbol resolved by happyDomain when loading the // .so file. It returns the checker definition and the observation provider // that the host will register in its global registries. -func NewCheckerPlugin() (*sdk.CheckerDefinition, sdk.ObservationProvider, error) { +func NewCheckerPlugin() (*happydns.CheckerDefinition, happydns.ObservationProvider, error) { // Propagate the plugin's version to the checker package so it shows up // in CheckerDefinition.Version. dummy.Version = Version