Skip to content
CAI
Software that uses CAICheck a score

k3s-io/k3s

59.6

Adequate · 13 November 2026

30.2k

lines of production code

Go

primary language

6

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add Linux cgroup validation and systemd scope detection

The cgroups package now includes platform-specific implementations for Linux and Windows. On Linux, it validates that required cgroup controllers (cpuset, memory, cpu) are available for both v1 and v2 hierarchies, and detects if the process is running under a systemd \.scope\ unit to correctly set kubelet and runtime roots, ensuring proper CPU and memory accounting. On Windows, the package provides stub implementations that return empty results, reflecting that cgroup management is not applicable.

pkg/cgroups · high confidence

Add RPM packaging support for k3s

This change introduces the initial RPM packaging infrastructure for k3s, including the \k3s.spec\ file for building the package, the \install.sh\ script used during the RPM post-install phase to configure systemd services, and the \repo-setup.sh\ script to configure the Rancher YUM repository. Users on RPM-based distributions can now install k3s via standard package managers, with the installer automatically setting up server and agent systemd units and handling environment variable configuration.

package/rpm · high confidence

Add cri-dockerd backend support for Docker runtime

This change introduces a new \pkg/agent/cridockerd\ package that allows K3s to use \cri-dockerd\ as a backend when the \--docker\ flag is specified. The implementation includes platform-specific configuration setup (Linux/Windows), argument generation for the \cri-dockerd\ process (handling CNI, dual-stack, and logging options), and a build-time toggle (\no\_cri\_dockerd\) to disable the feature entirely. Users can now run K3s with Docker as the container runtime via the cri-dockerd shim.

pkg/agent/cridockerd · high confidence

Add crictl CLI wrapper for container runtime inspection

A new CLI command is introduced that wraps the standard crictl tool, allowing users to inspect and debug container runtimes directly from the K3s interface. The implementation includes a specific adjustment for Windows environments to ensure argument handling is compatible with the underlying crictl binary.

pkg/cli/crictl · high confidence

Add logr-to-Logrus adapter for structured logging

Introduces a new \pkg/util/logger\ package that implements the \logr.LogSink\ interface using \logrus\ as the backend. This allows the application to use the standard \logr\ API for structured logging while retaining \logrus\'s underlying formatting and level handling capabilities, including context-aware logger injection via \NewContext\.

pkg/util/logger · high confidence

Add password file-based authentication support

Users can now authenticate against the API server using a CSV password file. The new \pkg/authenticator/passwordfile\ package provides a \PasswordAuthenticator\ that reads user credentials (password, username, UID, and optional groups) from a CSV file and verifies passwords using constant-time comparison to prevent timing attacks.

pkg/authenticator/passwordfile · high confidence

Add shell completion support for Bash and Zsh

Users can now generate shell completion scripts for Bash and Zsh using the new completion command. The implementation, built on Urfave CLI v2, allows users to print the completion script to stdout or automatically append the necessary source lines to their shell configuration files (.bashrc or .zshrc) using the -i flag, enabling tab-completion for k3s commands.

pkg/cli/completion · high confidence

Add support for \`k3s token\` command

Users can now generate and manage bootstrap tokens via a new \k3s token\ CLI command. This feature introduces internal types and utilities for handling kubeadm-compatible bootstrap tokens, including generation, validation, and conversion to Kubernetes Secrets, while avoiding external dependencies to keep the binary size small.

pkg/kubeadm · high confidence

Add support for \`k3s token\` command

Users can now manage Kubernetes bootstrap tokens directly via the CLI using the new \k3s token\ subcommand. This feature provides commands to create, delete, generate, list, and rotate bootstrap tokens, facilitating node joining and server authentication management without manual API interactions.

pkg/cli/token · high confidence

Add support for disabling staged static content

Users can now opt out of the automatic extraction of static assets to the filesystem by building with the \no\_stage\ build tag. When this tag is active, the \Stage\ function becomes a no-op, preventing static files from being written to disk; by default, the system continues to stage these assets as before.

pkg/static · high confidence

Added basic authentication support via CSV file

Users can now authenticate using the --basic-auth-file flag by providing a CSV file containing username and password pairs. This change introduces the basicauth package, which implements the HTTP Basic Authentication protocol by validating credentials against the provided file and integrating with the existing authenticator chain.

pkg/authenticator/basicauth · high confidence

Added data directory file verification

A new \dataverify\ package has been introduced to validate the integrity of files within a data directory. It checks SHA256 checksums against a \.sha256sums\ manifest and verifies symbolic links against a \.links\ manifest, ensuring that file contents and link targets match expected values.

pkg/dataverify · high confidence

Added file locking support via pkg/flock

The new pkg/flock package provides cross-platform file locking capabilities, enabling exclusive and shared locks on Unix-like systems (Linux, macOS, FreeBSD, etc.) while providing stub implementations for non-Unix platforms. This allows components relying on file-based coordination to function consistently across different operating systems.

pkg/flock · high confidence

Added gotests templates for Go unit test generation

New template files (call, function, header, inline, inputs, message, results) have been added to the contrib/gotests\_templates directory. These templates provide the structure for generating Go unit tests, including handling function signatures, parameters, return values, and test case definitions.

_contrib/gotests\templates · high confidence

Added graceful shutdown signal handling

A new \pkg/signals\ package has been introduced to manage application lifecycle via OS signals. On POSIX systems, the application now listens for SIGINT and SIGTERM, cancelling a context on the first signal and exiting with code 1 if a second signal is received. On Windows, it handles the interrupt signal. The package also provides a \RequestShutdown\ function to programmatically trigger this shutdown sequence.

pkg/signals · high confidence

Agent load balancer now persists state and supports HTTP/HTTPS proxies

The agent's local load balancer now persists its server list and default server selection to a JSON configuration file, ensuring that the load balancer restores its previous state after a restart rather than starting with an empty server list. Additionally, the load balancer can now route connections through HTTP or SOCKS5 proxies when the agent is configured to allow it, enabling operation in network environments that require proxying for API server communication.

pkg/agent/loadbalancer · high confidence

Automated staging dependency updates via Updatecli scripts

Added shell scripts to automate the detection and updating of Kubernetes staging dependencies in go.mod. The bump-staging-deps.sh script identifies staging modules pointing to the k3s-io/kubernetes fork, finds the latest available -k3sN tag for the target base version, and updates go.mod accordingly, while check-staging-tags-ready.sh validates that required tags exist before updates proceed. These scripts enable Updatecli to automatically keep staging dependencies in sync across release branches.

updatecli/scripts · high confidence

Centralized metrics registration and HTTP endpoint setup

The metrics subsystem now provides a unified entry point that automatically registers metrics from the load balancer, etcd snapshots, remotedialer, and lasso libraries into the common Kubernetes legacy registry. A new Start method binds the standard Prometheus /metrics HTTP handler to the node's router, ensuring these internal components are exposed for monitoring without requiring manual wiring by consumers.

pkg/metrics · high confidence

Certificate expiration monitoring and event reporting

The certmonitor package now actively checks node and CA certificates for expiration, emitting Kubernetes events to warn users when certificates are expiring or have expired, and emitting an OK event on startup if no issues are found. It also exposes Prometheus metrics for remaining certificate lifetime.

pkg/certmonitor · high confidence

Flannel agent initialization and configuration rewritten for dual-stack and multi-backend support

The flannel agent package has been restructured to support dual-stack networking (IPv4/IPv6), multiple backends (VXLAN, host-gw, wireguard-native, ipsec, extension/tailscale), and Windows platforms. The new implementation introduces a \netMode\ type to explicitly handle IPv4, IPv6, and dual-stack configurations, ensuring correct interface selection and masquerading rules for both address families. It now generates platform-specific CNI configurations (Linux vs. Windows) and uses atomic file writing on non-Windows systems. The agent also handles RBAC fallback for node listing and waits for PodCIDR assignment before starting the flannel backend, improving reliability in environments with restricted permissions.

pkg/agent/flannel · high confidence

Initial agent configuration and platform-specific setup logic

The agent configuration subsystem has been introduced to centralize how node settings are retrieved from the server and applied locally. This change adds logic to fetch and cache agent configuration with jittered retries, validates resolv.conf entries, and handles node identity authentication via headers. It also introduces platform-specific configuration hooks for Linux and Windows, managing containerd paths, snapshotter validation (overlayfs, fuse-overlayfs, stargz, nix), and QoS-class resource configuration files (BlockIO, RDT) on Linux, while setting up Windows-specific containerd and ACL configurations.

pkg/agent/config · high confidence

Initial repository structure and documentation for k3s

The repository has been initialized with the foundational structure for the k3s project. This includes the primary build configuration (Dockerfile, Dockerfile.manifest, Dockerfile.test), the official installation script (install.sh) and its checksum, and the channel versioning configuration (channel.yaml). Essential project documentation has been added, including BUILDING.md for source compilation, CONTRIBUTING.md with AI usage guidelines, GOVERNANCE.md, CODE\_OF\_CONDUCT.md, and ADOPTERS.md. The repository also establishes community and compliance standards through CODEOWNERS, DCO, and .clomonitor.yml, alongside a docker-compose.yml for local development and a systemd unit file for rootless operation.

(repo-wide) · high confidence

Initial server CLI implementation and configuration wiring

The server command-line interface is now implemented in pkg/cli/server/server.go, establishing the entry point for starting the K3s server. This change introduces the core logic to parse CLI flags, configure the server's datastore (including etcd and S3 options), manage TLS settings, and handle rootless execution. It also wires up the configuration for various control components, such as the API server, scheduler, and controller manager, and integrates with the new signal handling and process title concealment mechanisms.

pkg/cli/server · high confidence

Initial support for Tailscale VPN integration

Added a new VPN package that enables Tailscale integration for node connectivity. The implementation allows configuring a custom control server URL and passing extra CLI flags to the Tailscale binary. It includes logic to detect if Tailscale is already running to avoid redundant startup commands, retrieves node IP addresses (IPv4/IPv6) and backend state, and exposes VPN information through the executor interface.

pkg/vpn · high confidence

Introduce CLI wrapper for containerd client

A new entry point file has been added to the CLI package to serve as a bridge between the urfave/cli v2 framework and the underlying containerd client logic. This change enables the 'ctr' command to be executed within the k3s server context by delegating execution to the existing ctr.Main function, effectively exposing the containerd client capabilities through the unified CLI interface.

pkg/cli/ctr · high confidence

Introduce airgap image list generation and local-path validation

The airgap support now includes a \generate-list.sh\ script that automatically extracts the container images used by the current K3s runtime via \crictl\, populating \image-list.txt\ with the latest versions of core components (such as Traefik 3.7.13, CoreDNS 1.14.7, and klipper-helm v0.13.3). Additionally, a \volume-test.yaml\ manifest is provided to validate that the local-path provisioner and storage classes function correctly in air-gapped environments using these mirrored images.

scripts/airgap · high confidence

Introduce bootstrap data reconciliation between datastore and disk

The pkg/bootstrap package now provides functions to read bootstrap data (certificates and keys) from disk into a JSON format and write it back to disk from a storage source, enabling reconciliation of bootstrap state between the datastore and local files. This includes logic to handle file paths, timestamps, and content, along with tests for the underlying object-to-map conversion utility.

pkg/bootstrap · high confidence

Introduce new passwd package for user and role management

A new \pkg/passwd\ package has been added to handle the reading, writing, and validation of the node-passwd file. This component manages user entries by storing passwords and roles, ensuring that records contain at least two columns (password and name) and supporting up to four columns (including role). It handles user creation by generating random tokens when no password is provided, strips K10 token prefixes from existing credentials, and writes updates atomically using a temporary file to prevent data corruption.

pkg/passwd · high confidence

Introduce rootless mode for non-Windows platforms

Users can now run k3s without root privileges on Linux by leveraging RootlessKit. This change adds the \pkg/rootless\ package, which implements the parent/child process orchestration, network namespace isolation (including optional IPv6 support), and port forwarding via a configurable port driver (defaulting to the built-in driver). It also handles necessary mount setup, such as bind-mounting user-specific directories over system paths like \/var/lib/cni\ and \/var/lib/kubelet\, and validates required kernel sysctls before starting.

pkg/rootless · high confidence

Introduces local load-balancing proxy for supervisor and API server connections

The agent now optionally runs a local load-balancer to manage connections to the supervisor and API server. When enabled, the proxy intercepts requests and routes them through a local load-balancer instance (listening on a specific port) rather than connecting directly to the backend addresses. This allows for features like health checking, address updates, and fallback handling (e.g., switching from a local supervisor to an API server node) to be managed transparently by the proxy layer, improving reliability and flexibility in cluster networking.

pkg/agent/proxy · high confidence

Introduction of internal network proxy component

A new proxy implementation has been added to the control plane to handle bidirectional data piping between local and remote connections. This component manages connection lifecycle and error reporting, specifically filtering out EOF errors while logging other proxy errors, and utilizes the project's internal error handling utilities for context wrapping.

pkg/daemons/control/proxy · high confidence

New certificate management commands for checking and rotating CA certificates

The \pkg/cli/cert\ package introduces new CLI commands (\k3s certificate check\ and \k3s certificate rotate-ca\) that allow users to inspect the status of cluster certificates and update CA certificates in the datastore. The \check\ command supports multiple output formats (text, table, JSON, YAML) and provides warnings for certificates expiring within the configured renewal window, helping users proactively manage certificate lifecycle.

pkg/cli/cert · high confidence

New deploy controller with manifest staging and file watching

The \pkg/deploy\ package now implements a new controller that stages embedded manifests into the data directory and watches for file changes to apply them to the cluster. It supports templating variables during staging, respects \.skip\ files and disable flags, and handles symlinked directories by preserving logical paths. The controller also includes logic to detect content changes via checksums even when modification times are pinned (e.g., on immutable filesystems like NixOS), and ensures resources are removed when disabled or deleted from manifests.

pkg/deploy · high confidence

New diagnostic and certificate management utilities

Added new scripts in contrib/util to simplify cluster maintenance and troubleshooting. The diagnostics suite (diagnostics.sh, fetch-diags.sh, and DIAGNOSTICS.md) provides a secure method to gather, encrypt, and upload system logs for remote analysis, supporting various gather/upload modes and decryption workflows. Additionally, new certificate management scripts (generate-custom-ca-certs.sh and rotate-default-ca-certs.sh) allow users to bootstrap custom CA certificates or rotate existing self-signed CAs, including cross-signing logic to maintain trust during rotation.

contrib/util · high confidence

New file and string utility functions in agent util package

The agent utility package now includes new helper functions for file and string operations. A new file.go module provides WriteFile and CopyFile utilities, with CopyFile supporting an option to ignore non-existent source files, and both functions using the internal error wrapper for context. Additionally, a new strings.go module adds HasSuffixI, a case-insensitive suffix checking function that accepts multiple suffixes.

pkg/agent/util · high confidence

New k3s Cloud Provider implementation with ServiceLB and InstancesV2 support

The k3s cloud provider has been implemented as a new module in \pkg/cloudprovider\, replacing the previous standalone ServiceLB controller. This change introduces a unified \cloudprovider.Interface\ that integrates LoadBalancer management (via \servicelb.go\) and node instance metadata (via \instances.go\) into a single provider. Users benefit from a standardized Kubernetes cloud-provider interface, enabling \InstancesV2\ support for node address pass-through (internal/external IP and DNS) and a configurable ServiceLB controller that manages DaemonSets for load balancing services. The provider is configurable via JSON (enabling/disabling LB or node features, setting priority classes, images, and namespaces) and includes support for dual-stack IP filtering and node pool affinity for load balancers.

pkg/cloudprovider · high confidence

New k3s-integrated ctr binary with default socket and namespace

A new entry point in pkg/ctr/main.go builds a containerd v2 ctr client that automatically connects to the k3s containerd socket (/run/k3s/containerd/containerd.sock) and uses the k8s.io namespace, removing the need for users to specify these flags manually when interacting with k3s.

pkg/ctr · high confidence

New managed etcd controllers and snapshot metrics

The embedded etcd package now includes dedicated controllers to manage cluster membership, API server addresses, and node metadata, alongside a new metrics package for snapshot operations. The \apiaddresses\_controller\ watches Kubernetes EndpointSlices to keep etcd informed of current API server addresses, while the \member\_controller\ handles the removal of etcd members from the cluster based on node annotations or deletion events. The \metadata\_controller\ ensures node labels and annotations are correctly synchronized with the etcd member state and clears removal flags after a cluster reset. Additionally, the \snapshotmetrics\ package introduces Prometheus histograms to track the duration of snapshot save, prune, and reconcile operations, providing visibility into backup performance.

pkg/etcd · high confidence

New proctitle package for setting process titles

A new \pkg/proctitle\ package has been added to allow setting the process title. On Linux, it utilizes the \github.com/erikdubbelboer/gspt\ library to update the process name, while on Windows, it provides a no-op implementation to ensure cross-platform compatibility.

pkg/proctitle · high confidence

New service certificate file mapping utility

A new \pkg/util/services\ package has been added to provide a centralized mapping of certificate and key file paths for all K3s server and agent services. The \FilesForServices\ function returns the specific TLS assets (certificates and keys) associated with services such as the API server, controller manager, scheduler, etcd, kubelet, and supervisor, enabling other components to accurately identify which files require rotation or management.

pkg/util/services · high confidence

New utility package for API readiness, RBAC checks, and argument handling

This change introduces a new \pkg/util\ package that consolidates several core utilities. It adds \WaitForAPIServerReady\ and \APIServerReadyChan\ to block startup until the API server is ready, specifically checking the \/readyz\ endpoint (excluding \kms-providers\) and ensuring re-dials through the load balancer. It includes \WaitForRBACReady\ and \CheckRBAC\ to poll for RBAC permissions before starting controllers. The package also provides \GetArgs\ for managing CLI argument overrides with prefix/suffix support, \SendError\ for structured HTTP error responses, and various helpers for IP address parsing, certificate status checking, and token management.

pkg/util · high confidence

Node configuration and secrets are now stored as redacted annotations

The system now records the node's CLI arguments and environment variables as annotations on the Kubernetes Node object, enabling other components to detect configuration changes via a computed hash. To protect sensitive data, values for flags and environment variables containing tokens, datastore endpoints, or AWS keys are automatically redacted with asterisks in these annotations.

pkg/nodeconfig · high confidence

Rootless port management for Kubernetes services

A new rootlessports package has been added to manage port bindings when running in a rootless environment. On Linux, the controller registers with the rootlesskit API to automatically bind service ports (including TCP/UDP and LoadBalancer nodePorts) from the host into the child namespace, ensuring services remain accessible. On Windows, the feature is stubbed out with a panic, indicating it is not yet supported on that platform.

pkg/rootlessports · high confidence

Support for etcd S3 configuration via Kubernetes Secret

Users can now store etcd S3 backup credentials and settings in a Kubernetes Secret (referenced by the new \etcd-s3-config-secret\ flag) instead of passing them via CLI arguments or config files. The system reads keys such as access/secret keys, bucket name, endpoint, region, retention, timeout, SSL verification, and CA bundles from this Secret, allowing for more secure and centralized management of S3 snapshot configuration.

pkg/etcd/s3 · high confidence

Removals

Removal of Kubernetes ListenerConfig storage backend

The \pkg/tls/storage.go\ file has been deleted, removing the implementation that stored TLS listener configuration in a Kubernetes \ListenerConfig\ resource within the \kube-system\ namespace. This eliminates the dependency on the \v1.ListenerConfigClient\ and the associated cache-based synchronization logic for managing server certificates via this specific Kubernetes custom resource.

pkg/tls · high confidence

Removal of k3s.cattle.io/v1 ListenerConfig API types

The \ListenerConfig\ custom resource type and all associated generated code (including schema definitions, deep-copy functions, Kubernetes client interfaces, controllers, and lifecycle adapters) for the \k3s.cattle.io/v1\ API group have been removed. This eliminates the ability to manage listener configurations via this specific API version within the types/apis layer.

types/apis · high confidence

Removal of legacy K3s agent and CLI components

The agent subsystem and its associated CLI commands have been removed from the codebase. This includes the deletion of the agent entry point (\agent/main.go\), configuration handling (\agent/config/config.go\), and the specific daemons it managed: containerd initialization (\agent/containerd/containerd.go\), flannel networking setup (\agent/flannel/flannel.go\, \agent/flannel/setup.go\), TLS proxying (\agent/proxy/proxy.go\), system setup (\agent/syssetup/setup.go\), and tunnel connectivity (\agent/tunnel/tunnel.go\). The CLI commands for launching the agent (\cli/cmd/agent/\) and the server (\cli/cmd/server/server.go\) have also been deleted, along with the image build scripts (\image/Dockerfile\, \image/build\, \image/init\) and utility packages (\pkg/enterchroot\, \pkg/controller/tls\) that supported this legacy runtime. Users will no longer be able to run or manage the K3s agent or server through these removed components.

(repo-wide) · high confidence

Removal of legacy code generation entry point

The main entry point for the legacy code generation process (types/codegen/main.go) has been removed. This file previously invoked the Norman generator to produce types based on the v1 Schemas from the k3s.cattle.io API. Its deletion indicates that this specific code generation step is no longer part of the build or runtime pipeline.

types/codegen · high confidence

Removal of version package

The version package containing the Version and GitCommit variables has been removed from the codebase, meaning the application no longer exposes build-time version information through this module.

version · high confidence

Architecture

Embedded executor logic moved to dedicated package

The code responsible for running the embedded Kubernetes components (API server, controller manager, scheduler, kubelet, etcd, flannel, and VPN) has been extracted from the main executor package into a new \pkg/executor/embed\ package. This refactoring isolates the embedded execution logic, including platform-specific handling for Linux and Windows, into its own module while maintaining the same executor interface.

pkg/executor · high confidence

Behavioural changes

Add etcd snapshot metrics

A new metrics utility function \ObserveWithStatus\ has been added to \pkg/util/metrics/metrics.go\. This helper observes histogram durations and automatically appends a 'success' or 'error' label based on the provided error status, enabling users to track etcd snapshot performance and failure rates via Prometheus.

pkg/util/metrics · high confidence

Agent now configures kernel modules and sysctls for networking and conntrack

The agent now automatically loads required kernel modules (such as nf\_conntrack, br\_netfilter, and iptables variants) and configures critical network sysctls (including IP forwarding and conntrack timeouts) on startup. This ensures the host environment is correctly prepared for Kubernetes networking components like kube-proxy and CNI plugins, with specific support for dual-stack IPv6 and configurable conntrack parameters.

pkg/agent/syssetup · high confidence

Agent startup logic restructured with platform-specific CRI configuration

The agent's initialization flow has been refactored into a new \run.go\ entry point that validates dual-stack IP configurations, configures sysctls, and manages the startup sequence for the container runtime, embedded registry, and networking components. Platform-specific logic for generating the \crictl.yaml\ configuration file has been extracted into \run\_linux.go\ and \run\_windows.go\ to handle differences in socket paths (Unix sockets vs. named pipes) and runtime endpoints. A new unit test file \run\_test.go\ has been added to verify the parsing of kube-proxy conntrack configuration arguments.

pkg/agent · high confidence

Agent switches to kubelet config files and adds OS-specific agent implementations

The agent daemon now generates structured kubelet configuration files (drop-ins) instead of relying solely on CLI arguments, allowing for more robust configuration management and support for user-provided config files via --kubelet-arg. This change introduces platform-specific agent modules (agent\_linux.go and agent\_windows.go) that handle OS-specific kubelet and kube-proxy argument generation, including rootless support on Linux and kernel-space proxy mode on Windows. The core agent logic has been refactored to use a context-based startup sequence, waiting for CRI readiness before starting kubelet and handling proxy startup independently.

pkg/daemons/agent · high confidence

Agent tunnel now supports IPv6 and configurable kubelet ports

The agent tunnel implementation has been updated to correctly handle IPv6 addresses when building proxy connections, ensuring connectivity on IPv6-only or dual-stack networks. Additionally, the tunnel now respects custom kubelet port configurations, allowing agents to properly route traffic to the kubelet even when it is bound to a non-standard port. These changes improve reliability and compatibility in diverse network environments.

pkg/agent/tunnel · high confidence

CLI restructured with Urfave CLI v2 and new management commands

The command-line interface has been rewritten to use the Urfave CLI v2 framework, introducing a new command structure with dedicated subcommands for managing certificates (\k3s certificate\), etcd snapshots (\k3s etcd-snapshot\), secrets encryption (\k3s secrets-encrypt\), and tokens (\k3s token\). This change also adds new capabilities such as shell completion (\k3s completion\), direct access to \crictl\ and \ctr\, and a \check-config\ utility, while consolidating agent and server configuration flags into structured types for better maintainability.

pkg/cli/cmds · high confidence

CLI secrets-encrypt commands now use JSON output and ptr library

The \k3s secrets-encrypt status\ command now supports a \--json\ flag to output the encryption state in machine-readable JSON format, in addition to the existing human-readable table. The implementation has been updated to use the \k8s.io/utils/ptr\ package for pointer creation instead of deprecated or external libraries, and the CLI now communicates with the server via the \/v1-{version}/encrypt/config\ endpoint using structured \handlers.EncryptionRequest\ objects for enable, disable, prepare, and rotate actions.

pkg/cli/secretsencrypt · high confidence

Centralized certificate path management and strict kubeconfig permissions

The control-plane dependency initialization logic has been consolidated into a new \pkg/daemons/control/deps\ package, which now explicitly defines the file paths for all cluster certificates (including dedicated paths for kube-scheduler and kube-controller-manager) and kubeconfig files. As part of this restructuring, kubeconfig files are now generated with strict 0600 permissions to comply with CIS 1.24 security benchmarks, and legacy certificate cleanup is integrated into the bootstrap process.

pkg/daemons/control/deps · high confidence

Centralized data directory configuration with rootless support

The pkg/datadir package now centralizes the definition of default data and configuration paths, using the program name variable to construct paths like /var/lib/rancher/\<program\> for global data and ${HOME}/.rancher/\<program\> for user-specific data. This change introduces rootless support by checking for privileged status: if the process is not privileged, it defaults to the home directory-based data path, whereas privileged processes use the system-wide /var/lib/rancher path. Configuration files are similarly split between ${HOME}/.kube/\<program\>.yaml for local use and /etc/rancher/\<program\>/\<program\>.yaml for global settings, ensuring that non-root users do not write to system directories.

pkg/datadir · high confidence

Containerd agent refactored for v2 with cross-platform support and runtime discovery

The containerd agent implementation has been rewritten to support containerd v2, introducing platform-specific configuration generation for Linux and Windows. On Linux, the agent now automatically discovers and configures additional container runtimes including crun, nvidia-container-runtime, and various WASM shims (lunatic, wasmtime, etc.) by scanning the PATH. It also supports SELinux detection and rootless mode with cgroup v2. Image preloading behavior has changed to use permanent labels instead of leases, and registry host configurations are now managed via a dedicated hosts.toml template system that cleans up unmanaged directories. Windows support includes specific handling for path separators in registry hosts and disabled features like overlayfs and SELinux.

pkg/agent/containerd · high confidence

Dynamic TLS certificate SAN filtering and bootstrap data encryption

The cluster's HTTPS listener now dynamically filters the Subject Alternative Names (SANs) on its TLS certificates based on the current set of control-plane and etcd node addresses, preventing unauthorized hosts from appearing in certificates. Additionally, bootstrap data (such as CA certificates and keys) is now encrypted in the datastore using a key derived from the join token, ensuring that sensitive cluster secrets are not stored in plaintext.

pkg/cluster · high confidence

Embedded containerd upgraded to v2 with expanded snapshotter support

The embedded containerd runtime has been upgraded to v2, introducing a new multi-call binary structure that registers core services and the CRI plugin by default. This update enables several new storage snapshotter plugins—specifically fuse-overlayfs (primarily for rootless mode), btrfs, devmapper, zfs, and nix-snapshotter—allowing users to leverage these filesystems for container storage. Additionally, Windows support has been enhanced with specific LCOW and Windows snapshotter plugins, while platform-specific utility checks now correctly report support status for overlay, fuse-overlayfs, stargz, and nix snapshotters on both Linux and Windows.

pkg/containerd · high confidence

Improved kubeconfig handling and permission checks in kubectl wrapper

The kubectl wrapper now correctly respects the --kubeconfig command-line flag, ensuring the KUBECONFIG environment variable is set from the argument even when not explicitly exported. Additionally, it performs a permission check on the kubeconfig file at startup; if the file is not readable by the current user, it issues a warning suggesting the use of --write-kubeconfig-mode or --write-kubeconfig-group to fix permissions. The implementation also removes deprecated random seeding and updates imports to use standard kubectl command execution paths.

pkg/kubectl · high confidence

Introduce configurable program name and version variables

The version package now exposes variables for the program name (defaulting to 'k3s'), version, and git commit, allowing the program name to be customized at compile time rather than being hardcoded.

pkg/version · high confidence

Introduce request-based etcd snapshot CLI commands

The etcd snapshot CLI commands (save, delete, list) now operate by sending JSON requests to the server's /db/snapshot endpoint instead of executing local etcd processes. This change introduces a client-side timeout mechanism that automatically extends when S3 snapshots are configured, ensuring S3 operations complete without premature client-side timeouts. Users benefit from more consistent error handling, where timeout errors are wrapped to guide investigation to server logs, and the CLI now supports S3-specific configuration options like bucket lookup types and insecure connections directly through the command setup.

pkg/cli/etcdsnapshot · high confidence

Introduces pluggable executor interface for Kubernetes component lifecycle

The daemon now uses a pluggable executor interface to manage the lifecycle of Kubernetes components (such as the API server, scheduler, and controller manager) and container runtimes. This change allows different execution modes (e.g., embedded vs. external) to be swapped by implementing the new Executor interface, providing a unified way to bootstrap, start, and monitor these services while ensuring proper context handling and readiness signaling.

pkg/daemons/executor · high confidence

Introduction of scrypt-based password hashing

The authentication system now uses the scrypt algorithm for hashing passwords, replacing any previous implementation. This change introduces a new hashing interface and a concrete scrypt implementation with configurable parameters (N, R, P, key length, salt length) and a defined format version, ensuring secure, salted hashing with constant-time comparison to prevent timing attacks. Users relying on password authentication will now have their credentials hashed using this stronger, memory-hard algorithm.

pkg/authenticator/hash · high confidence

K3s CLI restructured into multi-call binary with dedicated subcommand binaries

The K3s command-line interface has been refactored from a single monolithic entry point into a multi-call binary (\cmd/k3s/main.go\) that dispatches to specialized standalone binaries for each major function (agent, server, cert, token, etcd-snapshot, secrets-encrypt, completion, kubectl, crictl, ctr, containerd). This change introduces the \prefer-bundled-bin\ experimental flag to control binary resolution, adds a \k3s completion\ command for shell integration, and standardizes error handling by prefixing fatal errors with "Error: ".

cmd · high confidence

Major refactoring of daemon configuration types and addition of new configuration fields

The configuration structures in \pkg/daemons/config/types.go\ have been significantly expanded and reorganized to support new features and improved modularity. The \Node\ struct now includes dedicated fields for container runtime endpoints (\ContainerRuntimeEndpoint\, \ImageServiceEndpoint\), PProf and metrics toggles, and specific configurations for Containerd and CRIDockerd. New structs \EtcdS3\ and \CRIDockerd\ have been added to handle S3 backup settings and CRI-Dockerd specifics. The \Agent\ struct has been enriched with support for dual-stack networking (multiple CIDRs and IPs), DNS settings, image credential providers, and network policy controls. Additionally, constants for Egress Selector modes and certificate renewal periods have been introduced, and the \CriticalControlArgs\ struct now explicitly defines CLI tags for cluster DNS and CIDR validation.

pkg/daemons/config · high confidence

Network policy controller now waits for node readiness and external cloud provider taint removal before starting

The network policy controller in the agent now explicitly waits for the node object to reach the Ready condition and for the \cloud-provider\ external taint to be removed before initializing. This prevents startup failures or crashes when the node is still initializing or tainted, ensuring the controller only runs once the node is fully prepared to handle network policies. On Windows, the controller is skipped with a warning as it is not supported.

pkg/agent/netpol · high confidence

New HTTPS agent listener with centralized routing and auth

The agent now uses a new centralized HTTPS listener and router (pkg/agent/https) to handle incoming requests. This change introduces a singleton router that applies authentication and authorization filters (RequestInfo and Delegated auth) to all requests. It supports both initial listener setup (using the supervisor port and agent TLS certificates) and wrapping existing handlers, ensuring consistent security policies across agent endpoints.

pkg/agent/https · high confidence

New centralized authentication and authorization middleware

The server now uses a new \auth\ package to handle HTTP request validation, introducing middleware functions for role-based access control (\HasRole\), local-or-role bypass (\IsLocalOrHasRole\), and delegated Kubernetes authentication/authorization via client certificates and SubjectAccessReview (\Delegated\). This change also integrates core Kubernetes filters for request info resolution and concurrent request limiting (\MaxInFlight\), replacing previous ad-hoc or external routing logic with a standardized, secure middleware chain.

pkg/server/auth · high confidence

New containerd configuration templates with v2 and v3 schema support

The agent now uses new Go-based templates to generate containerd configuration files, supporting both version 2 and version 3 schemas. These templates introduce several behavioral changes: unprivileged ports and ICMP are enabled by default, SELinux support is configurable, and the pause image is now customizable via the agent configuration. The templates also consolidate Linux and Windows handling, with platform-specific logic for address formatting (e.g., handling Windows named pipes). Additional features include support for stargz and nix snapshotters, runtime classes for crun/wasm/nvidia, and improved registry configuration handling with proper quoting and identity token support.

pkg/agent/templates · high confidence

New independent config file argument parser

The \pkg/configfilearg\ package now provides a standalone configuration file parser that operates independently of the main CLI framework. This new parser handles reading configuration from YAML files and \.d\ drop-in directories, supports appending to slice values via the \+\ suffix, and intelligently strips flags that are invalid for the current subcommand (e.g., server-specific flags in \etcd-snapshot\). It also introduces logic to respect override flags like \--help\ and \--version\ while allowing wrapped commands (like \kubectl\) to bypass config loading failures, ensuring more robust and predictable configuration behavior for users.

pkg/configfilearg · high confidence

New local and remote etcd store implementations with improved bootstrap resilience

The \pkg/etcd/store\ package now provides \RemoteStore\ for direct etcd client connectivity and \TemporaryStore\ for safe, isolated access to local etcd data files (copying only the bbolt backend). These changes improve the resilience of datastore bootstrap reconciliation, particularly for control-plane-only nodes, by ensuring proper resource cleanup (explicitly closing the MVCC backend) and using more robust error handling (replacing \merr.NewErrors\ with \errors.Join\).

pkg/etcd/store · high confidence

New rootless agent support and CLI structure

The agent CLI now supports running in rootless mode, allowing the agent to start without full system privileges when the --rootless flag is used. This change also introduces a new CLI command structure using UrfaveCLI v2, including a dedicated kubectl wrapper, and improves security by hiding process arguments from system process listings.

pkg/cli/agent · high confidence

Node password secrets are now managed by a dedicated controller with custom types and automatic cleanup

Node password secrets are now stored with a custom type (k3s.cattle.io/node-password) and managed by a new dedicated controller in pkg/nodepassword. This controller ensures secrets are garbage-collected when nodes are deleted, migrates legacy secrets to the new type, and cleans up orphaned secrets that are older than 10 minutes. The system also soft-fails on secret creation errors to allow cluster joining during transient outages, and requires the node password informer to sync before using the cache.

pkg/nodepassword · high confidence

Platform-specific privileged user checks for permissions validation

The permissions utility now implements distinct logic for checking elevated privileges depending on the operating system. On non-Windows systems, the \IsPrivileged\ function verifies that the process is running as root (UID 0). On Windows, it checks whether the current process is a member of the \BUILTIN\\Administrators\ group using native Windows security APIs. This ensures that privilege checks behave correctly across different platforms.

pkg/util/permissions · high confidence

Refactor etcd snapshot types to use k3s-io/api CRDs

The snapshot package now defines its internal data structures (File, S3Config) and conversion logic to map to and from the ETCDSnapshotFile custom resource defined in the external k3s-io/api module. This change centralizes the CRD schema definition and updates the snapshot storage logic to rely on the new API types for managing snapshot metadata and S3 configuration.

pkg/etcd/snapshot · high confidence

Refactor secrets encryption configuration management

The secrets encryption configuration logic has been consolidated into a new \config.go\ file, introducing structured handling for AES-CBC and SecretBox providers via the \EncryptionKeys\ type. This change updates how encryption providers are read, written, and validated, including support for identity-only configurations to disable encryption while preparing nodes for future re-encryption, and enforces limits on the number of supported providers.

pkg/secretsencrypt · high confidence

Refactor server initialization to use Wrangler controllers and new Context structure

The server startup process has been restructured to replace the legacy Norman/Rio-based HTTP routing and authentication middleware with a new Context object that manages Wrangler controller factories (K3s, Helm, Apps, Auth, etc.) and CRD registration. The old \auth.go\ and \router.go\ files are removed, and server preparation is now handled by \PrepareServer\ which binds request handlers via a new \handlers\ package. Controller execution is deferred until the API server is ready, and startup hooks are integrated into the main server flow with proper wait group synchronization.

pkg/server · high confidence

Refactored client access token and kubeconfig handling

The clientaccess package has been restructured to separate token parsing and validation logic from kubeconfig generation. Token handling now supports both legacy bootstrap tokens and kubeadm-style tokens, with improved CA certificate hash validation that distinguishes between single and multi-certificate bundles. A new kubeconfig writer generates client configuration files with proper context and cluster settings. The HTTP client used for token validation now includes a configurable timeout and supports custom CA certificates and client certificates for authentication.

pkg/clientaccess · high confidence

Refactored control-plane server startup and tunnel server egress proxying

The control-plane server startup logic has been refactored to decouple initial preparation from component launching: the new \Prepare\ function handles bootstrap data, tunnel setup, and authenticator initialization, while \Server\ now starts the cluster and control-plane components via a shared \sync.WaitGroup\ with delayed context cancellation for graceful shutdown. The tunnel server has been rewritten to support egress selector modes (Cluster and Pod), dynamically tracking node and pod IP addresses using a CIDR trie to proxy traffic, replacing the previous static proxy dialer approach.

pkg/daemons/control · high confidence

Replace go-bindata with native Go embed

The bindata utility now uses Go's native embed package instead of the external go-bindata tool. This change introduces a Bindata wrapper that provides Asset and AssetNames functions compatible with the previous interface, ensuring existing code continues to work while removing the build-time dependency on go-bindata.

pkg/util/bindata · high confidence

Replaced legacy Rio build system with comprehensive K3s build and CI scripts

The build infrastructure has been completely overhauled to support K3s, replacing the previous Rio-centric scripts. New scripts handle versioning (scripts/version.sh), platform detection (scripts/platform.sh), and dependency downloading (scripts/download). The build process (scripts/build) now compiles K3s binaries with specific tags and ldflags for components like containerd, CNI plugins, and etcd. CI workflows are updated to include binary size checks (scripts/binary\_size\check.sh), artifact validation (scripts/validate-artifacts), and airgap image packaging (scripts/package-airgap). Legacy Rio development and packaging scripts (scripts/dev-\, scripts/package-tar, scripts/release) have been removed.

scripts · high confidence

Restructured server request handlers into a dedicated package with expanded certificate and encryption capabilities

Request handlers previously located in the server package have been moved to a new \pkg/server/handlers\ package, introducing a centralized router that manages authentication layers and request routing for agent and server endpoints. This change adds a new CA certificate replacement endpoint (\/cert/cacerts\) that allows administrators to rotate the cluster's Certificate Authority by validating new certificates against existing roots before saving them to the datastore. It also enhances the secrets encryption subsystem by adding handlers to enable encryption on existing clusters, support for the \Secretbox\ provider, and improved status reporting that checks for core runtime readiness. Additionally, the kubelet-serving certificate handler now includes IPv6 loopback (\::1\) in the certificate's Subject Alternative Names, and the token rotation logic has been updated to properly normalize tokens and handle server-node token synchronization.

pkg/server/handlers · high confidence

Simplified CoreDNS host entry management for nodes

The node controller now directly manages the CoreDNS ConfigMap to keep node host entries in sync, replacing the previous approach. It watches for node additions and removals, extracting IPv4 and IPv6 addresses to update the 'NodeHosts' data field in the 'coredns' ConfigMap within the 'kube-system' namespace. This change simplifies the logic by handling dual-stack IP addresses and ensuring entries are sorted and cleaned up when nodes are deleted.

pkg/node · high confidence

Spegel embedded registry upgraded to v0.7.0 with P2P bootstrapping and deferred store

The embedded Spegel registry has been upgraded to v0.7.0, introducing a new P2P bootstrapping mechanism that allows agents to discover peers via Kubernetes node annotations and labels, while preventing the local node from registering itself as an upstream. A deferred OCI store implementation has been added to delay the connection to the containerd backend until it is actually needed, improving startup reliability. The registry now supports mirroring the \latest\ tag via a new environment variable and configures TLS for the mirror client automatically.

pkg/spegel · high confidence

Standardized CRI socket connection handling across platforms

The CRI agent now automatically prepends the correct platform-specific socket prefix (unix:// on Linux, npipe:// on Windows) when connecting to container runtime sockets, ensuring consistent address resolution. Additionally, the connection logic includes a retry loop that waits for the CRI service to become available, improving reliability during startup or transient runtime unavailability.

pkg/agent/cri · high confidence

Standardized managed database driver interface

The managed database driver contract has been formalized in a new \drivers.go\ file, defining a unified \Driver\ interface that standardizes how control-plane components interact with backend storage. This interface exposes specific capabilities for cluster lifecycle management, including initialization checks, HTTP handler registration, and reset operations, while also introducing explicit methods for etcd snapshot and restore workflows (\Snapshot\, \Restore\, \ReconcileSnapshotData\). By centralizing these operations, the system now provides a consistent API for managing database state and performing data preservation tasks across different driver implementations.

pkg/cluster/managed · high confidence

Switch embedded tarball extraction to zstd compression

The untar package now extracts zstd-compressed tarballs instead of gzip-compressed ones. This change updates the underlying decompression logic to use the klauspost/compress/zstd library and integrates with the shared wharfie decompression code, which includes memory limits for the zstd decoder to prevent excessive resource usage during extraction.

pkg/untar · high confidence

Switch to native Go embed for data assets

The data package now uses Go's native embed package instead of go-bindata to include static assets. This change simplifies the build process by removing the dependency on the external go-bindata tool, while maintaining the same public API (Asset and AssetNames) for accessing embedded files.

pkg/data · high confidence

Test coverage

Add E2E test suite for Btrfs snapshotter support; Add E2E test suite for Tailscale VPN integration; Add E2E tests for cluster validation with Vagrant-based infrastructure; Add E2E tests for private registry configuration and image mirroring; Added Docker integration tests for Gateway API functionality; Added Docker integration tests for lazy image pulling with stargz snapshotter; Added Docker skew upgrade tests; Added Docker upgrade test suite; Added Docker-based end-to-end tests for etcd cluster configurations; Added Docker-based end-to-end tests for k3s token management; Added Docker-based scale testing for large CNCF runner workloads; Added Docker-based snapshot restore tests; Added E2E startup test suite with Vagrant-based cluster validation; Added E2E test for custom CA certificate provisioning in Docker; Added E2E test for custom CA certificate rotation; Added E2E test for node-external-ip configuration; Added E2E test suite for dual-stack (IPv4/IPv6) networking; Added E2E tests for Docker dual-stack networking; Added E2E tests for S3-backed etcd snapshots; Added E2E tests for WebAssembly workloads on K3s; Added E2E tests for containerd auto-import behavior; Added E2E tests for secrets encryption key rotation and lifecycle management; Added E2E tests for service traffic policies and firewall configuration; Added E2E tests for split-server cluster configurations; Added E2E tests for the embedded registry mirror; Added Fedora install test infrastructure; Added Go-based end-to-end tests for Docker container provisioning; Added Longhorn storage integration tests; Added SELinux RPM installation tests for SUSE and SLE Micro distributions; Added T4 datastore integration tests and consolidated Docker test infrastructure; Added Ubuntu 24.04 install test environment; Added Vagrant-based install test for Rocky Linux 8; Added Vagrant-based install tests for openSUSE Leap and MicroOS; Added e2e test for Multus CNI integration; Added end-to-end test for K3s network retry logic; Added end-to-end tests for rootless K3s startup and metrics; Added end-to-end tests for secrets encryption lifecycle; Added etcd test fixture for embedded member data; Added hardened Docker test suite with Pod Security Standards and audit logging; Added install smoke tests for CentOS Stream 9 and Rocky Linux 9; Added integration test for --flannel-cni-conf flag; Added integration test for custom etcd arguments; Added integration test for dual-stack networking support; Added integration test for etcd snapshot restore; Added integration test for flannel-backend=none mode; Added integration tests for CA certificate rotation; Added integration tests for Nix snapshotter support; Added integration tests for k3s certificate rotation; Added integration tests for local storage functionality; Added integration tests for secrets encryption rotation; Added integration tests for server startup configurations; Added mock implementations for testing; Added performance test automation scripts; Added performance test infrastructure for K3s server and agent clusters; Initial E2E test framework and infrastructure setup; Integration tests for etcd snapshot management and server flags; Integration tests for kube-\* server flags and component disabling; New E2E test infrastructure and scripts; New integration test framework with Sonobuoy support; New test infrastructure and documentation.

Dependencies

Replace gorilla/mux with custom standard-library router

The application no longer depends on the external github.com/gorilla/mux library. Instead, it uses a new internal router implementation in pkg/util/mux that wraps Go's standard http.ServeMux. This custom router provides similar functionality, including middleware support that runs only on matched routes, sub-router registration, and a custom not-found handler, while removing the external dependency.

pkg/util/mux · high confidence

Upgrade to Kubernetes v1.37.1 and Go 1.26.8

The embedded Kubernetes version is upgraded to v1.37.1-k3s1, and the Go toolchain is updated to v1.26.8. This release also bumps several core dependencies including containerd to v2.3.4-k3s1, runc to v1.4.2, etcd to v3.7.1-k3s3, and flannel to v0.28.4, while updating the Kubernetes API client libraries to v0.37.1.

(dependencies) · high confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

Score

  • CAI 61 → 60 (-1.3)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.3) — scores are not directly comparable.

Lenses

  • Code Health 69 → 69 (+0.0)
  • Architecture 71 → 74 (+2.9)
  • Maturity 74 → 82 (+8.6)
  • Readiness 68 → 68 (+0.7)
  • Security 55 → 47 (-7.8)

Resolved (54)

  • ADR not followed: Store etcd snapshot metadata in a Custom Resource (docs/adrs/etcd-snapshot-cr.md)
  • Consequences are mostly procedural and lack trade-offs (e.g. dependency on charts-build-scripts, staged PR burden) (docs/adrs/k3s-charts.md)
  • Context and consequences are boilerplate filler; the body states neither what decisions were recorded nor any trade-offs (docs/adrs/record-architecture-decisions.md)
  • Documentation: no installation or build instructions (docs/adrs/k3s-charts.md)
  • Documentation: no project overview (docs/adrs/cert-expiry-checks.md)
  • Documentation: no project overview (docs/adrs/integrate-vpns.md)
  • High secret: WD-SECRET-0005 (Godeps/_workspace/src/github.com/vmware/govmomi/scripts/wireshark-esx.sh)
  • High secret: WD-SECRET-0005 (Godeps/_workspace/src/github.com/vmware/govmomi/scripts/wireshark-vcsa.sh)
  • High secret: WD-SECRET-0005 (build/common.sh)
  • High secret: WD-SECRET-0005 (cluster/photon-controller/util.sh)
  • High secret: WD-SECRET-0005 (cluster/rackspace/util.sh)
  • High secret: WD-SECRET-0005 (cluster/vagrant/config-default.sh)
  • High secret: WD-SECRET-0005 (examples/experimental/persistent-volume-provisioning/quobyte/quobyte-admin-secret.yaml)
  • High secret: WD-SECRET-0005 (examples/persistent-volume-provisioning/quobyte/quobyte-admin-secret.yaml)
  • High secret: WD-SECRET-0005 (examples/volumes/iscsi/chap-secret.yaml)
  • High secret: WD-SECRET-0005 (examples/volumes/scaleio/secret.yaml)
  • High secret: WD-SECRET-0005 (examples/volumes/storageos/storageos-secret.yaml)
  • Informative title ("Easy way for auto adding images to k3s") and weak consequences section that only lists one good ('Better use of embedded containerd image store.') and one bad ('The need for another dependency') rather than covering trade-offs such as the controller's own resource cost or the added complexity of managing a watcher on agent/images (docs/adrs/add-auto-import-containerd.md)
  • Medium CVE: [GHSA redacted] (go.mod)
  • Medium CVE: [GHSA redacted] (go.mod)
  • …and 34 more

New (34)

  • Edited copies of one member (3 members, 13+ corresponding lines) (pkg/etcd/store/store.go)
  • Edited copies of one member (3 members, 14+ corresponding lines) (pkg/clientaccess/token.go)
  • Edited copies of one member (4 members, 14+ corresponding lines) (cmd/cert/main.go)
  • Edited copies of one member (4 members, 20+ corresponding lines) (pkg/executor/embed/embed.go)
  • Edited copies of one member (6 members, 18+ corresponding lines) (pkg/cli/secretsencrypt/secrets_encrypt.go)
  • Edited copy of a member (11 corresponding lines) (pkg/agent/flannel/flannel.go)
  • Edited copy of a member (12 corresponding lines) (pkg/etcd/member_controller.go)
  • Edited copy of a member (12 corresponding lines) (pkg/server/handlers/handlers.go)
  • Edited copy of a member (13 corresponding lines) (pkg/agent/config/config.go)
  • Edited copy of a member (13 corresponding lines) (pkg/util/api.go)
  • Edited copy of a member (13 corresponding lines) (pkg/util/net.go)
  • Edited copy of a member (15 corresponding lines) (pkg/cloudprovider/servicelb.go)
  • Edited copy of a member (15 corresponding lines) (pkg/server/handlers/cert.go)
  • Edited copy of a member (15 corresponding lines) (pkg/util/patch.go)
  • Edited copy of a member (16 corresponding lines) (pkg/agent/flannel/setup.go)
  • Edited copy of a member (19 corresponding lines) (pkg/cli/secretsencrypt/secrets_encrypt.go)
  • Edited copy of a member (20 corresponding lines) (pkg/agent/flannel/flannel.go)
  • Edited copy of a member (21 corresponding lines) (pkg/agent/containerd/watcher.go)
  • Edited copy of a member (24 corresponding lines) (pkg/dataverify/dataverify.go)
  • Edited copy of a member (26 corresponding lines) (pkg/agent/config/config.go)
  • …and 14 more

Changes since last survey

  • 29 commits — 26 feature/other, 3 fixes

By area

  • (root) — 9 commits
  • pkg/agent — 8 commits
  • .github/workflows — 2 commits
  • manifests/coredns.yaml — 1 commit
  • manifests/metrics-server — 1 commit
  • manifests/traefik.yaml — 1 commit
  • pkg/cloudprovider — 1 commit
  • pkg/cluster — 1 commit
  • pkg/containerd — 1 commit
  • pkg/etcd — 1 commit
  • pkg/spegel — 1 commit
  • scripts/airgap — 1 commit
  • scripts/version.sh — 1 commit

Notable commits

  • fix: Fix airgap tarballs re-imported on every start with .cache.json
  • fix: Fix bashisms in install.sh
  • fix: Fix dead community meeting and shell style guide links
  • change: Add containerd server/metrics plugin
  • change: Add new helper to check if image has changed. Also consider any change in mtime (not just newer).
  • change: Allow configuring flannel vxlan vni and port via env var
  • change: Bump Spegel to v0.8.1 (#14931)
  • change: Bump kine to v0.17.5
  • change: Bump x/net and pass replacements through when building runc and runc-shim
  • change: Close backend connection when client connection is closed
  • change: Disable LB+tunnel on agentless servers with local apiserver
  • change: Fix typos and smart quotes
  • change: Normalize pause image
  • change: Pin runners to ubuntu-24.04
  • change: Remove temporary etcd datastore copy when opening it fails
  • change: Set IdleTimeout on the supervisor http server (#14904)
  • change: Update AI guidance
  • change: Update download path of rancher.openvex.json artifact
  • change: Update pkg/agent/containerd/watcher.go
  • change: Update pkg/agent/containerd/watcher.go
  • …and 9 more

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

k3s-io/k3s was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 13 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit 51d3b7043183cbd61381773e6345082bd4cf2280 — the exact code this score is about.
  • Scored under rubric-2026.11.3 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.61+preprod-f3449e6eb431.