Oracle Cloud Infrastructure Documentation

Updating an OKE Cluster

On Compute Cloud@Customer, when you update an OKE cluster, you can change the cluster name, Kubernetes version, and tags.

Note

If you set or modify any of the following tags, the new values are ignored: SSH key (OraclePCA.sshkey), number of nodes (OraclePCA.cpNodeCount), node shape (OraclePCA.cpNodeShape), or node shape configuration (OraclePCA.cpNodeShapeConfig). These values can be set only when you create the cluster.

    1. In the Compute Cloud@Customer Console navigation menu, click Containers, then click Kubernetes Clusters.

    2. Click the name of the cluster that you want to update.

    3. At the top of the cluster details page, click Edit.

      Don't specify values for the OraclePCA-OKE.cluster_id defined tag or for the ClusterResourceIdentifier free-form tag. These tag values are system-generated and only applied to nodes (instances), not to the cluster resource.

    4. When you're finished making changes, click Save Changes.

    5. If a Kubernetes version update is available, a link labeled "Upgrade Available" is displayed next to the Kubernetes Version number on the cluster details page. Click that link to display a drop-down menu of versions that you can select.

  • Use the oci ce cluster update command and required parameters to update the details of a cluster.

    oci ce cluster update --cluster-id <cluster_OCID> [OPTIONS]

    1. Get the OCID of the cluster that you want to update: oci ce cluster list

    2. Run the update cluster command.

      If you specify the --defined-tags or --freeform-tags options, don't specify values for the OraclePCA-OKE.cluster_id defined tag or for the ClusterResourceIdentifier free-form tag. These tag values are system-generated and only applied to nodes (instances), not to the cluster resource.

      Example:

      $ oci ce cluster update --cluster-id ocid1.cluster.unique_ID \
--kubernetes-version newer_kubernetes_version --name new_cluster_name

      For the value of the --kubernetes-version option, check Supported Versions of Kubernetes.

    For a complete list of CLI commands, flags, and options, see the Command Line Reference.

  • Use the UpdateCluster operation to update the details of a cluster.

    For information about using the API and signing requests, see REST APIs and Security Credentials. For information about SDKs, see Software Development Kits and Command Line Interface.