Release v0.2.0

Release Notes for v0.2.0

Released on 2025-10-26

Added

• Prepare for next release

Changes since v0.1.12

Features

Bug Fixes

• fix: update Docker image path to include repository in CI/CD workflow (32373a5)

Other Changes

• Merge pull request #4 from dudizimber/rename-project-karo (6528414)
• chore: remove extra chars (edd95a7)
• chore: Merge remote-tracking branch 'origin/main' into rename-project-karo (e2c2dd6)
• chore: regenerate manifests (b1c0aac)
• chore: rename project to Karo (6077e5f)
• chore: rename api to karo.io (a95c22f)
• chore: rename project to karo (aa8e4ec)

---

Helm Chart Release vv0.2.0

Release Notes

Release Notes for v0.2.0

Released on 2025-10-26

Added

• Prepare for next release

Changes since v0.1.12

Features

Bug Fixes

• fix: update Docker image path to include repository in CI/CD workflow (32373a5)

Other Changes

• Merge pull request #4 from dudizimber/rename-project-karo (6528414)
• chore: remove extra chars (edd95a7)
• chore: Merge remote-tracking branch 'origin/main' into rename-project-karo (e2c2dd6)
• chore: regenerate manifests (b1c0aac)
• chore: rename project to Karo (6077e5f)
• chore: rename api to karo.io (a95c22f)
• chore: rename project to karo (aa8e4ec)

Detailed Changes

[0.2.0] - 2025-10-26

Added

• Prepare for next release

Installation

Install from OCI Registry (Recommended)

# Install directly from GitHub Container Registry
helm install karo oci://ghcr.io/dudizimber/charts/karo --version v0.2.0

# Or with custom values
helm install karo oci://ghcr.io/dudizimber/charts/karo --version v0.2.0 -f values.yaml

Install from Release Assets

# Download and install from release assets
curl -L https://github.com/dudizimber/karo/releases/download/v0.2.0/karo-v0.2.0.tgz -o karo-v0.2.0.tgz
helm install karo ./karo-v0.2.0.tgz

Upgrade

# Upgrade from OCI registry
helm upgrade karo oci://ghcr.io/dudizimber/charts/karo --version v0.2.0

Container Images

• Operator Image: docker.io/dudizimber/karo:0.2.0

Chart Details

• Chart Version: v0.2.0
• App Version: v0.2.0
• Kubernetes Compatibility: 1.19+

Release v0.1.12

Release Notes for v0.1.12

Released on 2025-10-08

Added

• AlertReaction Custom Resource Definition (CRD)
• AlertReaction controller with reconciliation logic
• Webhook server for AlertManager integration
• Job creation and management based on alert triggers
• Environment variable substitution in job templates
• Comprehensive test suite with unit and integration tests
• GitHub Actions CI/CD pipeline
• Complete Helm chart for deployment
• Support for multiple deployment environments (dev, prod)
• Monitoring and observability features
• Security policies and RBAC configuration
• Documentation and contribution guidelines
• Draft-first release process with comprehensive release automation
• CHANGELOG automation and validation tooling
• Enhanced Helm chart release pipeline with CRD bundling
• Release preparation and management scripts
• Comprehensive release documentation and automation guides

Changed

• Restructured CI/CD pipeline to separate concerns (testing vs releasing)
• Moved release process to draft-first approach for better control
• Enhanced Helm chart automation with multi-format publishing
• Improved release workflow with CHANGELOG integration and validation
• Updated chart documentation to reflect bundled CRDs

Improved

• Release process now requires manual approval before publishing
• Helm charts automatically bundle latest CRDs from config/crd/
• Enhanced release notes generation with CHANGELOG integration
• Better separation between CI/CD and release pipelines
• Streamlined user experience with automatic CRD installation

Features

• Alert Matching: Flexible alert selection using labels and annotations
• Job Execution: Automatic Kubernetes Job creation in response to alerts
• Template Support: Environment variable substitution in job specifications
• Cooldown Period: Configurable delays to prevent rapid re-execution
• Status Tracking: Comprehensive status reporting for AlertReaction resources
• Webhook Integration: HTTP endpoint for AlertManager webhook notifications
• Health Checks: Readiness and liveness probes for operator reliability

Infrastructure

• Kubernetes Support: Compatible with Kubernetes 1.19+
• Go Runtime: Built with Go 1.24 and controller-runtime v0.21.0
• Container Images: Multi-architecture container images (amd64/arm64)
• Helm Deployment: Production-ready Helm chart with configurable values
• CI/CD Pipeline: Automated testing, building, and security scanning
• Monitoring: Prometheus metrics and ServiceMonitor support
• Release Automation: Draft-first release workflow with manual approval gates
• CHANGELOG Management: Automated CHANGELOG processing and validation
• Helm Publishing: Multi-format chart publishing (OCI registry, GitHub Pages, release assets)
• CRD Bundling: Automatic inclusion of latest CRDs in Helm charts during release
• Documentation: Enhanced release process documentation and user guides

Security

• RBAC: Minimal required permissions with ClusterRole/ClusterRoleBinding
• Security Context: Non-root user, read-only filesystem, dropped capabilities
• Network Policies: Optional traffic restriction policies
• Image Scanning: Automated vulnerability scanning in CI/CD
• Secret Management: Secure handling of configuration data

Documentation

• User Guide: Comprehensive README with examples and troubleshooting
• API Reference: Detailed CRD specification and field documentation
• Helm Chart Guide: Complete Helm chart documentation
• Contributing Guide: Development setup and contribution guidelines
• Operations Guide: Monitoring, troubleshooting, and maintenance procedures

Removed

• Duplicate CRD files from charts directory (now bundled during release)
• Manual CRD installation requirement for users
• Release job from CI/CD pipeline (moved to separate workflow)

Changes since v0.1.6

Features

• feat: enhance CHANGELOG update process for draft releases (9d79c74)

Bug Fixes

• fix: add ssh-key to checkout step for secure access (dc864d0)
• fix: use force push to ensure successful updates to the main branch (527aae6)
• fix: use force push for cherry-picking changelog commits to ensure successful updates on release branch (b4eb971)
• fix: update job name generation to use lowercase alphanumeric characters for Kubernetes compatibility (1e1464e)
• fix: generate unique job names by appending a random string while ensuring compliance with Kubernetes naming conventions (b401ed2)

Other Changes

• test: add job name and label generation tests for AlertReaction (fec0afb)

---

Helm Chart Release vv0.1.12

Release Notes

Release Notes for v0.1.12

Released on 2025-10-08

Added

• AlertReaction Custom Resource Definition (CRD)
• AlertReaction controller with reconciliation logic
• Webhook server for AlertManager integration
• Job creation and management based on alert triggers
• Environment variable substitution in job templates
• Comprehensive test suite with unit and integration tests
• GitHub Actions CI/CD pipeline
• Complete Helm chart for deployment
• Support for multiple deployment environments (dev, prod)
• Monitoring and observability features
• Security policies and RBAC configuration
• Documentation and contribution guidelines
• Draft-first release process with comprehensive release automation
• CHANGELOG automation and validation tooling
• Enhanced Helm chart release pipeline with CRD bundling
• Release preparation and management scripts
• Comprehensive release documentation and automation guides

Changed

• Restructured CI/CD pipeline to separate concerns (testing vs releasing)
• Moved release process to draft-first approach for better control
• Enhanced Helm chart automation with multi-format publishing
• Improved release workflow with CHANGELOG integration and validation
• Updated chart documentation to reflect bundled CRDs

Improved

• Release process now requires manual approval before publishing
• Helm charts automatically bundle latest CRDs from config/crd/
• Enhanced release notes generation with CHANGELOG integration
• Better separation between CI/CD and release pipelines
• Streamlined user experience with automatic CRD installation

Features

• Alert Matching: Flexible alert selection using labels and annotations
• Job Execution: Automatic Kubernetes Job creation in response to alerts
• Template Support: Environment variable substitution in job specifications
• Cooldown Period: Configurable delays to prevent rapid re-execution
• Status Tracking: Comprehensive status reporting for AlertReaction resources
• Webhook Integration: HTTP endpoint for AlertManager webhook notifications
• Health Checks: Readiness and liveness probes for operator reliability

Infrastructure

• Kubernetes Support: Compatible with Kubernetes 1.19+
• Go Runtime: Built with Go 1.24 and controller-runtime v0.21.0
• Container Images: Multi-architecture container images (amd64/arm64)
• Helm Deployment: Production-ready Helm chart with configurable values
• CI/CD Pipeline: Automated testing, building, and security scanning
• Monitoring: Prometheus metrics and ServiceMonitor support
• Release Automation: Draft-first release workflow with manual approval gates
• CHANGELOG Management: Automated CHANGELOG processing and validation
• Helm Publishing: Multi-format chart publishing (OCI registry, GitHub Pages, release assets)
• CRD Bundling: Automatic inclusion of latest CRDs in Helm charts during release
• Documentation: Enhanced release process documentation and user guides

Security

• RBAC: Minimal required permissions with ClusterRole/ClusterRoleBinding
• Security Context: Non-root user, read-only filesystem, dropped capabilities
• Network Policies: Optional traffic restriction policies
• Image Scanning: Automated vulnerability scanning in CI/CD
• Secret Management: Secure handling of configuration data

Documentation

• User Guide: Comprehensive README with examples and troubleshooting
• API Reference: Detailed CRD specification and field documentation
• Helm Chart Guide: Complete Helm chart documentation
• Contributing Guide: Development setup and contribution guidelines
• Operations Guide: Monitoring, troubleshooting, and maintenance procedures

Removed

• Duplicate CRD files from charts directory (now bundled during release)
• Manual CRD installation requirement for users
• Release job from CI/CD pipeline (moved to separate workflow)

Changes since v0.1.6

Features

• feat: enhance CHANGELOG update process for draft releases (9d79c74)

Bug Fixes

• fix: add ssh-key to checkout step for secure access (dc864d0)
• fix: use force push to ensure successful updates to the main branch (527aae6)
• fix: use force push for cherry-picking changelog commits to ensure successful updates on release branch (b4eb971)
• fix: update job name generation to use lowercase alphanumeric characters for Kubernetes compatibility (1e1464e)
• fix: generate unique job names by appending a random string while ensuring compliance with Kubernetes naming conventions (b401ed2)

Other Changes

• test: add job name and label generation tests for AlertReaction (fec0afb)

Detailed Changes

[0.1.12] - 2025-10-08

Added

• AlertReaction Custom Resource Definition (CRD)
• AlertReaction controller with reconciliation logic
• Webhook server for AlertManager integration
• Job creation and management based on alert triggers
• Environment variable substit...