Creating a service instance

You can search and create service instances of published offerings from the Cloud Automation Manager catalog. You can customize the service instances based on your requirement and use it in the overall application development.

Before you begin

If you are using tags in your service, see Prerequisites for tags.

Procedure

To create a service instance, follow these steps:

  1. In the left-side navigation bar, click Library > Services. The service library is displayed.

  2. Search for your service by using any of the following search filters:

    • Enter your service name in Search Services.
    • Click the show filter menu icon on the right of the search instance filter to list services based on their status.
    • You can click the column headings of Name and Created to sort the list.
    • You can also select the provider or type on the left-hand side to list services based on the selection.
    • You can use the pagination drop-down to select the number of records you want to display in a page at a time.
    • You can select a namespace from the top right drop-down list. The list of services in the page change based on the selected namespace. You can also select "All namespaces" to see all the service for which you have access.

  3. Click Deploy in the overflow menu of your service tile.

    As an alternative, you can click the service to preview its Overview and Associated Instances details.

    The Associated Instances page displays the details of all the instances that are associated with the service. In this tab, click the Actions overflow menu of the associated instance record to View Details of that instance.

  4. Go through the details of the service. You can see the following details of the service in the Overview page:
    • Chart version, published date and type
    • Details section has a long description of the service.
    • For additional information about the service, see the Useful Links section. It has Documentation and Support link.
  5. Select your plan and click Next.

  6. Enter the Name of the service instance.

    Note: The service instance name must begin with an alphabet and must have a combination of only these characters: [a-zA-Z][a-zA-Z0-9_-]

  7. For globally accessible services, you can select a namespace from the Namespace drop-down list. For other namespaces, the option is not enabled for selection.
  8. Consider the following for dynamic cloud connections in the service definition:
    • If you have defined a parameter of type connection in the service definition and linked it to the Cloud Connections parameter value, then the parameter is displayed here as a drop-down list. For example, you have created "Conn" as a parameter of type connection, then "Conn" drop down list is displayed. For the complete input_parameter format for "conn" definition in the Source Code tab, see Different ways of adding values for the cloud connection in Templates topic. This drop down list fetches all global cloud connections of the provider mentioned in the input_parameter. For example, if the provider is VMware vSphere, then the drop down list includes all global cloud connections of VMware vSphere provider. If you change the Namespace value, the drop-down value contains a list of global cloud connections that are tagged to the selected namespace and are associated to the provider.
  9. Consider the following for dynamic shared parameters in the service definition:
    • If you have defined a parameter of type sharedparameter in the service definition and linked it to a Data Object value, then the parameter is displayed here as a drop-down list. For example, you have created "shared" as a parameter of type sharedparameter, then "shared" drop down list is displayed. For the complete input_parameter format for "shared" definition in the Source Code tab, see Shared parameters in Templates topic. This drop down list fetches all globally defined Data Objects of the Data Type that is mentioned in the input_parameter. If there are more than one Data Object for the selected Data Type, then you must define a default Data Object. By default, this default value is preselected for the "shared" parameter drop down. If you change the Namespace value, the drop-down value contains a list of global Data Objects that are tagged to the selected namespace and are associated to the Data Type.

  10. Enter the values for the selected plan parameters.

    Note: If a value is not available for a non mandatory service or activity parameter referenced within a plan parameter, the service instance fails with an error message. For example, you have referenced the cc parameter of an email notification activity in a plan parameter. If the value for the non mandatory cc parameter is not available, then the service instance fails with the following error message: 

    Service deploymentError: Invalid resource : ${parameters.cc} (hint: 'cc' not found)
{"error":{"statusCode":500,"message":"Internal Server Error"}}
  11. If you have any tags created for the service, then select your tag.
  12. Click Create Instance. A message confirming the successful submission of a service instance request is displayed. You can go to Deployed Instances page to view the status of the current deployment or go to Service Library to create more instances.

Results