Configure system deployment templates
editConfigure system deployment templates
editWhile you can create new deployment templates for some use cases, if the system templates generally suit your needs but just require minor changes, you may choose to configure or modify the system templates.
For example, you want to use autoscaling with the system templates, but want to modify some of the default values for autoscaling in those templates. You might want to enable autoscaling by default for new deployments, or adjust the default value of the autoscaling maximum for the hot tier.
Note that you cannot edit system templates through the UI; they may only be configured through the API.
Configure system deployment templates through the RESTful API
editThe API user must have the Platform admin
role in order to configure system templates.
-
Obtain the existing system deployment template you wish to modify. Note the
id
of the system deployment template as you will include this value in the API call to edit the template.curl -k -X GET -H "Authorization: ApiKey $ECE_API_KEY" https://COORDINATOR_HOST:12443/api/v1/deployments/templates?region=ece-region
- Edit the JSON of the system deployment template you wish to modify.
-
Make the API call to modify the deployment template. Note that the last path segment in the URL is the
id
of the system template you wish to modify. Check set deployment template API for more detail.The following example modifies the Default system deployment template (that, is the system template with
id
value ofdefault
), setting the default value ofautoscaling_enabled
totrue
and the default autoscaling maximum size of the hot tier to 4,194,304MB (64GB * 64 nodes).curl -k -X PUT -H "Authorization: ApiKey $ECE_API_KEY" https://$COORDINATOR_HOST:12443/api/v1/deployments/templates/default?region=ece-region -H 'content-type: application/json' -d '{ { "name" : "Default", "description" : "Default deployment template for clusters", "deployment_template" : { "resources" : { "elasticsearch" : [ { "ref_id" : "es-ref-id", "region" : "ece-region", "plan" : { "cluster_topology" : [ { "id" : "hot_content", "node_type" : { "master" : true, "data" : true, "ingest" : true }, "node_roles" : [ "master", "ingest", "remote_cluster_client", "data_hot", "transform", "data_content" ], "zone_count" : 1, "elasticsearch" : { "node_attributes" : { "data" : "hot" } }, "instance_configuration_id" : "data.default", "size" : { "value" : 4096, "resource" : "memory" }, "autoscaling_max" : { "value" : 4194304, "resource" : "memory" }, "topology_element_control" : { "min" : { "value" : 1024, "resource" : "memory" } } }, { "id" : "warm", "node_type" : { "master" : false, "data" : true, "ingest" : false }, "node_roles" : [ "data_warm", "remote_cluster_client" ], "zone_count" : 1, "elasticsearch" : { "node_attributes" : { "data" : "warm" } }, "instance_configuration_id" : "data.highstorage", "size" : { "value" : 0, "resource" : "memory" }, "autoscaling_max" : { "value" : 2097152, "resource" : "memory" }, "topology_element_control" : { "min" : { "value" : 0, "resource" : "memory" } } }, { "id" : "cold", "node_type" : { "master" : false, "data" : true, "ingest" : false }, "node_roles" : [ "data_cold", "remote_cluster_client" ], "zone_count" : 1, "elasticsearch" : { "node_attributes" : { "data" : "cold" } }, "instance_configuration_id" : "data.highstorage", "size" : { "value" : 0, "resource" : "memory" }, "autoscaling_max" : { "value" : 2097152, "resource" : "memory" }, "topology_element_control" : { "min" : { "value" : 0, "resource" : "memory" } } }, { "id" : "coordinating", "node_type" : { "master" : false, "data" : false, "ingest" : true }, "node_roles" : [ "ingest", "remote_cluster_client" ], "zone_count" : 1, "instance_configuration_id" : "coordinating", "size" : { "value" : 0, "resource" : "memory" }, "topology_element_control" : { "min" : { "value" : 0, "resource" : "memory" } } }, { "id" : "master", "node_type" : { "master" : true, "data" : false, "ingest" : false }, "node_roles" : [ "master", "remote_cluster_client" ], "zone_count" : 1, "instance_configuration_id" : "master", "size" : { "value" : 0, "resource" : "memory" }, "topology_element_control" : { "min" : { "value" : 0, "resource" : "memory" } } }, { "id" : "ml", "node_type" : { "master" : false, "data" : false, "ingest" : false, "ml" : true }, "node_roles" : [ "ml", "remote_cluster_client" ], "zone_count" : 1, "instance_configuration_id" : "ml", "size" : { "value" : 0, "resource" : "memory" }, "autoscaling_min" : { "value" : 0, "resource" : "memory" }, "autoscaling_max" : { "value" : 2097152, "resource" : "memory" }, "topology_element_control" : { "min" : { "value" : 0, "resource" : "memory" } } } ], "elasticsearch" : { }, "autoscaling_enabled" : true }, "settings" : { "dedicated_masters_threshold" : 6 } } ], "kibana" : [ { "ref_id" : "kibana-ref-id", "elasticsearch_cluster_ref_id" : "es-ref-id", "region" : "ece-region", "plan" : { "zone_count" : 1, "cluster_topology" : [ { "instance_configuration_id" : "kibana", "size" : { "value" : 1024, "resource" : "memory" } } ], "kibana" : { } } } ], "apm" : [ { "ref_id" : "apm-ref-id", "elasticsearch_cluster_ref_id" : "es-ref-id", "region" : "ece-region", "plan" : { "cluster_topology" : [ { "instance_configuration_id" : "apm", "size" : { "value" : 0, "resource" : "memory" }, "zone_count" : 1 } ], "apm" : { } } } ], "enterprise_search" : [ { "ref_id" : "enterprise_search-ref-id", "elasticsearch_cluster_ref_id" : "es-ref-id", "region" : "ece-region", "plan" : { "cluster_topology" : [ { "node_type" : { "appserver" : true, "worker" : true, "connector" : true }, "instance_configuration_id" : "enterprise.search", "size" : { "value" : 0, "resource" : "memory" }, "zone_count" : 2 } ], "enterprise_search" : { } } } ] } }, "system_owned" : true, "metadata" : [ { "key" : "parent_solution", "value" : "stack" } ], "order" : 0, "template_category_id" : "default" }'
After you have edited the template, you can start creating new deployments with it.