Editing Heat blueprint diagram

You can edit blueprints in a graphical editor.

Log into the Blueprint Designer.

To edit a Terraform blueprint in the graphical editor, in the Files list, open the appropriate folder and click on any file with the extension tf. The Diagram tab shows the blueprint in a graphical editor.

Diagram mode of blueprint designer.

The other tabs enable you to view and edit the source code for the blueprint. For more information, see Editing blueprint source code.

The palette at the right side of the editor shows resources that you can add to the blueprint. The palette is divided into multiple drawers. If a drawer contains many items, the contents are separated across tabs. On tablet computers, the pallet is on the right side of the editor and is collapsed by default. If you are using a tablet computer, to add elements to a blueprint, typically you click Add to open the Add Element window.
  • The Components drawer shows components and tags from the IBM® UrbanCode® Deploy server. If you created and have selected a VMware vRealize Automation Enterprise cloud project, this drawer also shows the vRealize Automation software components. You can drag these components to an instance. If you drag a component tag to an instance, all the components on the IBM UrbanCode Deploy server that contain that tag are added to the blueprint. This drawer also includes a resource named Referenced Component. This resource represents a generic component. You use the Referenced Component to represent a component that you specify later.
  • The Images drawer shows virtual images that are available on the current cloud system. You can drag these images to the blueprint. This drawer also includes a resource that is named Referenced Image. This resource represents a generic virtual image. You can use the Referenced image to represent a virtual image that you specify later. By using referenced images in this way, you can create one blueprint that you can provision on multiple clouds; see Editing configuration files. This drawer is available only when editing a Heat blueprint.
  • The VRA Catalog drawer lists assets from vRealize Automation blueprints that are available for use, if you are connected to a VMware vRealize Automation cloud. To reuse these existing catalog items, you can drag one onto an empty blueprint.
  • The Instances drawer shows the resources for creating virtual machines in cloud environments. You can drag these to the blueprint. This drawer is available only when editing a Terraform blueprint.
  • The Networks drawer shows referenced networks and new networks. To connect a virtual machine to an existing network, use a referenced network. To create a new network in the cloud, use a new network.
  • The Storage drawer shows cloud storage volumes. To add a storage volume, drag a volume to an instance and specify the mount point for the volume.
  • The Security drawer shows security configurations that you can apply to an instance.
  • The Modules drawer shows the Terraform modules that you have access to. To use a module, drag it onto the canvas and supply the module property values. This drawer is available only when editing a Terraform blueprint.
  • The Policies drawer includes resources such as load balancers and autoscaling groups. This drawer is available only when editing a Heat blueprint.
  • The Other drawer includes miscellaneous resources such as deployment sequence, load balancers, and null resource. A null resource is generally used to run Terraform provisioners on a virtual machine. This drawer is available only when editing a Terraform blueprint.

Resource names can contain only alphanumeric characters and the following special characters: hyphen (-) and underscore (_). If, when prompted, you enter a name containing unsupported characters, the Blueprint Designer replaces those characters with underscore character (_).

To search the palette contents, click Add , and then in the Add Element window filter field, enter your search term.

Some resources can be connected. For example, you can connect an instance to a network by grabbing the networks connection icon and dragging to instance.

Note: On tablet computers, connection icons are not displayed on elements. Instead, to connect elements, touch and hold the first element until the outline of the element flashes green. Then, without lifting your finger, drag your finger to the second element.

When you click a resource to select it, its properties are displayed in the Properties drawer, to the left of the editor. From this drawer, you can change property values or externalize them to properties as described in Externalizing properties in blueprints.

If the blueprint contains an error, warning, or unfinished TODO item, an icon that represents the most serious types of item is displayed on the editor toolbar. For example, if the blueprint contains at least one error, the error icon is displayed. Hover over the icon to display a list of all items that you must correct or complete before you provision the blueprint.

When you add components to the blueprint, the editor automatically adds the resource tree resource to the blueprint. This resource represents a base resource tree on the IBM UrbanCode Deploy server. If, on this resource, you specify the parent property, a forward slash character (/) indicates a hierarchical relationship. For example, if you specify /Cloud/Environment/OtherResources, then this resource tree will be added under /Cloud/Environment/OtherResources.

The editor toolbar contains useful tools for working with your blueprint. It includes tools like cut, copy, paste, and delete. Also
  • Edit variables
  • Add or edit outputs
  • Add an element to the blueprint. An alternative to using the Palette.
  • Synchronize variables with camvariables.json. Only variable when working with Cloud Automation Manager projects.