Getting started with Instance Groups

Before you start

Go to the Yandex.Cloud management console and select the folder where you want to perform the operations. If there is no such folder, create one:

  1. Click Create folder in the Home page of the management console.

  2. Enter the folder 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 can't be a hyphen. The maximum length of the name is 63 characters.

  3. Select Create a default network. A network is created with subnets in each availability zone.

  4. Click Create folder.

If you don't have the Yandex.Cloud command line interface yet, install it.

  1. See a description of the create folder command:

    $ yc resource-manager folder create --help
    
  2. Create a new folder:

    • with a name and without a description:

      $ yc resource-manager folder create \
          --name new-folder
      

      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 can't be a hyphen. The maximum length of the name is 63 characters.

    • with a name and description:

      $ yc resource-manager folder create \
          --name new-folder \
          --description "my first folder with description"
      

To create a folder, use the create method for the Folder resource of Yandex Resource Manager.

Create your first instance group

You can create a group with an assigned number of instances. You control the group size manually. For more information, see Manually scaled groups.

Warning

When creating a group, keep the limits in mind. Not to disrupt the component Instance Groups, do not update or delete manually created resources: target group Load Balancer, virtual machines and disks. To do this, update or delete the instance group.

To create a fixed-size instance group:

  1. In the management console, select the folder where you want to create an instance group.
  2. Select Compute Cloud.
  3. On the Virtual machines page, go to the Instance groups tab.
  4. Click Create group.
  5. In the Basic parameters section, enter:
    • A group name in the Name field. The group name must be unique within the cloud.

      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 can't be a hyphen. The maximum length of the name is 63 characters.

    • A group description in the Description field.

  6. In the Allocation section, select availability zones. Cluster VMs may reside in different availability zones and regions. Learn more about the Cloud geography.
  7. In the Instance template section, click Add:
    • Select the required public image.
    • In the Disks section:
      • Select the disk type (HDD or NVME).

      • Specify the disk size.

        To add more disks, click Add disk.

    • In the Computing resources section:
      • Select the platform.
      • Specify the necessary number of vCPUs and amount of RAM.
    • In the Network settings section:
      • Select the cloud network.
      • Specify if a public IP address is required.
    • In the Access section, specify data required for accessing the VM:
      • Enter the username in the Login field.

      • In the SSH key field, paste the contents of the public key file.

        You need to create a key pair for SSH connection yourself. To generate keys, use third-party tools, such as ssh-keygen utilities on Linux and macOS or PuTTygen on Windows.

    • Click Add.
  8. In the Deployment section, specify:
    • Expansion of group size for scaling up.

    • Reduction of group size for scaling down.

    • Maximum number of instances when creating a group.

    • Maximum number of instances when deleting a group.

      For more information, see Deployment policy.

  9. In the Scalability section:
    • Select the scale type.
    • Specify the required number of instances.
  10. Click Create.