Versions:

Service Provisioning in CloudForms Using an Orchestration Template

Overview

Cloud orchestration is a service that allows you to create, update, and manage cloud resources and their software components as a single unit and then deploy them in an automated, repeatable way through a template. The deployed virtual machine instances and associated collection of resources are referred to as stack. ManageIQ supports a number of orchestration template types, including Amazon CloudFormation and OpenStack Heat, that make deploying complex services easier in the cloud.

In the following example workflow, you will create an orchestration template, and add it as a catalog item to a service catalog. You can then create an orchestration stack from the template, and launch the stack from the catalog using a service dialog.

Creating an Orchestration Template

Complete the following procedure to create a new orchestration template.

  1. Navigate to menu:Services[Catalogs] and select Orchestration Templates in the accordion menu.

  2. Click Configuration Configuration, then click Green_Plus_Sign Create a new Orchestration Template.

  3. Enter a Name and Description for your template.

  4. Select Amazon CloudFormation from the Template Type list.

  5. Select Draft to create a draft template.

  6. Add your template in the area below for the selected Template Type. You can author your own stack template, or you can copy and paste from an existing text file.

  7. Click Add.

Next, create a service dialog from the orchestration template.

Creating a Service Dialog from an Orchestration Template

Complete the following procedure to create a service dialog based on the input parameters defined in the orchestration template.

  1. Navigate to menu:Services[Catalogs] and click Orchestration Templates in the accordion menu.

  2. Expand All Orchestration Templates, then click the orchestration template you created in ??? to create a service dialog from it.

  3. Click ConfigurationConfiguration, then click Green_Plus_SignCreate Service Dialog from Orchestration Template.

  4. Enter a name for the service dialog in Service Dialog Name.

  5. Click Save.

Creating an Orchestration Catalog Item

Complete the following procedure to create a new catalog item from the orchestration template you created in ???.

  1. Navigate to menu:Services[Catalogs] and select Catalog Items in the accordion menu.

  2. Click Configuration Configuration, then click Green_Plus_Sign Add a New Catalog Item.

  3. Select Orchestration from the Catalog Item Type list.

  4. Enter the basic details in the Basic Info:

    1. Enter a Name and Description for the new service catalog item.

    2. Select Display in Catalog box.

    3. Select the appropriate catalog from the Catalog list.

    4. Select the appropriate dialog from the Dialog list.

    5. Select the orchestration template you created in ??? from the Orchestration Template list.

    6. Select Amazon from the Provider list.

  5. Click Add.

Next, assign the catalog item to a new service catalog.

Creating a Catalog

Complete the following procedure to create a new catalog, and assign the catalog item you created in ???.

  1. Navigate to menu:Services[Catalogs] and select Catalogs in the accordion menu.

  2. Click Configuration Configuration, then click Green_Plus_Sign Add a New Catalog.

  3. In Basic Info, add Name and Description for the new catalog.

  4. Under Assign Catalog Items, select the catalog item you created in ??? from the Unassigned box, then move it to the Selected box.

  5. Click Add.

Ordering a Service

Complete the following procedure to order catalog items from the service catalog.

  1. Navigate to menu:Services[Catalogs] and select Service Catalogs in the accordion menu.

  2. From All Services, select the catalog and the services (catalog items) that you want to order from your catalog, then click Order. You will see the Order Service window with Options and Parameters.

  3. Enter a name for the stack in Stack Name.

  4. From the On Failure list, select what to do if stack creation fails. The default is Rollback.

  5. Optional: Enter Timeout in minutes.

  6. Set the remaining options as needed that will vary depending on the dialog.

  7. Click Submit.

You have now submitted your service provisioning request. Once a request has been approved, the various stages of fulfillment will be processed. You can monitor the request status and other details in menu:Services[Requests].

Orchestration Stacks

  1. Once the status of the provisioning request in menu:Services[Requests] is Finished, click menu:Compute[Clouds > Stacks] to see the deployed stack.

  2. Click the stack to see a summary of its properties, resources, among other details, including the running instances that are part of the stack. Catalog_Item_State

You have now deployed instances and associated collection of resources (referred to as a stack) using an orchestration template.