Use launch templates in scaling groups
You can use an ECS launch template as the instance configuration source for a scaling group. During a scale-out, Auto Scaling creates ECS instances based on the template. This topic explains how to manage the launch template after it is specified as the instance configuration source.
Use a launch template
You can specify a launch template as the instance configuration source for a scaling group. During a scale-out, Auto Scaling creates instances based on the template's configuration.
A scaling group supports only one launch template.
Prerequisites
-
A launch template has been created. For more information, see Create an instance launch template.
-
A launch template has not been configured for the scaling group.
Procedure
Existing scaling group
-
Go to the launch template management page.
-
Log on to the Auto Scaling console.
In the left-side navigation pane, click Scaling Groups.
In the top navigation bar, select the region where Auto Scaling is activated.
-
On the Scaling Groups page, find the scaling group for which you want to manage launch templates and click View Details in the Actions column. On the details page of the scaling group, click the tab to go to the launch template management page.
-
-
On the page for managing launch templates in the scaling group, click the Edit Configuration Source button.
-
On the modify the launch template, page, select the Launch Template that you created.
ImportantYou can enable the configuration of multiple instance types by using the Extend Launch Template option. For more information, see Improve scale-out success rates by using a launch template with multiple instance types.
New scaling group
For instructions, see Method 1: Create a scaling group from a launch template.
View the launch template
You can view details about the active launch template for a scaling group, such as the instance type, billing method, and image. Follow these steps:
-
Go to the launch template management page.
-
Log on to the Auto Scaling console.
In the left-side navigation pane, click Scaling Groups.
In the top navigation bar, select the region where Auto Scaling is activated.
-
On the Scaling Groups page, find the scaling group for which you want to manage launch templates and click View Details in the Actions column. On the details page of the scaling group, click the tab to go to the launch template management page.
-
-
Find The launch template used by the current scaling group, and click View Details in the Actions column. The launch template information panel appears. You can view the information about the launch template that is used by the current scaling group in this panel.
Modify the launch template
In a scaling group, you can only modify the template's effective version and configure the extended launch template properties. Follow these steps:
To modify other launch template details, create a new template version in the ECS console. For instructions, see Create a new version of a launch template.
-
Go to the launch template management page.
-
Log on to the Auto Scaling console.
In the left-side navigation pane, click Scaling Groups.
In the top navigation bar, select the region where Auto Scaling is activated.
-
On the Scaling Groups page, find the scaling group for which you want to manage launch templates and click View Details in the Actions column. On the details page of the scaling group, click the tab to go to the launch template management page.
-
-
Find The launch template used by the current scaling group and click Modify in the Actions column. On the modify the launch template, page, modify the launch template as needed.
NoteYou can use the Extend Launch Template option to enable multiple instance types. For more information, see Configure multiple instance types based on a launch template to improve the scale-out success rate.
Related topics
-
To programmatically modify the active launch template for a scaling group, see the ModifyScalingGroup API operation.