Skip to content

Releases

Pebble v1.33.2-fips: Prometheus metric counter rename, plan validation fixes, and Go 1.27.3

Choose a tag to compare

@github-actions github-actions released this 21 Oct 18:23
7f34c1b

Pebble v1.33.2-fips is a FIPS-compatible release that brings in fixes and updates from upstream Pebble v1.33.1 and v1.33.2.

Breaking Changes

  • Prometheus metric counter names (_total suffix): Metric counters exposed at /v1/metrics now use the Prometheus/OpenMetrics standard _total suffix instead of _count (#1124). Existing queries, alerts, and dashboards should be updated:
    • pebble_service_start_count → pebble_service_start_total
    • pebble_check_success_count → pebble_check_success_total
    • pebble_check_failure_count → pebble_check_failure_total

Bug Fixes

  • Plan validation: Appending a layer that fails plan validation (such as with pebble add --inner) no longer mutates the live plan layers in place (#937).
  • Check period validation: Plan validation now rejects non-positive (zero or negative) check period and timeout values, preventing runtime panics (#1126).
  • Metrics type validation: Invalid or out-of-range metric types are now rejected with an error instead of causing formatting panics (#1118).
  • Terminal input flags: Set termios input flags (IMAXBEL, IUTF8, BRKINT, IXANY) on Iflag rather than Cflag when opening ptys in devpts, fixing UTF-8 multi-byte character deletion and input handling (#1115).
  • Service log prefix stripping: Handled closing brackets (]) within service names when stripping log line prefixes for task logs (#1129).
  • TLS identity certificates: Handled non-Ed25519 public keys in identity certificates gracefully without panicking (#1120).
  • CI release workflow: Added a fallback to cmd/version.go when cmd/VERSION is absent in release workflows (#1108).

Documentation & Maintenance

  • Updated Go toolchain to Go 1.27.3, addressing standard library security vulnerabilities (#1122, #1140).
  • Added a complete structured index to the documentation homepage (#1123).
  • Updated Rockcraft documentation links to the new URL (#1133).
  • Updated GitHub Actions and dependency versions (#1112, #1113).

v1.33.2: Update Go to 1.27.3

Choose a tag to compare

@github-actions github-actions released this 21 Oct 14:50
f5da947

Updated the Go toolchain to Go 1.27.3 (#1140) to address upstream standard library security vulnerabilities.

Full Changelog: v1.33.1...v1.33.2

v1.33.1: Standardised metric names, plan and PTY fixes, and Go 1.27.2

Choose a tag to compare

@github-actions github-actions released this 21 Oct 13:33
26a687d

Pebble's counter metrics have been updated to adhere to Prometheus and OpenMetrics naming conventions by replacing the _count suffix with _total (#1124). Counter metrics are now exposed as:

  • pebble_service_start_total (was pebble_service_start_count)
  • pebble_check_success_total (was pebble_check_success_count)
  • pebble_check_failure_total (was pebble_check_failure_count)

Note

This is a breaking change for metric consumers. Existing dashboards, alerts, and queries that refer to the previous *_count metric names should be updated to use *_total.

Plan state and check validation fixes:

  • Appending an inner or sub-directory layer (pebble add --inner) that fails plan validation now leaves the daemon's live plan unchanged (#937), preventing partial layer mutations from persisting after validation errors.
  • Plan check validation now rejects negative period and timeout duration values (#1126), preventing panics when invalid durations were passed to time.NewTicker.

Logging, PTY, TLS, and metrics fixes:

  • Service log prefix stripping in task failure logs now correctly handles service names containing ] characters (#1129).
  • In ptyutil.OpenPtyInDevpts, termios input flags (IMAXBEL, IUTF8, BRKINT, IXANY) are now set on Iflag rather than Cflag (#1115). This ensures multi-byte UTF-8 character erasure in cooked mode, proper SIGINT generation on break conditions, and output restart behaviour.
  • Fixed a panic in TLS identity certificate validation when checking certificates with non-Ed25519 public keys (#1120).
  • OpenTelemetryWriter.Write now validates metric types before emission and rejects invalid types with an error rather than panicking during formatting (#1118).

Build, documentation, and dependencies:

  • Updated the Go toolchain to Go 1.27.2 (#1122) to resolve upstream standard library security vulnerabilities.
  • Updated golang.org/x/sys and golang.org/x/term dependencies (#1112).
  • Added a complete index and table of contents to the documentation homepage (#1123) and updated Rockcraft documentation links (#1133).
  • The release workflow now falls back to reading cmd/version.go when cmd/VERSION is absent on older release branches (#1108).

Full Changelog: v1.33.0...v1.33.1

v1.33.0-fips: Outdated service notes and numerous fixes

Choose a tag to compare

@github-actions github-actions released this 28 Sep 13:57
edaf91f

Pebble v1.33.0-fips Release Notes

Pebble v1.33.0-fips is the FIPS-compliant release corresponding to upstream Pebble v1.33.0. This release introduces service status notes (outdated flag) in the CLI and API, replaces gorilla/mux with Go's standard library net/http.ServeMux for daemon routing, and delivers extensive stability, validation, and concurrency fixes.

v1.33.0: Outdated service notes and numerous fixes

Choose a tag to compare

@github-actions github-actions released this 28 Sep 07:55
50a939d

pebble services now displays a Notes column (modelled after snapd's convention) and supports the outdated note (#946). When a running service's plan configuration or workload definition has diverged from the active plan, pebble services displays outdated (or - when running the current plan). The daemon REST API and Go client also expose the corresponding outdated boolean field.

The daemon API routing has been refactored to replace gorilla/mux with the Go standard library net/http.ServeMux (#954), eliminating an external dependency while streamlining daemon routing.

Daemon shutdown ordering has been fixed by stopping the overlord before calling http.Server.Shutdown (#948). This eliminates a 1-second delay and spurious context deadline exceeded error on shutdown when exec commands or long-polling requests are in flight. Additionally, the process reaper now configures signal handling during Start to remove the race window where child exit signals could be missed (#933).

Several fixes and improvements have been made to service logging and metrics:

  • Service log ring buffers are now closed when a service process exits or is stopped during backoff (#925), unblocking log iterators and allocating fresh buffers on restart.
  • Existing log pullers and iterator positions are now preserved across plan updates, preventing lost log entries when modifying plan layers (#1081).
  • servicelog.RingBuffer and its iterators now safely prevent nil pointer dereference panics when iterators are closed during Next or Buffered calls (#1090), return io.ErrShortWrite on short writes in WriteTo (#1091), and reject negative lengths in Discard (#1092).
  • LastLines now preserves leading line indentation and internal whitespace rather than trimming it (#1089).
  • Prometheus and OpenMetrics exposition data is now validated and escaped, rejecting malformed names, invalid UTF-8, and unsupported control characters (#1075).

WebSockets, command execution, and PTY handling have been improved:

  • ReaderToChannel now supports cancellation on client disconnects from non-PTY exec streams, preventing leaked producer goroutines (#1099).
  • ExecReaderToChannel synchronizes channel closing and flushes pending buffered output on hangup (POLLHUP), avoiding channel send panics on slow consumers and dropped trailing output (#1093).
  • Task WebSocket endpoints now prioritize already-ready change errors over WebSocket upgrades, consistently returning internal task errors rather than 400 Bad Request responses (#1097).
  • Duplicate WebSocket connections for the same execution are now rejected and closed after upgrade (#1079).
  • ptyutil.SetSize now validates terminal dimensions to fit within uint16 bounds (#1088), and ptyutil.OpenPtyInDevpts handles Openat errors promptly while closing peer file descriptors on failure (#1087).
  • The deprecated github.com/pkg/term dependency has been replaced with golang.org/x/term (#951).

Plan validation and state handling have been hardened:

  • Plan validation now rejects Host headers in HTTP check configurations (#1078), non-finite (NaN/Inf) backoff-factor values (#1085), empty log-target names (#1086), service.name labels for OpenTelemetry log targets (#1082), and whitespace-only check commands (#1076).
  • State.Prune now marks the state modified when removing expired, obsolete, or trimmed notices so cleanups persist across restarts (#1083), and State.AddNotice copies user IDs and data maps to prevent state mutation after recording (#1084).
  • Identity.Validate now formats invalid-name errors with the supplied name rather than stale stored names (#1080).
  • cmdstate.Exec now validates that the command slice is non-empty (#1077).
  • Accepted Unix connections are now closed immediately if peer credential lookup fails (#1072), and POST /v1/services validates requested actions earlier (#1073).
  • SetAppID in the logger package is now synchronized under loggerLock to prevent data races with concurrent security logging (#1074).

Go client library updates:

  • Log streaming now returns an error on unterminated lines at EOF instead of silently dropping data (#1066).
  • Client methods (Health, Checks, ListFiles, Logs, FollowLogs) now safely accept nil option pointers (#1055).
  • File permission strings with extra octal bits outside 0777 are now rejected (#1062).
  • Removed redundant Decoder.More() check in DecodeResult (#1054).

Build and packaging changes:

  • Pebble now embeds cmd/VERSION via //go:embed instead of generating Go source files during builds (#1071).
  • Combined repeated -ldflags options in Snapcraft build overrides so -w and -s flags are both applied (#1102).
  • Documentation updates clarify pure-Go user and group resolution limitations on NSS-managed systems (#943) and improve discoverability of health check guides (#931).
  • Updated the Go toolchain to Go 1.27.1 (#953).

Full Changelog: v1.32.2...v1.33.0

v1.32.2-fips: FIPS release with Go 1.26.6, release automation, and CI improvements

Choose a tag to compare

@github-actions github-actions released this 10 Sep 00:02
3556e68

Pebble version v1.32.2-fips is a FIPS 140 release tracking upstream Pebble v1.32.2.

Changes

  • Merged upstream Pebble v1.32.2 into the fips branch.
  • Updated Go toolchain to 1.26.6 for FIPS builds.
  • Updated github.com/gorilla/websocket to 1.5.3 (#910).
  • Updated golang.org/x/sys, golang.org/x/term, and golang.org/x/net (#904, #915).

v1.32.2: Release workflow automation and Go 1.26.7 bump

Choose a tag to compare

@github-actions github-actions released this 08 Sep 08:04
bd70695

The release pipeline has been refactored to automate each stage of the release process, including version bumps, release notes generation, binary and snap builds, and FIPS branch synchronization (#928).

A basic workshop dev environment setup with Go and the Pi.dev agent harness has been added (#912).

This release also updates the Go toolchain to 1.26.7 (#923) and updates dependencies golang.org/x/sys and golang.org/x/term (#915).

Full Changelog: v1.32.1...v1.32.2

v1.32.1: use Go 1.26.5

Choose a tag to compare

@benhoyt benhoyt released this 21 Jul 21:28
e712a58

This release is a patch release that bumps the Go version to 1.26.5 to fix a CVE (GO-2026-5856), as well as bumping versions for other dependencies and build dependencies.

Full Changelog: v1.32.0...v1.32.1

v1.32.0-fips: Structured output for version and health, read-only filesystem fix

Choose a tag to compare

@hpidcock hpidcock released this 01 Jul 03:58
e031d99

Note

This is the FIPS version of the v1.32.0 release, and has identical changes to that release, but remains stripped of all cryptography code.

pebble version and pebble health now support --format json and --format yaml flags for machine-readable output (#880). When using a structured format, pebble health no longer exits with a non-zero code when health checks are failing — callers can inspect the structured output directly.

Two goroutine leaks have been fixed: one in CommandManager.Connect when a request context is cancelled (#869), and one in the HTTP client retry loop when a context cancellation and retry timer fire simultaneously (#876).

armhf builds have been restored and other architecture builds re-enabled in the release pipeline (#886). This release also updates the Go toolchain to 1.26.4 (#881).

Full Changelog: v1.31.0...v1.32.0

v1.32.0: Structured output for version and health, read-only filesystem fix

Choose a tag to compare

@hpidcock hpidcock released this 30 Jun 05:14
3ae1b1b

pebble version and pebble health now support --format json and --format yaml flags for machine-readable output (#880). When using a structured format, pebble health no longer exits with a non-zero code when health checks are failing — callers can inspect the structured output directly.

Pebble now emits authz_fail security audit events when a client certificate fails verification during identity lookup and MTLS pairing (#874).

Two goroutine leaks have been fixed: one in CommandManager.Connect when a request context is cancelled (#869), and one in the HTTP client retry loop when a context cancellation and retry timer fire simultaneously (#876).

pebble run previously always generated or loaded an identity key under $PEBBLE/identity, even when --https was not configured and the key would never be used — causing failures on read-only filesystems. The identity key is now only generated when HTTPS is enabled (#896).

armhf builds have been restored and other architecture builds re-enabled in the release pipeline (#886). This release also updates the Go toolchain to 1.26.4 (#881).

Full Changelog: v1.31.0...v1.32.0