Kargo Roadmap

Over a series of releases, Kargo's maintainers intend to establish and settle into a predictable, but yet to be determined release cadence.

caution

This roadmap is subject to change at any time, for the most up to date information, please see the GitHub Project

v0.2.0

Status: Completed

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.

Status: Completed

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.

Status: Completed

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.

Status: Completed

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.

Status: In Progress

Name	Type	Description
Multiple `Warehouse`s	feature	Improve UI support for multiple Freightlines rooted in different `Warehouse`s.
Manual `Freight` Creation	feature	Add CLI and UI support for manual `Freight` creation. This will give users the flexibility to create novel combinations of artifacts that `Warehouse`s will not -- for instance, pairing the most recent version of a container image with an older version of application manifests.
Project Management	feature	Add sensible `ServiceAccount`s, `Role`s, and `RoleBinding`s to boilerplate project setup. Add user / role / permission management capabilities to the CLI and UI.
Production Readiness	chore	Prioritize stability of existing features. Pay down technical debt. This is not a guarantee that v0.6.0 will be production-ready. It is a commitment to a large step in that direction.
Patch Promotions	poc	Support a generalized option to promote arbitrary configuration (e.g. strings, files, and directories) to other paths of the Git repository.

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.

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