Creating a cluster network interface

Creating a cluster network interface in the UI

To create a cluster network interface within a network cluster in the UI, follow these steps:

1. From your browser, open the IBM Cloud console and log in to your account.

2. Select the Navigation Menu , then click Infrastructure > Network > Cluster networks.

3. On the Cluster networks for VPC page, click the link of the cluster network name where you want to create an interface. The Overview page displays.

4. Click the Interfaces tab to show the Cluster network interfaces table, then click Create +.

5. Complete the information in the Create interface side panel, then click Create.

   • Enter an interface name.

   • Select the cluster network subnet.

     A primary IP address is selected for you and is available to view after creation.

The cluster network interface is requested for use.

Creating a cluster network interface in the CLI

To create a cluster network interface in the CLI, follow these steps:

1. Set up your CLI environment.

2. Log in to your account with the CLI. After you enter the password, the system prompts for the account and region that you want to use:

   ibmcloud login --sso
   

3. Enable the following feature flag:

   export IBMCLOUD_IS_FEATURE_CLUSTER_NETWORK=true
   

4. To create a cluster network interface, enter the following command:

   ibmcloud is cluster-network-interface-create CLUSTER_NETWORK (--rip RIP | (--rip-address RIP_ADDRESS --rip-auto-delete true | false --rip-name RIP_NAME)) [--subnet SUBNET] [--vpc VPC] [--name NAME] [--output JSON] [-q, --quiet]
   

   Where:

   CLUSTER_NETWORK

   ID or name for the cluster network.

   --rip

   ID or name of the reserved IP to bind primary IP address to the cluster network interface.

   --rip-address

   The IP address of the reserved IP to bind to the cluster network interface, which must not already be reserved on the subnet.

   --rip-auto-delete

   Indicates whether this cluster network subnet reserved IP member will be automatically deleted when either target is deleted, or the cluster network subnet reserved IP is unbound. One of: true, false. (default: true).

   --rip-name

   The name of this cluster network subnet reserved IP.

   --subnet

   ID or name for the subnet.

   --vpc

   ID or name of the VPC. It is only required to specify the unique resource by name inside this VPC.

   --name

   Name of the cluster network interface.

   --output

   Specify output format, only JSON is supported. One of: JSON.

   -q, --quiet

   Suppress verbose output.

Creating a cluster network interface with the API

To create a cluster network interface with the API, follow these steps:

1. Set up your API environment with the right variables.

2. Store any additional variables to be used in the API commands; for example:

   version (string): The API version, in format YYYY-MM-DD.

3. When all variables are initiated, run the following command to create a cluster network interface:

   curl -X POST "$vpc_api_endpoint/v1/cluster_networks/$cluster_network_id/interfaces?version=$tomorrow&generation=2&maturity=development" -H "Authorization: Bearer $iam_token" -d '{
         "name": "my-cluster-network-interface",
         "subnet": {
             "id": "0767-7931845c-65c4-4b0a-80cd-7d9c1a6d7930"
         }
       }'
   

To view the complete set of cluster network APIs, see the VPC API reference.

Creating a cluster network interface with Terraform

Terraform will support this feature after it reaches General Availability (GA) and is officially released.

The following example provisions a cluster network interface by using Terraform:

resource "ibm_is_cluster_network_interface" "is_cluster_network_interface_instance" {
  cluster_network_id            = var.is_cluster_network_interface_cluster_network_id
  name                          = var.is_cluster_network_interface_name
  primary_ip {
    address = "10.1.0.6"
    name    = "my-cluster-network-subnet-reserved-ip"
  }
  subnet = "0767-7931845c-65c4-4b0a-80cd-7d9c1a6d7930"
}