Oracle Cloud Infrastructure Documentation

Creating a Cluster Network with Instance Pools

Create a cluster network with instance pools.

Cluster networks are built on top of the instance pools feature. Most operations in the instance pool are managed directly by the cluster network, though you can resize the underlying instance pool, change the instance configuration that the pool uses to create new instances, monitor the pool, and add tags. For background information, see Cluster Networks with Instance Pools.

Tip

If you want to manage instances in the RDMA network independently of each other or use different types of instances in the network group, then use compute clusters instead.
Note

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

To determine whether capacity is available for a specific shape before you create a cluster network, use the CreateComputeCapacityReport operation.

    1. Navigate to the Compute Cluster Networks list page. If you need help finding the list page, see Listing Cluster Networks.
    2. Select Create cluster network.
    3. Name: Accept the default name or enter a name for the cluster network. It doesn't have to be unique, and you can change it later. Avoid entering confidential information.
    4. Compartment: Select the compartment in which to create the cluster network.
    5. Availability Domain: Select the availability domain in which to run the cluster network. You can select only the availability domains that have hardware that supports cluster networks.
    6. Configure networking: Specify the network that you want to use to administer the cluster network. This network is separate from the closed RDMA network between nodes within the cluster. Enter the following information:
      • Virtual cloud network: Select the virtual cloud network (VCN) for the cluster network. Change the compartment if needed.
      • Subnet: Select the subnet for the cluster network. Change the compartment if needed.
    7. Configure instance pool: Enter the following information:
      • Instance pool name: A name for the instance pool that is managed by the cluster network. Change the compartment if needed. Avoid entering confidential information.
      • Number of instances: Select the number of instances in the pool.
      • Instance configuration: Select the instance configuration to use when creating instances in the cluster network's instance pool, as described in the prerequisites. Change the compartment if needed.
    8. (Optional) Select Show tagging options to add tags to the cluster network.
      If you have permissions to create a resource, then you also have permissions to apply free-form tags to that resource. To apply a defined tag, you must have permissions to use the tag namespace. For more information about tagging, see Resource Tags. If you're not sure whether to apply tags, skip this option or ask an administrator. You can apply tags later.
    9. Select Create cluster network.

      Instances are provisioned until the required number of instances in the pool are launched, subject to the host capacity for nodes in the cluster's RDMA network.

      Tip

      To track the progress of the operation and troubleshoot errors that occur during instance creation, use the associated work request.

  • Use the cluster-network create command and required parameters to create a cluster network.

    oci compute-management cluster-network create  --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.

    Use this API operation to create a cluster network: