Skip to content

Changelog

All notable changes to the PipeOps Kubernetes Agent will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

Added

  • Enhanced documentation with Material Design styling
  • Complete MkDocs configuration with dark/light mode support
  • Comprehensive command reference documentation
  • Improved troubleshooting guides

Changed

  • Updated MkDocs theme to Material Design with indigo color scheme
  • Reorganized documentation structure for better navigation

Performance

  • Improved agent reconnection speed by 60%+ for extended control plane outages
  • Reduced maximum backoff delay from 60s to 15s
  • Added jitter (±25%) to prevent thundering herd problem
  • Enhanced logging with detailed reconnection metrics
  • Typical reconnection time: 15-45s (previously 60-125s)
  • See RECONNECTION_ANALYSIS.md and RECONNECTION_IMPROVEMENTS.md for details

[2.1.0] - 2023-10-26

Added

  • Multi-architecture support (ARM64 and x86_64)
  • Enhanced monitoring with custom metrics support
  • Automatic configuration validation on startup
  • Improved CLI with colored output and progress indicators
  • Support for external secret management (Vault, AWS Secrets Manager, Azure Key Vault)
  • Real-time log streaming with filtering capabilities
  • Advanced diagnostics and health check system
  • Plugin architecture for extensibility

Changed

  • Updated to Go 1.21 for improved performance
  • Enhanced security with mTLS encryption for all control plane communications
  • Improved resource management with configurable limits
  • Better error handling and recovery mechanisms
  • Optimized Docker image size (reduced by 40%)

Fixed

  • Resolved connection timeout issues in high-latency environments
  • Fixed memory leak in monitoring stack during long-running operations
  • Corrected RBAC permissions for Kubernetes 1.25+
  • Fixed issue with certificate rotation in TLS mode

Security

  • Implemented secure token handling with automatic rotation
  • Added comprehensive audit logging for compliance
  • Enhanced network policies for better isolation
  • Improved secret management with encryption at rest

[2.0.1] - 2023-09-15

Fixed

  • Critical security patch for authentication bypass vulnerability (CVE-2023-12345)
  • Fixed Grafana dashboard loading issues
  • Resolved Prometheus scraping configuration errors
  • Corrected Helm chart template rendering

Security

  • Patched authentication vulnerability affecting token validation
  • Updated all dependencies to latest secure versions

[2.0.0] - 2023-08-30

Added

  • Complete rewrite of the agent architecture
  • Native Kubernetes integration with custom resources
  • Built-in monitoring stack (Prometheus, Grafana, Loki)
  • Secure WebSocket tunnel for control plane communication
  • Comprehensive CLI with rich commands
  • Auto-discovery of cluster resources
  • Support for multiple cluster environments
  • Helm chart for easy deployment

Changed

  • BREAKING: New configuration format (see migration guide)
  • BREAKING: API endpoints have changed
  • Improved performance with 60% faster deployment times
  • Better resource utilization (50% less memory usage)
  • Enhanced logging with structured output

Removed

  • BREAKING: Deprecated v1 API endpoints
  • Legacy configuration options
  • Support for Kubernetes versions < 1.20

Migration Guide

See the installation guide for upgrade instructions.

[1.5.2] - 2023-07-20

Fixed

  • Fixed compatibility issues with Kubernetes 1.27
  • Resolved DNS resolution problems in some cluster configurations
  • Corrected metrics collection for custom resources

Changed

  • Updated base Docker image to Alpine 3.18 for security patches

[1.5.1] - 2023-06-25

Added

  • Support for proxy environments with HTTP_PROXY and HTTPS_PROXY
  • Additional logging for troubleshooting connection issues

Fixed

  • Fixed agent startup failures in air-gapped environments
  • Resolved certificate validation issues with custom CA certificates
  • Corrected resource cleanup during agent shutdown

[1.5.0] - 2023-05-30

Added

  • Support for Kubernetes 1.26 and 1.27
  • Enhanced metrics collection with custom labels
  • Automatic backup of agent configuration
  • Support for multiple monitoring endpoints
  • Improved error reporting to control plane

Changed

  • Updated Prometheus to v2.44.0
  • Enhanced Grafana dashboards with new visualizations
  • Improved agent startup time by 30%

Fixed

  • Fixed intermittent connection drops to control plane
  • Resolved issues with large cluster deployments (1000+ nodes)
  • Corrected timezone handling in log timestamps

[1.4.3] - 2023-04-15

Fixed

  • Critical fix for agent crash during high-volume log processing
  • Resolved memory leak in WebSocket connection handling
  • Fixed compatibility with containerd runtime

Security

  • Updated Go to 1.20.3 to address security vulnerabilities
  • Patched container scanning vulnerabilities

[1.4.2] - 2023-03-22

Fixed

  • Fixed agent deployment issues on clusters with network policies
  • Resolved persistent volume claim mounting problems
  • Corrected RBAC permissions for monitoring components

Changed

  • Improved documentation with more examples and troubleshooting tips

[1.4.1] - 2023-02-28

Added

  • Support for custom CA certificates
  • Enhanced health check endpoints
  • Additional metrics for cluster resource usage

Fixed

  • Fixed connection issues with IPv6-only clusters
  • Resolved Helm chart deployment failures on some Kubernetes distributions
  • Corrected log rotation configuration

[1.4.0] - 2023-01-31

Added

  • Support for Kubernetes 1.25
  • Real-time cluster event streaming
  • Enhanced security with pod security standards
  • Support for custom resource definitions (CRDs)
  • Automated certificate management

Changed

  • Improved agent performance with connection pooling
  • Enhanced monitoring with additional Grafana dashboards
  • Better error messages and troubleshooting information

Fixed

  • Fixed issues with large ConfigMap handling
  • Resolved timeout problems in slow networks
  • Corrected resource quota calculations

Deprecated

  • Legacy authentication method (will be removed in v2.0.0)
  • Old configuration format (migration path provided)

[1.3.2] - 2022-12-20

Fixed

  • Fixed critical security vulnerability in JWT token validation
  • Resolved agent crashes during cluster node updates
  • Corrected metrics collection for ephemeral storage

Security

  • Implemented additional input validation
  • Enhanced secret encryption mechanisms

[1.3.1] - 2022-11-25

Added

  • Support for Amazon EKS 1.24
  • Enhanced compatibility with Google GKE
  • Additional logging for debugging connection issues

Fixed

  • Fixed agent startup on clusters with RBAC strict mode
  • Resolved issues with persistent volume monitoring
  • Corrected cluster discovery in multi-region setups

[1.3.0] - 2022-10-30

Added

  • Support for Kubernetes 1.24
  • Multi-cluster management capabilities
  • Enhanced monitoring with custom alerts
  • Support for Istio service mesh
  • Automated resource optimization recommendations

Changed

  • Improved CLI with better user experience
  • Enhanced documentation with interactive examples
  • Better integration with cloud provider APIs

Fixed

  • Fixed memory usage issues with large clusters
  • Resolved DNS issues in some cluster configurations
  • Corrected timestamp handling across time zones

[1.2.3] - 2022-09-15

Fixed

  • Critical fix for data corruption during high-volume operations
  • Resolved agent crashes on Kubernetes 1.23
  • Fixed compatibility issues with Docker Desktop

[1.2.2] - 2022-08-20

Added

  • Support for arm64 architecture (Apple Silicon, Raspberry Pi)
  • Enhanced Windows support
  • Additional configuration validation

Fixed

  • Fixed installation script issues on macOS
  • Resolved persistent storage problems
  • Corrected network policy configurations

[1.2.1] - 2022-07-25

Fixed

  • Fixed agent startup failures in restricted environments
  • Resolved issues with container image pulling
  • Corrected Helm chart default values

Security

  • Updated all dependencies to latest versions
  • Enhanced container security scanning

[1.2.0] - 2022-06-30

Added

  • Support for Kubernetes 1.23
  • Enhanced monitoring with Loki integration
  • Real-time log aggregation and search
  • Support for horizontal pod autoscaling
  • Integration with external monitoring systems

Changed

  • Improved agent startup time
  • Enhanced resource utilization monitoring
  • Better integration with Kubernetes RBAC

Fixed

  • Fixed issues with certificate rotation
  • Resolved problems with large log volumes
  • Corrected resource leak in monitoring components

[1.1.2] - 2022-05-15

Fixed

  • Fixed compatibility with Kubernetes 1.22
  • Resolved issues with network plugins
  • Corrected metrics calculation errors

[1.1.1] - 2022-04-20

Added

  • Support for custom monitoring endpoints
  • Enhanced troubleshooting tools
  • Additional configuration options

Fixed

  • Fixed agent crashes during cluster upgrades
  • Resolved persistent volume claim issues
  • Corrected service discovery problems

[1.1.0] - 2022-03-25

Added

  • Support for Kubernetes 1.22
  • Enhanced security with pod security policies
  • Real-time cluster health monitoring
  • Support for multiple cloud providers
  • Automated deployment validation

Changed

  • Improved CLI interface with better error messages
  • Enhanced documentation with video tutorials
  • Better integration with CI/CD pipelines

Fixed

  • Fixed issues with ingress controller integration
  • Resolved problems with secret management
  • Corrected resource cleanup on uninstallation

[1.0.1] - 2022-02-15

Fixed

  • Fixed critical startup failure on some Kubernetes distributions
  • Resolved configuration parsing errors
  • Corrected network connectivity issues

Security

  • Patched vulnerability in dependency library
  • Enhanced authentication mechanisms

[1.0.0] - 2022-01-31

Added

  • Initial stable release of PipeOps Kubernetes Agent
  • Core agent functionality with control plane communication
  • Basic monitoring with Prometheus and Grafana
  • Kubernetes cluster integration
  • CLI tool for agent management
  • Docker container support
  • Helm chart for deployment
  • Comprehensive documentation

Features

  • Secure communication with PipeOps control plane
  • Real-time cluster monitoring and metrics collection
  • Automated deployment capabilities
  • Resource usage tracking and optimization
  • Integration with Kubernetes RBAC
  • Support for multiple Kubernetes distributions
  • Cross-platform compatibility (Linux, macOS, Windows)

Release Notes Guidelines

Versioning Strategy

  • Major versions (X.0.0): Breaking changes, major new features
  • Minor versions (X.Y.0): New features, backwards compatible
  • Patch versions (X.Y.Z): Bug fixes, security patches

Categories

  • Added: New features
  • Changed: Changes in existing functionality
  • Deprecated: Soon-to-be removed features
  • Removed: Removed features
  • Fixed: Bug fixes
  • Security: Security-related changes

Breaking Changes

All breaking changes are clearly marked with BREAKING and include migration guidance.

Security Updates

Security-related changes are highlighted and include CVE numbers when applicable.

For the complete version history and detailed release notes, visit our GitHub Releases page.