Deprecations and Breaking Changes
As Kargo continues to evolve, features that have outlived their usefulness, often having been replaced with better alternatives, are sometimes sunset. This page documents past and pending deprecated features and breaking changes.
Deprecations
The table below summarizes features that have been deprecated and either removed or scheduled for removal.
| Feature | Deprecated In | Removed In | Replacement/Notes |
|---|---|---|---|
| Promotion Steps Fields | v1.1.0 | Scheduled for v1.3.0 | Several fields in promotion steps, such as prNumberFromStep in the git-wait-for-pr step, are now deprecated. These fields were originally the only way to reference output from previous promotion steps. With the introduction of expressions, these fields have outlived their purpose, as expressions like ${{ outputs['open-pr'].prNumber }} present a more flexible and straightforward way to reference the same output. more info |
helm-update-image step | v1.1.0 | Scheduled for v1.3.0 | Use the more flexible yaml-update step. more info |
| Legacy Promotion Mechanisms | v0.9.0 | v1.0.0 | Migrate to promotion steps. more info |
Breaking Changes
This section summarizes significant changes that create potential for disruption upon upgrade. The Kargo team strives to keep changes of this nature to an absolute minimum.
| Change | Version | Impact | Migration Path |
|---|---|---|---|
| Global Credential Store Changes | v1.0.0 | Affects installations using controller.globalCredentials.namespaces | Manually create a RoleBindings to permit controller access to "global" credential namespaces or set controller.serviceAccount.clusterWideSecretReadingEnabled to true at install time (not recommended). more info |