Kargo Roadmap

Over a series of releases, Kargo's maintainers have settled into a cadence of a minor release roughly every five weeks, with two or three major features completed per release.

caution

This roadmap tracks only major features and is subject to change at any time, for the most up-to-date information, please see the GitHub Project

In Progress

v0.8.0

Expected: 2024-07-12

Name	Type	Description
Auth via GitHub Apps	feature	Support GitHub Apps as an authentication option for GitHub and ghcr.io repositories.
Multiple Freight per Stage	feature	The overarching theme of the release: Permit Stages to host multiple pieces of Freight from different Warehouses. This will permit different artifacts, or sets of artifacts, to be promoted through a pipeline with different/independent cadence.
Production Readiness	chore	Prioritize stability of existing features. Pay down technical debt. This is not a guarantee that v0.8.0 will be production-ready. It is a commitment to large steps in that direction.

Upcoming

v0.9.0

Name	Type	Description
Patch Promotions	poc	Support a generalized option to promote arbitrary configuration (e.g. strings, files, and directories) to other paths of a GitOps repository. Dependent on changes scheduled for v0.8.0.
Production Readiness	chore	Prioritize stability of existing features. Pay down technical debt. This is not a guarantee that v0.9.0 will be production-ready. It is a commitment to large steps in that direction.

v0.10.0 .. v0.n.0

Name	Type	Description
Promotion Mechanism Extensibility	feature	User-defined promotion mechanisms.
Project Improvements	feature	Permit promotion policies to "freeze" Freight production and/or promotions based on time or other constraints. Aggregate useful project-level status and statistics in ProjectStatus.
Freight Enrichment	feature	Enhance Freight metadata for improved insight into contents and the expected result of promoting a piece of Freight to a given Stage.
kargo init	feature	Addition of an init sub-command to the Kargo CLI for streamlining project / pipeline creation.
Standalone Image Writeback	feature	Write back image changes without having to subscribe to an image repository.

Completed

v0.7.0

Name	Type	Description
Multiple Warehouses	feature	Improved UI support for displaying Freight from multiple Warehouses.
Manual Freight Creation	feature	Added UI feature for manual Freight creation.
ECR/GAR Support	feature	Added multiple options for authenticating to image repositories in ECR and Google Artifact Registry, including support for EKS Pod Identity and GKE Workload Identity Federation.
Patch Promotions	poc	Support a generalized option to promote arbitrary configuration (e.g. strings, files, and directories) to other paths of a GitOps repository.
Production Readiness	chore	Prioritized stability of existing features. This does not mean v0.7.0 is production-ready. It means it is several steps closer to it.

v0.6.0

Name	Type	Description
Project Management	feature	Added user / role / permission management capabilities to the CLI and UI.
Events	feature	Kargo emits noteworthy events as Kubernetes events. Events are also viewable in the UI.
Production Readiness	chore	Prioritized stability of existing features. This does not mean v0.6.0 is production-ready. It means it is several steps closer to it.

v0.5.0

Name	Type	Description
Warehouse Rules/Filters	feature	Introduced optional path-based constraints on Git repository subscriptions.
Credential Storage	refactor	Simplified and streamlined format and storage of repository credentials.
Credential Management	feature	Added credential management capabilities to the CLI and UI.
CLI Improvements	refactor	Overhauled the CLI to make the tree of sub-commands more intuitive, with improved consistency in usage and documentation from command to command.
UI Improvements	feature	Achieved near-parity with CLI features.

v0.4.0

Name	Type	Description
Warehouse Rules/Filters	feature	Introduced optional tag-based constraints on Git repository subscriptions.
Project Management	feature	Introduced Project CRD to simplify project initialization. Removed PromotionPolicy CRD and folded its functionality directly into the Project CRD.

v0.3.0

Name	Type	Description
GitHub PR-Based Promotion	feature	Pull request-based promotions are now supported on GitHub.
Verifications	feature	Stage resources can now execute a user-defined verification process after a promotion. These can be defined using Argo Rollouts AnalysisTemplate resources, and executions take the form of AnalysisRun resources.
Improved RBAC	feature	SSO user identities can now be mapped to Kubernetes ServiceAccount resources using annotations.

v0.2.0

Name	Type	Description
Freight CRD	feature	Freight changed from being a property of a Stage, to being its own Freight CRD.
Warehouse CRD	feature	Freight production was decoupled from a pipeline's first Stage and now comes from a Warehouse.
Kargo Render	breaking change	The Bookkeeper project was rebranded as Kargo Render -- a Kargo sub-project for rendering manifests.

Criteria for a Production-Ready 1.0.0 Release

Maintainers will consider cutting a stable v1.0.0 release once:

• Confident in API stability. (No further breaking changes anticipated.)
• No critical, "show-stopping" bugs remaining in the backlog.
• Observing evidence of successful community adoption (of beta releases) in production environments