Modeling service blueprints

As a service designer, based on your organization's need, you can define a blueprint to:

• Start with an application node, such as Namespace and the rest of the service containing one or more applications and infrastructure nodes.
• Start with an infrastructure node, such as Host and the rest of the service containing one or more applications and infrastructure nodes.

Default blueprints

The following default blueprints are available out-of-the-box. However, you need to import them to be able to view them on the Service Blueprints page.

• Default Blueprint for Kubernetes (K8S): A blueprint with Kubernetes namespace as the starting node. Each node is of a single kind.
• Default Blueprint using Tags: It contains a node with multiple kinds included. This can be used as part of tag-based services.

As a service designer, you can create additional blueprints by using the default blueprints. For more information, see To create a service blueprint from another blueprint.

To import the default blueprints

On the Service Blueprints page, click > Import BMC default Blueprints to import the out-of-the-box default blueprints.

To create a service blueprint

Perform the following instructions to create a service blueprint:

1. From the Service Blueprints page, click Create.
   The Create new Service Blueprint page is displayed.
2. Specify the name, description, and provider (domain) details for the blueprint.
   For example, Kubernetes (K8s) Upgrade Deployment, K8s deployment template, .itbiz.com.
   
3. In the Select CIs section, do the following:
   1. Click +Add CIs. The Add CIs page is displayed with list of all CIs available for selection.
   2. To filter and add the CIs of interest, do one of the following:
      • Type the name of the CIs (minimum three characters) of your interest.
      • Select a category to narrow down the list of CIs of interest.
        The filtered CIs are listed.
   3. Select one or more CIs and click Add (incl. related) to add the CI with all the related elements or click Add to add only the CI.
   4. (Optional) To undo the selected CIs and start afresh, click Clear Content and perform steps 5 a to 5 c again.
   5. (Optional) Set the service topology display option as either Organic or Hierarchic.
      By default, Hierarchic (Left to right) is selected.
      
4. Click Next Step (Edit the Blueprint rules).
   The Edit Blueprint Rules section is displayed. 

   1. (Optional) Select App to Infra or Infra to App mode based on your service requirement type.
      By default, App to Infra is selected.

      Difference between App to Infra and Infra to App modes

      - App to Infra starts with an application node such as Namespace.

      - Infra to App starts with an infrastructure node such as Host.

   2. (Optional) From the Available CI Kinds section, select view as icons or view as type to change the list view.
   3. Type the name of the CI Kind of your choice or directly select the CI Kind of your choice from the list to add to the CI rules.
      For more information on resolving errors, see To resolve the errors when selecting a CI kind.
   4. Establish a valid connection between the CI Kinds selected as shown in this image.
      
   5. Click on the selected class to define CI rules.
      The Define CI Rule pane is displayed. 
   6. (Optional) Change the Kind from the drop down.
      You can select multiple kinds from the drop down.
   7. (Optional) Select an unwanted CI kind from the map and delete it. 

   8. (Optional) Include or exclude the content of a CI kind. You have an option to exclude the content of a CI kind and keep only the related nodes as part of a blueprint. By default, the Include Content option is enabled. 
      

   9. (Optional) Add or edit the filter criteria and save the changes. For more information on resolving the CI kind errors, see To resolve the errors when selecting a CI kind.
      
5. Click Next step (Preview result) to preview the blueprint model.
   
6. Save the blueprint. For more information on viewing the list of blueprints, see To view the service blueprint libraries.

To resolve the errors when selecting a CI kind

Perform the following instructions when you see an error icon above a CI kind while creating or editing a service:

Hover over the CI kind for the tips. Based on the error tips do one of the following:

• If there are more than one root nodes in the service model, make one of those as a root node by connecting them as required.
• If there is only one root node with an error icon, do the following steps:
  1. Click the node.
     The Define CI Rule page is displayed.
  2. Click Add New Filter > Add New Filter Criteria to add or click Edit > Edit to edit a filter criteria.
  3. Select Set as variable and type a message in the Define user prompt message text box.
  4. Select an attribute, save and close.
  5. Save and close the Define CI Rule page.
     The error is resolved.
     

To view the service blueprint libraries

Perform the following instructions to view the list of all enabled or disabled service blueprints:

From the Service Blueprints page, click Show disabled to view the list of all disabled service blueprints.
You can click Hide disabled to view only the list of all enabled service blueprints.

To create a service blueprint from another blueprint

Perform the following instructions to create a service blueprint:

1. From the Service Blueprints page, select a blueprint from the list and click Action > Create a new Blueprint from option.
   The Create new Service Blueprint page appears.
2. Edit the Blueprint rules as required and click Next Step (Preview result) to preview the model.
3. Save the blueprint.

To view the details of a service blueprint

Perform the following instructions to view the details of a service blueprint:

1. From the Service Blueprints page, select a blueprint from the list and click Action > View option.
   The View Service Blueprint page appears.
2. (Optional) Change the display to Organic or Hierarchic view. 
3. View and click Close.

To edit a service blueprint

Perform the following instructions to edit a service blueprint:

1. From the Service Blueprints page, select a blueprint from the list and click Action > Edit option.
   The Edit Service Blueprint page appears.
2. Edit the Blueprint rules as required.
   For more information, see step 5 and step 6 of To create a service blueprint section.
3. Click Next Step (Preview result) to preview the blueprint model.
4. Save the blueprint.

To list the related services of a service blueprint

Perform the following instructions to view the list of all services that a service blueprint is associated with:

1. From the Service Blueprints page, select a blueprint from the list and click Action > List related Services option.
   The Related Services page appears.
2. (Optional) Use to sort the list in ascending or descending order.
3. Click Close.

To enable a service blueprint

Enabling a blueprint makes it available for a service model. Perform the following instructions to enable a service blueprint:

1. From the Service Blueprints page, select a blueprint from the list and click Action >Enable option.
   The blueprint is now ready to be used as part of a service model.  
2. Click Hide disabled to view the list of all enabled service blueprints.
3. Check for the newly enabled blueprint in the list. 
4. (Optionally, to verify if it is available for a service model) Click Services and select a service to edit.
   1. Click Add Dynamic content.
   2. Search for the enabled blueprint.
      It is available for selection.
      

To disable a service blueprint

Disabling a blueprint makes is unavailable for a service model. Perform the following instructions to disable a service blueprint:

1. From the Service Blueprints page, select a blueprint from the list and click Action > Disable option.
   The blueprint is no longer available for a service model.
2. Click Show disabled to view the list of all disabled service blueprints.
3. Check for the disabled blueprint in the list.
4. (Optionally, to verify if it is not available for a service model) Click Services and select a service to edit.
   1. Click Add Dynamic content.
   2. Search for the disabled blueprint.
      It will not be available for selection.
      

To export a service blueprint

1. From the Service Blueprints page, select a blueprint from the list and click Action >Export option.
   The blueprint is saved as a JSON file into your default download folder.
2. (Optional) Open the JSON file and verify it is exported correctly.

To import a service blueprint

Perform the following instructions to delete a service blueprint:

1. From the Service Blueprints page, click Import Service Blueprint.
2. Navigate to the folder where you have saved or downloaded the exported JSON blueprint file.
3. Click Show disabled to view the imported blueprint listed. By default, the imported blueprint is in disabled state.

To delete a service blueprint

1. From the Service Blueprints page, select a blueprint from the list and click Action >Delete option.
   A confirmation dialog box appears. 
2. Click Proceed to delete the blueprint.