Oracle Cloud Infrastructure Documentation

Modifying a Kubernetes Cluster

You can use Container Engine for Kubernetes to modify the node pool details of existing Kubernetes clusters.

You can change:

  • the name of the node pool
  • the number of node pools in a cluster by adding new node pools, or deleting existing node pools
  • the number of worker nodes in a node pool, and the availability domains and subnets in which to place them
  • the version of Kubernetes to run on new worker nodes

However, note that you cannot change:

  • the name of the cluster
  • the shape of existing worker nodes
  • the operating system running on existing worker nodes
  • the version of Kubernetes running on existing worker nodes
  • the master encryption key (if specified when the cluster was created)

Also note that you must not change the auto-generated names of resources that Container Engine for Kubernetes has created (such as the names of worker nodes).

Using the Console

To modify an existing Kubernetes cluster:

  1. In the Console, open the navigation menu. Under Solutions and Platform, go to Developer Services and click Container Clusters.
  2. Choose a Compartment you have permission to work in.
  3. On the Cluster List page, click the name of the cluster you want to modify.
  4. Use the buttons across the top of the Cluster page as follows:

    • If you want to download the kubeconfig configuration file for the cluster, click the Access Kubeconfig button (see Downloading a Kubeconfig File to Enable Cluster Access).
    • If you want to add a new node pool to the cluster, click the Add Node Pool button and enter details for the new node pool.
    • If you want to delete the cluster along with its master nodes and worker nodes, click the Delete Cluster button.
    • If a newer version of Kubernetes is available than the one running on the master nodes in the cluster, the Upgrade Available button is enabled. If you want to upgrade the master nodes to a newer version, click Upgrade Available (see Upgrading the Version of Kubernetes Running on Master Nodes).
  5. Use the Cluster Details tab to see information about the cluster, including:

    • The status of the cluster, and of the node pools in the cluster.
    • The cluster's OCID.
    • The Kubernetes version running on the master nodes in the cluster.
    • The address of the Kubernetes endpoint.
  6. Use the Node Pools tab to:

    • View a summary of each node pool and the worker nodes within it.
    • Change the name of a node pool by selecting Edit from the Actions menu.
    • Change the number and placement of worker nodes in a node pool by selecting Scale from the Actions menu and specifying a different number of worker nodes, different availability domains, and different regional subnets (recommended) or AD-specific subnets.
    • View and edit configuration details of specific worker nodes by selecting Show Node Details and clicking the name of the worker node.
    • Delete a node pool by selecting Delete Node Pool from the Actions menu.
  7. Use the Getting Started tab to:

Using the API

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.

Use the Update Cluster and the UpdateNodePool operations to modify an existing Kubernetes cluster.