Bulk provisioning instances with instance groups

Before you begin

1. Make sure that you completed the setup for your IBM Cloud® CLI environment and your IBM Cloud VPC.
2. Make sure that you have the required IBM Cloud Identity and Access Management (IAM) permissions to create instance group resources. For more information, see Managing IAM access for VPC Infrastructure Services.
3. Make sure that you created an instance template with the instance details that are used to provision like instances in your group.

Creating an instance group

After you created an instance template, you can proceed with creating an instance group. When you create the instance group, you can specify 0-1000 for the membership count. The membership count determines how many instances are provisioned in the instance group.

If you want to include a load balancer for your instance group to balance incoming requests across instances, you must create the load balancer before you create the instance group. For more information, see About application load balancers. If you attach a load balancer to your instance group, you are limited to a membership count of 50.

Gather the following information before you run the ibmcloud is instance-group-create command.

After you collect these values, use them to run the instance-group-create command. In addition, you must specify a name for the instance group.

ibmcloud is instance-group-create INSTANCE_GROUP_NAME --instance-template INSTANCE_TEMPLATE --subnets SUBNETS [--membership-count MEMBERSHIP_COUNT] [--lb LB --lb-pool LB_POOL --application-port APPLICATION_PORT] [--vpc VPC] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON] [-q, --quiet]

For example, if you create an instance group that is called my-instance-group with instance template ID 0738-c3809e5b-8d48-4629-b258-33d5b14fa84f and 100 members, your instance-group-create command would look like the following sample.

ibmcloud is instance-group-create my-instance-group --instance-template 0738-c3809e5b-8d48-4629-b258-33d5b14fa84f --subnets 0076-2249dabc-8c71-4a54-bxy7-953701ca3999,0767-173bn4aa-060b-47e7-am45-b3395a593897 --membership-count 100

Where:

• INSTANCE_GROUP_NAME is my-instance-group
• INSTANCE_TEMPLATE is 0738-c3809e5b-8d48-4629-b258-33d5b14fa84f
• SUBNETS are 0076-2249dabc-8c71-4a54-bxy7-953701ca3999 and 0767-173bn4aa-060b-47e7-am45-b3395a593897
• MEMBERSHIP_COUNT is 100

For this example, the command response looks like the following example.

ID                  r006-4f7d0010-33f5-40bf-9f21-ab5bee04fd71
Name                my-instance-group
Status              healthy
Instances           100
Instance Template   0738-c3809e5b-8d48-4629-b258-33d5b14fa84f
Subnets             Name       Subnet ID
                    subnet-1   0076-2249dabc-8c71-4a54-bxy7-953701ca3999
                    subnet-2   0767-173bn4aa-060b-47e7-am45-b3395a593897

Resource group      ID                                 Name
                    11caaa983d9c4beb82690daab08717e9   Default

For more examples of the ibmcloud is instance-group-create command, see the VPC CLI reference.

Need more help? You can run the ibmcloud is instance-group-create --help command to display help for creating an instance group.

Next steps

After your instance group is created with the number of instances you need, you can use the following commands to manage the instance group and the instance memberships of the group.

Optionally, you can set auto scaling policies for your instance group to dynamically add or remove virtual server instances from your group. For more information, see Creating an instance group for auto scaling.