1.3.2. Create a template by GUI

1.3.2.1. Click Generate Template Button

At the page showing list of stacks, there is a button Generate Template which can lead to page Generate HOT Template.
In page Generate HOT Template, we can drag and drop resource icons to make a template.
launch hot generator

1.3.2.2. Add resources into a template

Add a resource by drag and drop

Drag the resource icon on the left side of the page to the center canvas.
Following image is an example showing how to add an instance to template.
Add instance to template

Set parameters for a resource

After dragging and dropping resource icons into the center canvas, we need to set parameters for these resources.
Clicking the resource, you can find the parameters’ input form on the right side of the page.
Please input proper values for resource’s parameters.
edit parameter form

Note

If you input parameters with improper data format, or you miss some required parameters,
error messages will appear as a prompt. Please follow the prompt and modify your input value.

Save the setting

| Click Save button at the bottom of the parameter setting form to save the current setting.

Note

If you missed inputting a required parameter, or you input some improper data format, you could not click the save bottom.

Delete an added resource

Click Delete this resource button at the bottom of the parameter setting form to delete this resource.
If this resource has some connection with other resources, this connection will also be deleted.

1.3.2.3. Connection between resources

Connection between resources are possible only when there are at least two resources on the canvas.
For example, in order to create a instance(ECL::Compute::Instance), you need to connect it to a logic_network(ECL::Network::LogicalNetwork).
Then you can use this resource connection function.

Enter Edit mode

In order to connect resources, first we need to click the Edit button at top-left corner of the canvas.
After clicking Edit button, the edit mode is on.

Enter Connect resources mode

Furthermore, click Connect Resources button to enter connect resource mode.
Then you can drag one resource to another one to connect these two resources.

Dragging

dragging

After dragging

after dragging

Edit connection paremeters

Click the connecting line made by resource dragging, parameter of this connection will appear.
Follows are two examples.
  • Connecting line between Instance(=ECL::Compute::Instance) and Volume(Virtual Server)(=ECL::Compute::Volume) represents ECL::Compute::VolumeAttachment, the connecting resource between instance and volume.
  • Connecting line between Instance(=ECL::Compute::Instance) and Logic Network(=ECL::Nework::LogicalNetwork) represents Instance's NIC which is used to connect the logic network.
Same as normal resources, click the Save button to reflect connection setting contents to the template.
Click the Delete this resource button to delete this connection if you wish.

Note

As for the connection, it is not possible to reverse the connection source and connection destination.
For example, we can connect from instance to volume(virtual server). However, reversely connect from volume(virtual server) to ``instance is not allowed.

1.3.2.4. Output the template

You can output the template which consists of resources in canvas by pressing the Create Template button.
Next following image will be shown on the screen.
template created
You can either copy the template contents, or directly make a new stack by this template by clicking Create stack from this template.
Click Close button to close this template page.

Precautions for [Generate Template]

If you forget to save the parameters for resources or connections,
error message Resource: (******) is not correctly configured. will appear when you try to create the template

By following methods, you can distinguish whether one resource is saved or not.

Resource case

Unsaved resource’s icon label will be shown in Fine characters.

resource before saving

Otherwise, if a resource is saved, its icon label will be shown in Bold characters.

resource after saving

Connection case

  • Unsaved connection is shown in dotted line, while saved connection is shown in blue line.
unsaved and saved connections

1.3.2.5. Draft management

Draft management enables you to save and load the current canvas state as a draft.
Manage the draft by Manage Draft menu on the top of the canvas.
Draft management menu
Following operations are available:
  • Save Draft
  • Load Draft
  • Export Draft
  • Import Draft

Save Draft

Save the canvas with its current state.
Following message will be shown at the top of canvas after a successful saving.
Draft saved message

Note

Your drafts are stored in your browser’s local storage. Please do not change your computer or browser if you would like to use Save Draft.

Also the maximum number of saved drafts is 10. If you save more than 10 drafts, older drafts will be removed in their saved order.

Load Draft

Load a saved draft into the canvas.
Click Load draft and saved drafts will be displayed in ascending order as follows.
Choose the draft

Choose a saved draft which you would like to load into the canvas.

Export Draft

Export the current canvas state as a text file.
This file will be saved by your browser’s download function.

ImportDraft

Import a text file created by Export Draft, which would be loaded into the canvas.

1.3.2.6. Initialize the canvas

You can click Clear All if you want to delete all resources in the canvas.

1.3.2.7. Renew choices information

In order to speed up screen display, choices in the input form for each resource are obtained by the API just when this input form initializes. And this cache information will not be expired until you logout.
Image list for instance creation is just one example of above situation.
If you want to update these choices information, just click Renew choices information button to delete the old cache and reload the latest information.