Oracle Cloud Infrastructure Documentation

Updating the Instance Configuration for a Cluster Network with Instance Pools

Update the instance configuration that a cluster network's underlying instance pool uses when creating instances.

To update the instance configuration for a cluster network, do either of the following:

  • Create a new instance configuration with the settings you want and then attach the new instance configuration to the cluster network.

    If you want the instances in the cluster network to use the settings from the new instance configuration, such as a new shape, then detach the existing instances from the cluster network and provision new instances.

    Note

    When you detach instances from a cluster network, the existing instances are detached before new instances are provisioned. Depending on your requirements, you might want to increase the size of the cluster network before detaching instances.
  • If you only want to update the display name or tags of an existing instance configuration, you can update the cluster network's existing instance configuration. For any other updates, create and then attach the new instance configuration with the settings that you want to use.
Note

For information about permissions and prerequisites, see Required IAM Policy and Before You Begin.

To update the instance configuration that a cluster network uses, first you create an instance configuration with the settings that you want (if such a configuration doesn't already exist), and then you attach the new instance configuration to the cluster network, as described in the following steps.

If you want the instances in the cluster network to use the settings from the new instance configuration, such as a new shape, then detach the existing instances from the cluster network and provision new instances.
Note

When you detach instances from a cluster network, the existing instances are detached before new instances are provisioned. Depending on your requirements, you might want to increase the size of the cluster network before detaching instances.

If you only want to update the display name or tags of an existing instance configuration, then you can update the cluster network's existing instance configuration. For any other updates, create and then attach the new instance configuration with the settings that you want to use.

  • To attach a new instance configuration to a cluster network:

    1. On the Compute Cluster Networks list page, select the cluster network that you want to manage. If you need help finding the list page, see Listing Cluster Networks.
    2. Select Edit.
    3. Select the instance configuration from the Instance configuration menu to use when creating instances in the cluster network's instance pool.
    4. Select Save changes.

  • Use the cluster-network update command to update the instance configuration used by a cluster network:

    oci compute-management cluster-network update  --from-json <file://path/to/file.json>

    <file://path/to/file.json> is the path to a JSON file that defines the instance details. For information about how to generate an example of the JSON file, see Advanced JSON Options.

    For a complete list of flags and variable options for the Compute service CLI commands, see the command line reference for Compute.

  • For information about using the API and signing requests, see REST API documentation and Security Credentials. For information about SDKs, see SDKs and the CLI.

    To update the instance configuration used by a cluster network, use the following API operation: