HOT packages¶

Automatic package composing¶

Before uploading an application into the catalog, it should be prepared and archived. A Murano command line will do all preparation for you. Just choose the desired Heat Orchestration Template and perform the following command:

murano package-create  --template wordpress/template.yaml

Note, that optional parameters could be specified:

As the result, an application definition archive will be ready for uploading.

Manual package composing¶

Application package could be composed manually. Follow the 5 steps below.

• Step 1. Choose the desired heat orchestration template

  For this example chef-server.yaml template will be used.

• Step 2. Rename it to template.yaml

• Step 3. Prepare an application logo (optional step)

  It could be any picture associated with the application.

• Step 4. Create manifest.yaml file

  All service information about the application is contained here. Specify the following parameters:

  Format:	defines an application definition format; should be set to Heat.HOT/1.0
  Type:	defines a manifest type, should be set to Application
  FullName:	a unique name which will be used to identify the application in Murano Catalog
  Description:	text information about an application
  Author:	a name of an application author or a company
  Tags:	keywords associated with the application
  Logo:	a name of a logo file for an application

  Take a look at the example:

  Format: Heat.HOT/1.0
  Type: Application
  FullName: com.example.Chef-Server
  Name: Chef Server
  Description: "Heat template to deploy Open Source CHEF server on a VM"
  Author: Kate
  Tags:
    - hot-based
  Logo: logo.png
  

• Step 5. Create a zip archive, containing the specified files: template.yaml, manifest.yaml, logo.png

Browse page looks like:

The configuration form, where you can enter template parameters, will be generated automatically and looks as follows:

After filling the form the application is ready to be deployed.

Hot packages with nested Heat templates¶

In Murano HOT packages it is possible to allow Heat nested templates to be saved and deployed as part of a Murano Heat applications. Such templates should be placed in package under ‘/Resources/HotFiles’. Adding additional templates to a package is optional. When a Heat generated package is being deployed, if there are any Heat nested templates located in the package under ‘/Resources/HotFiles’, they are sent to Heat together with the main template and params during stack creation.

These nested templates can be referenced by putting the template name into the type attribute of resource definition, in the main template. This mechanism then compose one logical stack with these multiple templates. The following examples illustrate how you can use a custom template to define new types of resources. These examples use a custom template stored in a sub_template.yaml file

heat_template_version: 2015-04-30

parameters:
  key_name:
      type: string
      description: Name of a KeyPair

resources:
  server:
    type: OS::Nova::Server
    properties:
      key_name: {get_param: key_name}
      flavor: m1.small
      image: ubuntu-trusty

Use the template filename as type¶

The following main template defines the sub_template.yaml file as value for the type property of a resource

heat_template_version: 2015-04-30

resources:
  my_server:
    type: sub_template.yaml
    properties:
      key_name: my_key