Contact UsGet started

Creating a fixed-size instance group with a network load balancer

Written by
Updated at December 20, 2024

You can create a fixed-size instance group integrated with Yandex Network Load Balancer. A Network Load Balancer target group will be automatically created along with the instance group. You can attach it to your load balancer and distribute the load across the instances in the group at the network level. For more information, see Integrating an instance group with Network Load Balancer or Application Load Balancer.

Alert

When creating instance groups, keep the limits in mind. Not to disrupt the component Instance Groups, do not update or delete manually created resources: target group Network Load Balancer, VMs, and disks. Instead of this, change or delete the entire group.

By default, all operations in Instance Groups are performed on behalf of a service account. If you don't have a service account, create one.

If you are using a Windows image, reset the password after creating a VM.

To create an instance group with a network load balancer:

  1. In the management console, select the folder to create your instance group in.
  2. In the list of services, select Compute Cloud.
  3. In the left-hand panel, select Instance groups.
  4. Click Create group of virtual machines.
  5. Under Basic parameters:

    • Enter a name and description of the instance group. The naming requirements are as follows:

      • The name must be from 3 to 63 characters long.
      • It may contain lowercase Latin letters, numbers, and hyphens.
      • The first character must be a letter and the last character cannot be a hyphen.

      Note

      The VM name is used to generate an internal FQDN only once: when creating a VM. If the internal FQDN is important to you, choose an appropriate name for the VM at the creation stage.

    • Select a service account from the list or create a new one. To be able to create, update, and delete VM instances in the instance group, assign the editor role to the service account. By default, all operations with instance groups are performed on behalf of the service account.

      You cannot delete a service account while it is linked to an instance group.

    • Enable the Deletion protection option, if needed. You cannot delete a group with this option enabled.

  6. Under Allocation, select the required ones in the Availability zone field. Instance groups may reside in different availability zones.
  7. Under Instance template, click Define to configure a basic instance:

    • Under General information, enter a description for the template.

    • Under Boot disk image, select a system to be deployed on the VM instance's boot disk.

    • Under Disks and file storages:

      • Select the disk type.
      • Specify the disk size.
      • To add more disks, click Add disk.

    • Under Computing resources:

      • Choose a platform.
      • Enter the required number of vCPUs, guaranteed vCPU performance, and the amount of RAM.

      • If necessary, make your VM preemptible.

        When creating a preemptible instance group, keep in mind that the virtual machines will terminate after 24 hours of continuous operation or earlier. It's possible that Instance Groups won't be able to restart them immediately due to insufficient resources. This may occur in the event of a drastic increase of the computing resource utilization in Yandex Cloud.

      • (Optional) Enable a software-accelerated network.

    • Under Network settings:

      • Enter a subnet ID or select a cloud network from the list.
        If you do not have a network, click Create a network to create one:

        • In the window that opens, enter a name for your network.
        • (Optional) To automatically create subnets, select the Create subnets option.
        • Click Create network.

        Each network must have at least one subnet. If there is no subnet, create one by selecting Create subnet.

      • In the Public address field, choose a method for assigning an IP address:

        • Auto: Assign a random IP address from the Yandex Cloud IP pool.
        • No address: Do not assign a public IP address.

      • Select the appropriate security groups.

      • (Optional) Create records for the VM in the DNS zone:

        • Expand the DNS settings for internal addresses section and click Add record.
        • Specify the zone, FQDN, and TTL for the record. When setting the FQDN, you can select Detect automatically for the zone.
          You can add multiple records to internal DNS zones. For more information, see Cloud DNS integration with Compute Cloud.

    • Under Access, specify the data for access to the instance:

      • Select a service account to link to the instance.
      • If you selected a Linux image, fill out the fields Login and SSH key. For a key, use the contents of the public key file.
      • Select Access to serial console, if needed.

    • Click Save.

  8. Under Allow when creating and updating:

    • In the Add above target value field, specify the number of instances you can exceed the group size by.

      When bringing the number of VMs in the group to the target value, VMs created in excess of the target under the max_expansion quota can remain in the group, while those that existed in the group before may be deleted.

    • In the field Reduce below target value, specify the number of instances you can decrease the group size by.

    • In the Create simultaneously field, specify how many instances can be created at the same time.

    • In Startup duration, specify the period after which the VM instance will start receiving the load.

    • In the Stop simultaneously field, specify how many instances can be stopped at the same time.

    • In the Stop VMs by strategy field, specify one of the strategies:

      • Proactive: Compute Cloud itself chooses which instances to stop when updating or scaling down the group.
      • Opportunistic: Compute Cloud waits for the instances to stop on their own or be stopped by the user.
  9. Under Scaling:
    • Select the Fixed scaling type.
    • Specify the instance group size.
  10. Under Integration with Network Load Balancer, enable the Create target group option.
  11. Specify the target group settings. For more information, see Settings for integration with Network Load Balancer.
  12. If needed, enable the Health checks to get information about the state of instances and their automatic recovery on failure.
    • In the Type field, select the protocol for the health checks: HTTP or TCP.
    • In the Path field (for the HTTP type), specify the URL path for the instance group to send HTTP check requests.
    • Under Port, specify the port number from 1 to 32767 on which the instance group will send health check requests.
    • In the Timeout in sec field, specify the response waiting time from 1 to 60 seconds.
    • In the Interval in sec field, specify the interval between the repeat checks from 1 to 60 seconds. The interval must be at least 1 second longer than the waiting time.
    • In the Healthy threshold field, specify the number of successful health checks required for the instance to be considered healthy.
    • In the Unhealthy threshold field, specify the number of failed health checks for the instance to be considered unhealthy.
  13. Under User-defined variables, enter the Key-Value pairs, if needed.
  14. Click Create.

If you do not have the Yandex Cloud command line interface yet, install and initialize it.

The folder specified in the CLI profile is used by default. You can specify a different folder using the --folder-name or --folder-id parameter.

  1. View the description of the CLI command to create an instance group:

    yc compute instance-group create --help

  2. Check whether the folder contains any networks:

    yc vpc network list

    If there are none, create a network.

  3. Select one of the Yandex Cloud Marketplace public images, e.g., CentOS 7.

    To get a list of available images using the CLI, run this command:

    yc compute image list --folder-id standard-images

    Result:

    +----------------------+-------------------------------------+--------------------------+----------------------+--------+
|          ID          |                NAME                 |          FAMILY          |     PRODUCT IDS      | STATUS |
+----------------------+-------------------------------------+--------------------------+----------------------+--------+
...
| fdvk34al8k5n******** | centos-7-1549279494                 | centos-7                 | dqni65lfhvv2******** | READY  |
| fdv7ooobjfl3******** | windows-2016-gvlk-1548913814        | windows-2016-gvlk        | dqnnc72gj2is******** | READY  |
| fdv4f5kv5cvf******** | ubuntu-1604-lts-1549457823          | ubuntu-1604-lts          | dqnnb6dc7640******** | READY  |
...
+----------------------+-------------------------------------+--------------------------+----------------------+--------+

    Where:

    • ID: Image ID.

    • NAME: Image name.

    • FAMILY: ID of the image family the image belongs to.

    • PRODUCT IDS: IDs of Yandex Cloud Marketplace products associated with the image.

    • STATUS: Current status of the image. It may take one of the following values:

      • STATUS_UNSPECIFIED: Image status is not defined.
      • CREATING: Image is being created.
      • READY: Image is ready to use.
      • ERROR: You cannot use the image due to an issue.
      • DELETING: Image is being deleted.

  4. Create a YAML file with any name, e.g., specification.yaml.

  5. In the created file, indicate the following:

    • General information about the instance group:

      name: first-fixed-group-with-balancer
service_account_id: <service_account_ID>
description: "This instance group was created using a YAML configuration file."

      Where:

      • name: Instance group name. The name must be unique within the folder. The name may contain lowercase Latin letters, numbers, and hyphens. The first character must be a letter. The last character cannot be a hyphen. The name may be up to 63 characters long.

      • service_account_id: Service account ID.

        You cannot delete a service account while it is linked to an instance group.

      • description: Instance group description.

    • Instance template, such as:

      instance_template:
  platform_id: standard-v3
  resources_spec:
    memory: 2g
    cores: 2
  boot_disk_spec:
    mode: READ_WRITE
    disk_spec:
      image_id: fdvk34al8k5n********
      type_id: network-hdd
      size: 32g
  network_interface_specs:
    - network_id: c64mknqgnd8a********
      primary_v4_address_spec: {}
      security_group_ids:
        - enps0ar5s3ti********
  scheduling_policy:
    preemptible: false
  placement_policy:
    placement_group_id: rmppvhrgm77g********

      By default, the disk size is specified in bytes. You can specify a different unit of measurement using the applicable suffix.

      Suffix Prefix and multiplier Example
      k kilo- (210) 640k = 640 × 210 = 655360
      m mega- (220) 48m = 48 × 220 = 50331648
      g giga- (230) 10g = 10 × 230 = 10737418240
      t tera- (240) 4t = 4 × 240 = 4398046511104
      p peta- (250) 2p = 2 × 250 = 2251799813685248

      Where:

      • platform_id: Platform ID.

      • memory: Amount of memory (RAM).

      • cores: Number of processor cores (vCPUs).

      • mode: Disk access mode.

        • READ_ONLY: Read-only access.
        • READ_WRITE: Read/write access.

      • image_id: Public image ID. You can view image IDs in the management console when creating a VM or in Cloud Marketplace on the image page under Product IDs.

      • type_id: Disk type.

      • size: Disk size.

      • network_id: default-net network ID.

      • primary_v4_address_spec: IPv4 specification. You can allow public access to the group's instances by specifying the IP version for the public IP address. For more information, see Template description in a YAML file.

      • security_group_ids: List of security group IDs.

      • scheduling_policy: Scheduling policy configuration.

      • preemptible: Flag for creating preemptible instances.

        • true: Create a preemptible instance.
        • false (default): Create a regular instance.

        When creating a preemptible instance group, keep in mind that the VM instances will terminate after 24 hours of continuous operation or earlier. VMs may not be able to restart immediately due to insufficient resources. This may occur in the event of a sharp increase in the use of Yandex Cloud computing resources.

      • placement_policy (optional): Instance placement group parameters:

        • placement_group_id: Placement group ID.

    • Policies:

      deploy_policy:
  max_unavailable: 1
  max_expansion: 0
scale_policy:
  fixed_scale:
    size: 3
allocation_policy:
  zones:
    - zone_id: ru-central1-a
      instance_tags_pool:
      - first
      - second
      - third

      Where:

    • Network Load Balancer target group:

      load_balancer_spec:
  target_group_spec:
    name: first-target-group

      Where:

      • target_group_spec: Specification of the Network Load Balancer target group linked with the instance group.
      • name: Name for the Network Load Balancer target group. The name must be unique within the folder. The name may contain lowercase Latin letters, numbers, and hyphens. The first character must be a letter. The last character cannot be a hyphen. The name may be up to 63 characters long.
        For more information about target group settings, see Settings for integration with Network Load Balancer.

    Full code for the specification.yaml file:

    name: first-fixed-group-with-balancer
service_account_id: <service_account_ID>
description: "This instance group was created using a YAML configuration file."
instance_template:
  platform_id: standard-v3
  resources_spec:
    memory: 2g
    cores: 2
  boot_disk_spec:
    mode: READ_WRITE
    disk_spec:
      image_id: fdvk34al8k5n********
      type_id: network-hdd
      size: 32g
  network_interface_specs:
    - network_id: c64mknqgnd8a********
      primary_v4_address_spec: {}
      security_group_ids:
        - enps0ar5s3ti********
  placement_policy:
    placement_group_id: rmppvhrgm77g********
  deploy_policy:
    max_unavailable: 1
    max_expansion: 0
  scale_policy:
    fixed_scale:
      size: 3
  allocation_policy:
    zones:
      - zone_id: ru-central1-a
        instance_tags_pool:
        - first
        - second
        - third
  load_balancer_spec:
    target_group_spec:
      name: first-target-group

  6. Create an instance group in the default folder:

    yc compute instance-group create --file specification.yaml

    This command creates a group of three same-type instances with the following configuration:

    • Name: first-fixed-group-with-balancer
    • OS: CentOS 7
    • Network: default-net
    • Availability zone: ru-central1-a
    • vCPUs: 2; RAM: 2 GB
    • Network HDD: 32 GB
    • Target group: first-target-group

  7. Create a network load balancer and add first-target-group to it.

If you don't have Terraform, install it and configure the Yandex Cloud provider.

  1. In the configuration file, describe the parameters of the resources you want to create:

    resource "yandex_iam_service_account" "ig-sa" {
  name        = "ig-sa"
  description = "Service account for managing an instance group."
}

resource "yandex_resourcemanager_folder_iam_member" "editor" {
  folder_id = "<folder_ID>"
  role      = "editor"
  member    = "serviceAccount:${yandex_iam_service_account.ig-sa.id}"
}

resource "yandex_compute_instance_group" "ig-1" {
  name                = "fixed-ig-with-balancer"
  folder_id           = "<folder_ID>"
  service_account_id  = "${yandex_iam_service_account.ig-sa.id}"
  deletion_protection = "<deletion_protection>"
  instance_template {
    platform_id = "standard-v3"
    resources {
      memory = <RAM_size_GB>
      cores  = <number_of_vCPU_cores>
    }

    boot_disk {
      mode = "READ_WRITE"
      initialize_params {
        image_id = "<image_ID>"
      }
    }

    network_interface {
      network_id         = "${yandex_vpc_network.network-1.id}"
      subnet_ids         = ["${yandex_vpc_subnet.subnet-1.id}"]
      security_group_ids = ["<list_of_security_group_IDs>"]
    }

    metadata = {
      ssh-keys = "<username>:<SSH_key_contents>"
    }
  }

  scale_policy {
    fixed_scale {
      size = <number_of_VMs_in_group>
    }
  }

  allocation_policy {
    zones = ["ru-central1-a"]
  }

  deploy_policy {
    max_unavailable = 1
    max_expansion   = 0
  }

  load_balancer {
    target_group_name        = "target-group"
    target_group_description = "Network Load Balancer target group"
  }
}

resource "yandex_lb_network_load_balancer" "lb-1" {
  name = "network-load-balancer-1"

  listener {
    name = "network-load-balancer-1-listener"
    port = 80
    external_address_spec {
      ip_version = "ipv4"
    }
  }

  attached_target_group {
    target_group_id = yandex_compute_instance_group.ig-1.load_balancer.0.target_group_id

    healthcheck {
      name = "http"
      http_options {
        port = 80
        path = "/index.html"
      }
    }
  }
}

resource "yandex_vpc_network" "network-1" {
  name = "network1"
}

resource "yandex_vpc_subnet" "subnet-1" {
  name           = "subnet1"
  zone           = "ru-central1-a"
  network_id     = "${yandex_vpc_network.network-1.id}"
  v4_cidr_blocks = ["192.168.10.0/24"]
}

    Where:

    • yandex_iam_service_account: Service account description. All operations with instance groups are performed on behalf of the service account.

      You cannot delete a service account while it is linked to an instance group.

    • yandex_resourcemanager_folder_iam_member: Description of access permissions to the folder the service account belongs to. To be able to create, update, and delete VM instances in the instance group, assign the editor role to the service account.

    • yandex_compute_instance_group: Instance group description:

      • General information about the instance group:
        • name: Instance group name.
        • folder_id: Folder ID.
        • service_account_id: Service account ID.
        • deletion_protection: Instance group protection against deletion, true or false. You cannot delete an instance group with this option enabled. The default value is false.
      • VM template:
        • platform_id: Platform.
        • resources: Number of vCPU cores and RAM available to the VM. The values must match the selected platform.
        • boot_disk: Boot disk settings.
          • ID of the selected image. You can get the image ID from the list of public images.
          • Disk access mode: READ_ONLY or READ_WRITE.
        • network_interface: Network configurations. Specify the IDs of your network, subnet, and security groups.
        • metadata: In metadata, provide the public key for SSH access to the VM. For more information, see VM metadata.
      • Policies:
      • Network Load Balancer target group:
        • target_group_name: Name of the Network Load Balancer target group.
        • target_group_description: Description of the Network Load Balancer target group.
          For more information about target group settings, see Settings for integration with Network Load Balancer.

    • yandex_vpc_network: Description of the cloud network.

    • yandex_vpc_subnet: Description of the subnet the instance group will connect to.

    • yandex_lb_network_load_balancer: Description of the Network Load Balancer network load balancer the target group will connect to.

    Note

    If you already have suitable resources, such as a service account, cloud network, subnet, and network load balancer, you do not need to describe them again. Use their names and IDs in the appropriate parameters.

    For more information about the resources you can create with Terraform, see the provider documentation.

  2. Create resources:

    1. In the terminal, change to the folder where you edited the configuration file.

    2. Make sure the configuration file is correct using the command:

      terraform validate

      If the configuration is correct, the following message is returned:

      Success! The configuration is valid.

    3. Run the command:

      terraform plan

      The terminal will display a list of resources with parameters. No changes are made at this step. If the configuration contains errors, Terraform will point them out.

    4. Apply the configuration changes:

      terraform apply

    5. Confirm the changes: type yes in the terminal and press Enter.

    All the resources you need will then be created in the specified folder. You can check the new resources and their settings using the management console.

Use the create REST API method for the InstanceGroup resource or the InstanceGroupService/Create gRPC API call.

Previous
Creating a fixed-size instance group
Next
Creating a fixed-size instance group with an L7 load balancer