All Products
Search
Document Center

E-MapReduce:Use cluster templates

Last Updated:Dec 05, 2025

You can use an EMR cluster template to save cluster configurations, such as software versions and instance types. This lets you create clusters with identical configurations in a single click, avoiding repetitive operations. This feature is ideal for rapidly deploying test or production environments, as it significantly improves efficiency and ensures configuration consistency.

Features

  • Configuration persistence: All cluster configuration items except for the password are saved.

  • Quick deployment: You can create a cluster from a template in just three clicks.

  • Resource grouping: You can use resource groups to manage templates in isolation across projects.

Limitations

  • Configuration limits:

    • Cluster passwords cannot be saved. You must use key pairs for authentication.

    • Instance resources are not locked. You can adjust the configuration when you create a cluster from the template.

  • Quantity limit: You can create a maximum of 30 cluster templates per region.

Operation Guide

Create a cluster template

  1. Go to the Manage Cluster Templates page.

    1. Log on to the EMR console. In the left-side navigation pane, click EMR on ECS.

    2. In the top menu bar, select the required region and resource group.

    3. On the EMR on ECS page, click Manage Cluster Templates in the upper-right corner.image

  2. In the Manage Cluster Templates panel, click Create Template.

  3. On the Cluster Template page, in the Confirm Configuration step, enter a Cluster Template Name, select a Cluster Template Resource Group, and then click Create Cluster Template.

    Note
    • The parameters are the same as those for creating a cluster. For more information, see Create a cluster.

    • Cluster Template Resource Group: Select an existing resource group or click Create Resource Group to create a new one. This lets you manage templates by group.

    The Manage Cluster Templates panel displays the cluster templates for the current region and resource group.

    Parameter

    Description

    Template ID

    The ID is automatically generated by the system.

    Template Name

    The custom name of the cluster template.

    Created At

    The time when the cluster template was created.

    Last Modification Time

    The time when the template was last modified and saved.

    Actions

    • Create Cluster: Create a cluster based on the configurations of the template.

    • Edit: Modify the configurations in the cluster template.

    • Copy: Create a copy of the cluster template.

    • Delete: Delete the target cluster template.

Create a cluster from a template

  1. In the Manage Cluster Templates panel, find the target cluster template and click Create Cluster in the Actions column.

  2. In the Create Cluster dialog box, click OK.

    Note

    If you create a subscription cluster, you must find the new cluster on the EMR on ECS page and complete the payment before the cluster creation process can start.

  3. On the EMR on ECS page, you can view the newly created EMR cluster. The default cluster name is $Template name$ + Timestamp.

  4. If a template uses an unpublished EMR version, you must edit the template to select an active version before you can use it to create a cluster.

FAQ

  • Does the new console support creating cluster templates for earlier versions of Hadoop?

    No. You can create cluster templates only for the versions that are supported by the new console.

  • Can I configure a custom password?

    No. For security reasons, templates require key pair authentication.

  • Can I modify the instance types in a template?

    Yes, you can. You can overwrite the instance configurations in the template when you create a cluster.

References

For information about how to create a resource group, see Create a resource group.