oci_core_cluster_network

This resource provides the Cluster Network resource in Oracle Cloud Infrastructure Core service.

Creates a cluster network with instance pools. A cluster network is a group of high performance computing (HPC), GPU, or optimized bare metal instances that are connected with an ultra low-latency remote direct memory access (RDMA) network. Cluster networks with instance pools use instance pools to manage groups of identical instances.

Use cluster networks with instance pools when you want predictable capacity for a specific number of identical instances that are managed as a group.

If you want to manage instances in the RDMA network independently of each other or use different types of instances in the network group, create a compute cluster by using the CreateComputeCluster operation.

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

Example Usage

resource "oci_core_cluster_network" "test_cluster_network" {
	#Required
	compartment_id = var.compartment_id
	instance_pools {
		#Required
		instance_configuration_id = oci_core_instance_configuration.test_instance_configuration.id
		size = var.cluster_network_instance_pools_size

		#Optional
		defined_tags = {"Operations.CostCenter"= "42"}
		display_name = var.cluster_network_instance_pools_display_name
		freeform_tags = {"Department"= "Finance"}
	}
	placement_configuration {
		#Required
		availability_domain = var.cluster_network_placement_configuration_availability_domain
		primary_vnic_subnets {
			#Required
			subnet_id = oci_core_subnet.test_subnet.id

			#Optional
			ipv6address_ipv6subnet_cidr_pair_details {

				#Optional
				ipv6subnet_cidr = var.cluster_network_placement_configuration_primary_vnic_subnets_ipv6address_ipv6subnet_cidr_pair_details_ipv6subnet_cidr
			}
			is_assign_ipv6ip = var.cluster_network_placement_configuration_primary_vnic_subnets_is_assign_ipv6ip
		}
		secondary_vnic_subnets {
			#Required
			subnet_id = oci_core_subnet.test_subnet.id

			#Optional
			display_name = var.cluster_network_placement_configuration_secondary_vnic_subnets_display_name
			ipv6address_ipv6subnet_cidr_pair_details {

				#Optional
				ipv6subnet_cidr = var.cluster_network_placement_configuration_secondary_vnic_subnets_ipv6address_ipv6subnet_cidr_pair_details_ipv6subnet_cidr
			}
			is_assign_ipv6ip = var.cluster_network_placement_configuration_secondary_vnic_subnets_is_assign_ipv6ip
		}
	}

	#Optional
	cluster_configuration {
		#Required
		hpc_island_id = oci_core_hpc_island.test_hpc_island.id

		#Optional
		network_block_ids = var.cluster_network_cluster_configuration_network_block_ids
	}
	defined_tags = {"Operations.CostCenter"= "42"}
	display_name = var.cluster_network_display_name
	freeform_tags = {"Department"= "Finance"}
}

Argument Reference

The following arguments are supported:

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

Attributes Reference

The following attributes are exported:

Timeouts

The timeouts block allows you to specify timeouts for certain operations: * create - (Defaults to 20 minutes), when creating the Cluster Network * update - (Defaults to 20 minutes), when updating the Cluster Network * delete - (Defaults to 20 minutes), when destroying the Cluster Network

Import

ClusterNetworks can be imported using the id, e.g.

$ terraform import oci_core_cluster_network.test_cluster_network "id"