Oracle Cloud Infrastructure Documentation

Creating a Cluster Placement Group

Create a cluster placement group in which you can colocate resources to support low-latency networking use cases.

  • On the Cluster placement groups list page, select Create Cluster Placement Group. If you need help finding the list page, see Listing Cluster Placement Groups.

    1. Placement Pre-check

    Fill out the Placement Pre-Check information. Specify the resources that you intend to add to the cluster placement group.

    Compute

    Select Enable Compute to select Compute options. You can select General or Configure. The following explains the two options.

    General

    Select General to create a generic Compute configuration.

    Configure

    Select Configure to specify specific shapes allowed in this cluster placement group. A maximum of 3 shapes can be configured.

    After Configure is selected, the following fields are available.

    • Shape: Select a supported shape.
    • Cores: Select the number of cores for this shape.
    • Memory: Select the amount of memory for this shape.
    • NVMe Drivers: Select the number of NVMe drivers applicable for this shape.
    • Count: Count of selected shapes to check for the available capacity. (3 maximum)

    Select Add Shape to add this shape to this cluster placement group.

    Important

    When bare metal shapes are selected, fields like Cores and Memory are grayed out as the values are fixed.

    Block

    To add Block Volume resources, under Block, select Enable Block Storage.

    Advanced Options

    If you have a unique code from the OCI account representative for the tenancy for large capacity cluster placement groups, select Advanced options, enter the code in the Unique code box.

    Complete Pre-check

    Select Next.

    2. General

    On the General page fill out the following information.

    • Name: Enter a display name for the cluster placement group. You can't change this name later. Avoid entering confidential information.
    • Description: Enter a description for the cluster placement group. Avoid entering confidential information.
    • Compartment: Select the compartment for the cluster placement group. The selected availability domain is displayed.
    • Tags: To add tags, select Tags.

      If you have permissions to create a resource, 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.

      You can also assign tags to a resource after creating it.

    • Select Next.

    Confirmation

    On the Confirmation page, confirm the details of the new cluster placement group.

    • Edit any values as needed.
    • Then, select Create to create the group.

  • Use the create command and required parameters to create a cluster placement group:

    oci cpg cluster-placement-group create --availability-domain <availability_domain> --compartment-id <compartment_OCID> --description <description_of_the_cluster_placement_group> --type <type_of_cluster_placement_group>

    You must specify either the --capabilities or --placement-instruction. You can't update the capabilities supported by the cluster placement group after you create it.

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

  • Run the CreateClusterPlacementGroup operation to create a cluster placement group.