sigs.k8s.io/cluster-api-provider-aws@v1.5.5/docs/book/src/topics/reference/versions.md (about)

     1  # CAPA Version Support
     2  
     3  ## Release Versioning
     4  
     5  CAPA follows the [semantic versionining][semver] specification:
     6  
     7  MAJOR version release for incompatible API changes, 
     8  MINOR version release for backwards compatible feature additions, 
     9  and PATCH version release for only bug fixes.
    10  
    11  **Example versions:**
    12  
    13  - Minor release: `v0.1.0`
    14  - Patch release: `v0.1.1`
    15  - Major release: `v1.0.0`
    16  
    17  
    18  ## Compatibility with Cluster API Versions
    19  
    20  CAPA's versions are compatible with the following versions of Cluster API
    21  
    22  |     API Version              | Cluster API v1alpha3 (v0.3) | Cluster API v1alpha4 (v0.4) |
    23  | ---------------------------- | --------------------------- | --------------------------- |
    24  | AWS Provider v1alpha3 (v0.6) | ✓                           |                             |
    25  | AWS Provider v1alpha4 (v0.7) |                             | ✓                           |
    26  
    27  
    28  CAPA v1beta1 versions are not released in lock-step with Cluster API releases.
    29  Multiple CAPA minor releases can use the same Cluster API minor release.
    30  
    31  For compatibility, check the release notes [here](https://github.com/kubernetes-sigs/cluster-api-provider-aws/releases/) to see which v1beta1 Cluster API version each CAPA version is compatible with.
    32  
    33  For example:
    34  - CAPA v1.0.x, v1.1.x, v1.2.x is compatible with Cluster API v1.0.x
    35  - CAPA v1.3.x is compatible with Cluster API v1.1.x
    36  
    37  ## End-of-Life Timeline
    38  
    39  CAPA team maintains branches for **v1.x (v1beta1)**, **v0.7 (v1alpha4)**, and **v0.6 (v1alpha3)**.
    40  
    41  CAPA branches follow their compatible Cluster API branch EOL date.
    42  
    43  | API Version   | Branch      | Supported Until |
    44  | ------------- |-------------|-----------------|
    45  | **v1alpha4**  | release-0.7 | 2022-04-06      |
    46  | **v1alpha3**  | release-0.6 | 2022-02-23      |
    47  
    48  ## Compatibility with Kubernetes Versions
    49  
    50   CAPA API versions support all Kubernetes versions that is supported by its compatible Cluster API version:
    51  
    52  |     API Versions             | CAPI v1alpha3 (v0.3) | CAPI v1alpha4 (v0.4) | CAPI v1beta1 (v1.x) |
    53  | ---------------------------- | --------------- | --------------- | -------------- |
    54  | CAPA v1alpha3 (v0.6)         | ✓               |                 |                |
    55  | CAPA v1alpha4 (v0.7)         |                 | ✓               |                |
    56  | CAPA v1beta1 (v1.x)          |                 |                 | ✓              |
    57  
    58  
    59  (See [Kubernetes support matrix][cluster-api-supported-v] of Cluster API versions).
    60  
    61  [cluster-api-supported-v]: https://cluster-api.sigs.k8s.io/reference/versions.html
    62  [semver]: https://semver.org/#semantic-versioning-200