sigs.k8s.io/cluster-api@v1.6.3/docs/book/src/tasks/upgrading-cluster-api-versions.md (about)

     1  # Upgrading Cluster API components
     2  
     3  ## When to upgrade
     4  
     5  In general, it's recommended to upgrade to the latest version of Cluster API to take advantage of bug fixes, new
     6  features and improvements.
     7  
     8  ## Considerations
     9  
    10  If moving between different API versions, there may be additional tasks that you need to complete. See below for
    11  detailed instructions.
    12  
    13  Ensure that the version of Cluster API is compatible with the Kubernetes version of the management cluster.
    14  
    15  ## Upgrading to newer versions of 1.0.x
    16  
    17  Use [clusterctl to upgrade between versions of Cluster API 1.0.x](../clusterctl/commands/upgrade.md).
    18  
    19  ## Upgrading from Cluster API v1alpha3 (0.3.x) to Cluster API v1beta1 (1.0.x)
    20  
    21  For detailed information about the changes from `v1alpha3` to `v1beta1`, please refer to the [Cluster API v1alpha3 compared to v1alpha4 section] and the [Cluster API v1alpha4 compared to v1beta1 section].
    22  
    23  Use [clusterctl to upgrade from Cluster API v0.3.x to Cluster API 1.0.x](../clusterctl/commands/upgrade.md).
    24  
    25  You should now be able to manage your resources using the `v1beta1` version of the Cluster API components.
    26  
    27  ## Upgrading from Cluster API v1alpha4 (0.4.x) to Cluster API v1beta1 (1.0.x)
    28  
    29  For detailed information about the changes from `v1alpha4` to `v1beta1`, please refer to the [Cluster API v1alpha4 compared to v1beta1 section].
    30  
    31  Use [clusterctl to upgrade from Cluster API v0.4.x to Cluster API 1.0.x](../clusterctl/commands/upgrade.md).
    32  
    33  You should now be able to manage your resources using the `v1alpha4` version of the Cluster API components.
    34  
    35  <!-- links -->
    36  [components]: ../reference/glossary.md#provider-components
    37  [management cluster]: ../reference/glossary.md#management-cluster
    38  [Cluster API v1alpha3 compared to v1alpha4 section]: ../developer/providers/migrations/v0.3-to-v0.4.md
    39  [Cluster API v1alpha4 compared to v1beta1 section]: ../developer/providers/migrations/v0.4-to-v1.0.md