Templates

Templates

Orchestration Templates are essentially infrastructure automation instructions written in “YAML” or “JSON” format. Templates can have multiple tasks within them, each of them performing a specific action in a target cloud or a tool. You may also have a single template to orchestrate across multiple cloud(s) and/or tool(s). 

CoreStack™ supports Templates of the formats: AWS CFN, Azure ARM, OpenStack HEAT, OpenStack MISTRAL, Terraform, Oracle, DM. 

One of the key differentiators of CoreStack™ is its support for cloud-native DSL (Domain Specific Language) which ensures that there is no limitation in terms of the supported services within that platform. 

For example: You can execute

• CFN Templates against AWS 
• ARM Templates against Azure 
• HEAT, MISTRAL, and Terraform Templates against OpenStack Public/Private Cloud Accounts 

You can bring into CoreStack™ any of these templates with ease and re-use them outside of CoreStack™ if required. 

Navigation

Navigate to Automation submenu under Operations in the Left navigation menu and select Templates option to land in Templates (Marketplace).  

The tabs at the top represent the scope of the templates. You can see 2 tabs: Marketplace and My Templates. 

Marketplace 

CoreStack™ provides a wide range of pre-defined templates which can help in realizing multiple use cases. The marketplace lists the templates available across multiple clouds and tools. These are pre-loaded for all subscriptions and are FREE to be executed on-demand or scheduled. 

These templates are available across all tenants and are usually created by the Product Administrator.  

Tip: These templates have the scope value set to Global.

My Templates

These templates have been created by users within the tenant. These are available only for users within the tenant. You can add more templates or edit/delete existing templates in this tab based on your role and access policies. 

Tip: These templates have the scope value set to Tenants.

Search and Filter Templates 

CoreStack™ offers search and filter functions to help quickly look for the templates you need to execute. The Search bar is available just above the templates list. To Filter Templates, you can click on the “Filter” icon placed to the right end above the templates list.

The Text Search helps you search using any string available in the following fields: 

• Name of the Template 
• Description of the Template 
• Type 
• DSL 
• Classification 
• Service 

The text search is thus quite useful in refining your search results based on any little information you have on the preferred result set. 

CoreStack™ also offers Filters to help you narrow down the list of templates by using one or a combination of filters. On clicking the Filter icon, you will see the list of Filter options available as shown below. Select the preferred options and click on “Apply Filter” button at the bottom of this box. 

Tip: Use the Reset button to quickly remove all selected filters and view all results.
Once you decide on a template that you would like to try out, you can execute it on-demand or schedule it for a one-time or recurring execution(s) in future. 

View Template Details

To get more information about a specific template, click on the template to open the ‘Template Detail’ page. You can view the attributes related to the template and update the values if required by clicking on Update. 

The actual content of the template, which is in ‘YAML’ or ‘JSON’ format is also displayed. Click ‘Edit’ button and make changes to the content if required. 

Template Actions

Template actions will be shown to every template listed when you are hovering mouse on a template. The list of actions depends on the scope of the template (Marketplace, My Templates) and the RBAC access for templates that user has. 

1. Execute – Executes the template immediately and redirects to “Job history” where you can see the status and output of the execution.  
2. Edit– Modifies the properties, content, metadata of the Template. It's like Template Create workflow.  
3. Schedules – Similar to Execute, but schedules it to be run later once/multiple times. 
4. Delete – Deletes the template 

Execute Template

Executes the template against Cloud Accounts and performs the tasks specified in the template. In ‘Job History' you can find the status and outputs for this execution. Execute requires following inputs: 

1. Job Name – Optional. If not given system will generates this. 
2. Cloud Account – Cloud Account need to be used for execution. 
3. Cloud Account Additional Info – Additional Info of Cloud Account (E.g., Resource Group, Location, Region). 
4. Execution Parameters – Additional parameters from the Template.

A sample Template execute window, for a simple example of taking an ‘AWS_EC2_Instance_With_SecurityGroup’ is shown below:

• The Cloud Accounts lists the available list of AWS cloud accounts in this Tenant
• Once the Cloud Account details are selected, click on “Load Execute parameters” to get the input parameters of the template.
• 
• You can enter/select values from dropdown for input params based on need and hit “Run” to execute the template. 
• Once a template is executed, it is run as a “Job” within CoreStack™. You can check the execution logs and job status from the “Job History” tab. 

Tips:

• Most of the input parameter values are fetched automatically from the respective cloud account. This is very useful in choosing real-time values from the cloud. There is no need to login to the AWS Console to refer these details. 

• You can use the “?” on the right side of each input parameter to understand more about the parameter.

Schedule Template

Schedules the template execution to be run later once or multiple times. For example, you can schedule backup for a Instance daily. Schedule requires the following details:

1. Name – Name of the schedule 
2. Description – Detailed description about the schedule 
3. Schedule Settings – Execution options. Template can be scheduled to execute Once or to repeat after specified Minutes, Hours, Daily, Weekly, Monthly, and Yearly. 
4. Cloud Account – Cloud Account need to be used for execution. 
5. Cloud Account Additional Info – Additional Info of Cloud Account (Eg. Resource Group, Location, Region). 
6. Execution Parameters – Additional parameters from the Template. 

Screenshot to schedule a template is shown below: 

The list of schedules created for that specific tenant can be viewed from the Schedules tab. 

Create (Upload) Custom Templates

CoreStack™ also provides the option for users to upload their own templates and use them to execute against their service accounts. Follow the steps given below: Use the ‘+’ button next to the ‘Search’ bar at top right.

Template create window will have 3 sections as follows: Properties, Content and Metadata. 

Group	Field	Description
Properties	Name	Name of the template
	Engine Type	Engine of the template. E.g., CFN, ARM, Mistral Heat.
	Type	Cloud or Integrated Tool
	Services	Services based on Type. E.g., If type is Cloud Account service or Tool Account service
	Classifications	Classification of the template like Provisioning, Configure, Backup etc.
	Scope	Scope of the template.
	Input Source	Defaults to Templates
Content	Content Type	File or URL. File option used to upload the template content as file where URL option is used download from that URL. This URL may any downloadable URL.
	Browse	File Upload
	URL	URL to download the content file.
Metadata	Description	Detailed description of the template with purpose and use cases.
	Operation Level	Support level of IT Operation Management required to handle this operation in Cloud manually.
	Operation Time	Approximate time will be spent by Operation level person to do this operation manually.
	Tags	Custom key – value tags that can help in grouping and searching templates.

Job History

Lists all template executions of the current tenant. A sample screenshot is shown below. The tabs at the top right represents the archive status of jobs. You can see 2 tabs: Active Jobs and Archived Jobs. 

Template Job History page offers search and filter functions to help quickly look for the executions. The Search bar is available just above the jobs list. To Filter Jobs, you can click on the “Filter” icon placed to the right end above the Job detail tab. 

Template Job History page also has Archive, Un-Archive and Delete Actions. These actions can be used to have limited number of executions in Job history page. 

Job history page has option to refresh the Jobs list. This will help when you are landing here from template execute page. By the time you are landing the Job might be IN_PROGRESS state. This will help to refresh the status. 

Template Jobs list show the following columns in the list. 

1. Template Name – Name of the Template executed 
2. Job Name – Name of the Job which is generated by the CoreStack with Template name and some random characters. 
3. Cloud Accounts – Name of the Cloud Account selected when executing 
4. Run Date – Date & Time of the Job execution 
5. Type – Execution Type (On-Demand, Scheduled or System) 
6. Status – Status of the Job execution 
7. Actions – Actions will be available for Cloud Formation and HEAT templates. In Cloud Formation and HEAT each template execution considered as stack, which supports the update and delete actions. Update action used to update the attributes of the resources where Delete action removed all the resources created by that execution. 

Template Job Detail will be shown on clicking Job from the list. This will show three tabs. Inputs, Output and Task. 

1. Inputs – Cloud Account details and input parameters passed for the execution. 
2. Output – Outputs from the template execution. 
3. Task – List of tasks or resources executed in this template. 

Schedules

Lists all template execution schedules of the current tenant. The tabs at the top right represents the schedule status. You can see 2 tabs: Upcoming and Past. Upcoming will list the schedules which are active, to be execute on future based on its scheduled time. Past will list the schedules which are no longer going to be executed.  Eg. Scheduled Once will be moved to Past tab after its execution. 

A sample screenshot is shown below. 

Template Schedules page offers search and filter functions to help quickly look for the schedules. The Search bar is available just above the schedules list. To Filter Jobs, you can click on the “Filter” icon placed to the right end above the Schedule detail tab. 

Template Schedules list show the following columns in the list.

1. Schedule Name – Name of the schedule 
2. Template – Name of the Template Scheduled 
3. Recurrence – Recurrence of the Schedule (Once/ Daily / Weekly / Monthly / Yearly) 
4. Next Run Time – Date and Time of the Next execution 
5. Requested By – CoreStack username who created the schedule. 

Template Schedule Detail will be shown on clicking Schedule from the list. This will show the execution history the schedule which will redirect to Job history page and filter by this schedule. It’s also supports the following actions on schedule. 

1. Edit (All Occurrences) – Modifies the Schedule like Schedule Create 
2. Delete (All Occurrences) – Deletes the Schedules. 

CoreStack™ also provides the control over the next execution of the schedule. You can remove the next execution or can edit the next execution time alone without modifying the schedule. For example, in a daily 12pm schedule, you can change the time of the next execution.