Oracle Cloud Infrastructure Documentation

Attaching a Load Balancer to an Instance Pool

Attach a load balancer or network load balancer to an instance pool.

If you choose to associate (attach) a load balancer or network load balancer with an instance pool, then when you add an instance to the instance pool, the instance is automatically added to the load balancer's or network load balancer's backend set . After the instance reaches a healthy state (the instance is listening on the configured port number), incoming traffic is automatically routed to the new instance. For background information about the Load Balancer service, see Overview of Load Balancer.

    1. You must have a load balancer or network load balancer and backend set to associate with the instance pool. Open the navigation menu and click Compute. Under Compute, click Instance Pools.
    2. In the List scope section, select the compartment that contains the instance pool that you want to update.
    3. Click the name of the instance pool to which you want to attach a load balancer or network load balancer to display the details page.
    4. In the Resources section, click Load balancers.
    5. Click Attach a load balancer.
    6. Specify the load balancer type that you want to associate with the instance pool, and then enter the following values:
      • Load balancer: The load balancer or network load balancer to associate with the instance pool.
      • Backend set: The name of the backend set on the load balancer or network load balancer to add instances to.
      • Port: The server port on the instances to which the load balancer or network load balancer must direct traffic. This value applies to all instances that use this load balancer or network load balancer attachment.
      • VNIC: The VNIC  to use when adding the instance to the backend set. Instances that belong to a backend set are also called backend servers. The private IP address is used. This value applies to all instances that use this load balancer or network load balancer attachment.
    7. To associate additional load balancers and network load balancers with the instance pool, click + Another load balancer and repeat the previous steps.
    8. Click Attach.

  • Use the instance-pool attach-lb command to attach a load balancer to an instance pool.

    oci compute-management instance-pool attach-lb --backend-set-name <NAME> --instance-pool-id <INSTANCE_POOL_OCID> --load-balancer-id <LOAD_BALANCER_OCID> --port <PORT> --vnic-selection <PrimaryVnic_OR_displayName>

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

  • Use the AttachLoadBalancer operation to attach a load balancer to an instance pool.