🎉 The Crossplane Community Day EU '21 playlist is LIVE — watch all the sessions on demand

Documentation

PLEASE NOTE: This document applies to an unreleased version of Crossplane. It is strongly recommended that you only use official releases of Crossplane, as unreleased versions are subject to changes and incompatibilities that will not be supported in the official releases.

If you are using an official release version of Crossplane, you should refer to the documentation for your specific version.

Documentation for other releases can be found by using the version selector in the top right of any doc page.

Release Cycle

Starting with the v1.0.0 release, Crossplane is released on an eight week cadence. A cycle is comprised of three general stages:

This results in six releases per year, with the most recent three releases being maintained at any given time. When a new release is cut, the fourth most recent release reaches end of life (EOL). Users can expect any given release to be maintained for six months.

Definition of Maintenance

The Crossplane community defines maintenance in that relevant bug fixes that are merged to the main development branch will be eligible to be back-ported to the release branch of any currently maintained version, and patch releases will be cut appropriately. It is also possible that a fix may be merged directly to the release branch if no longer applicable on the main development branch. Maintenance does not indicate any SLA on response time for user support in the form of Slack messages or issues, but problems will be addressed on a best effort basis by maintainers and contributors for currently maintained releases.

Patch Releases

This policy is subject to change in the future.

Patch releases are cut for currently maintained minor versions on an as-needed basis. Any critical back-ported fixes will be included in a patch release as soon as possible after merge.

Pre-Releases

This policy is subject to change in the future.

Alpha, Beta, and RC releases are cut for an upcoming release on an as-needed basis. As a policy, at least one pre-release will be cut prior to any minor release. Pre-releases will not be made on release branches.

Provider Releases

The Crossplane release cycle is not required to be adhered to by any other Crossplane projects, but a similar cadence is encouraged. Maintainers listed in each repository’s OWNERS.md file are responsible for determining and publishing the release cycle for their project.

Release Stages

The following stages are the main milestones in a Crossplane release.

Active Development

During active development, any code that meets the requisite criteria (i.e. passing appropriate tests, approved by a maintainer, etc.) will be merged into the main development branch. At present, there is no requirement to formally submit an enhancement proposal prior to the start of the release cycle, but contributors are encouraged to open an issue and gather feedback before starting work on a major implementation (see CONTRIBUTING.md for more information).

Feature Freeze

During feature freeze, no new functionality should be merged into the main development branch. Bug fixes, documentation changes, and non-critical changes may be made. In the case that a new feature is deemed absolutely necessary for a release, the Crossplane maintainers will weigh the impact of the change and make a decision on whether it should be included.

Code Freeze

During code freeze, there should be no changes merged to the main development branch with the following exceptions: