The heat.engine.template
Module¶
-
class
heat.engine.template.
Template
(template, template_id=None, files=None, env=None)[source]¶ Bases:
_abcoll.Mapping
Abstract base class for template format plugins.
All template formats (both internal and third-party) should derive from Template and implement the abstract functions to provide resource definitions and other data.
This is a stable third-party API. Do not add implementations that are specific to internal template formats. Do not add new abstract methods.
-
add_output
(definition)[source]¶ Add an output to the template.
The output is passed as a OutputDefinition object.
-
add_resource
(definition, name=None)[source]¶ Add a resource to the template.
The resource is passed as a ResourceDefinition object. If no name is specified, the name from the ResourceDefinition should be used.
-
condition_functions
= {}¶
-
classmethod
create_empty_template
(version=(‘heat_template_version’, ‘2015-04-30’), from_template=None)[source]¶ Create an empty template.
Creates a new empty template with given version. If version is not provided, a new empty HOT template of version “2015-04-30” is returned.
Parameters: version – A tuple containing version header of the template: version key and value. E.g. (“heat_template_version”, “2015-04-30”) :returns: A new empty template.
-
files
¶
-
functions
= {}¶
-
classmethod
load
(context, template_id, t=None)[source]¶ Retrieve a Template with the given ID from the database.
-
param_schemata
(param_defaults=None)[source]¶ Return a dict of parameters.Schema objects for the parameters.
-
parameters
(stack_identifier, user_params, param_defaults=None)[source]¶ Return a parameters.Parameters object for the stack.
-
validate
()[source]¶ Validate the template.
Validates the top-level sections of the template as well as syntax inside select sections. Some sections are not checked here but in code parts that are responsible for working with the respective sections (e.g. parameters are check by parameters schema class).
-
validate_resource_definitions
(stack)[source]¶ Check validity of resource definitions.
This method is deprecated. Subclasses should validate the resource definitions in the process of generating them when calling resource_definitions(). However, for now this method is still called in case any third-party plugins are relying on this for validation and need time to migrate.
-