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.

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.

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.

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¶

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.

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.

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

Connection case¶

Unsaved connection is shown in dotted line, while saved connection is shown in blue line.

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.

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.

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 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.

1.3.2.8. Actual examples¶

We will explain how to create templates by GUI based on actual examples.

In these examples, we assume to use minimum necessary resources.

1.3.1. Basics for HOT creation

1.4. Template Examples