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 filtered based on the cloud system that you are connected to, and the palette is divided into multiple drawers. If the Components, Images, Networks, or Templates drawers contain many items, the contents are separated across tabs, by type onto up to five tabs. The tabs are arranged in decreasing order of number of related items that they contain, from left to right. If only a few items of a type are available, all the items for multiple types are shown on the same tab, as shown in the Images drawer of the previous figure. If many items are available for many types, the four types with the most items are shown on separate tabs and all the rest are shown on the same tab. On tablet computers, the palette on the right side of the editor 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.

• If you import a blueprint into another blueprint, the Imported drawer shows the components from the imported blueprint that must be placed in the active blueprint.
• The Components drawer shows components and tags from the IBM® UrbanCode™ Deploy server and, if you integrated with Chef, Chef roles. You can drag these components to a virtual image. If you drag a component tag to a virtual image, all the components on the IBM UrbanCode Deploy server that contain that tag are added to the blueprint.

  This drawer also includes a resource that is named Referenced Component. This resource represents a generic component. You can 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.

  Restriction: To be used with the blueprint designer, the virtual images must meet the requirements in Configuring images for use with the blueprint designer.
• The Networks drawer shows networks that are available on the cloud. The New Internal Network resource represents a new network. The Referenced Network resource represents a network for which you provide information later.
• The Security drawer shows security configurations that you can apply to virtual images. The New Security Group resource represents a new security configuration. The Referenced Security Group resource represents a security configuration for which you provide information later.
• The Storage drawer shows cloud storage volumes. To add a storage volume, drag a volume to a virtual image. The New Storage Volume resource represents a new storage volume. The Referenced Storage Volume Attachment resource represents a storage volume for which you provide information later.
• The Policies drawer includes resources such as load balancers and autoscaling groups.
• The Templates drawer includes all the Heat resources that are available on your cloud, including resources that are not supported by the blueprint diagram editor. To add any resource, drag it onto the blueprint. You can add resources only by using this method in the graphical editor.

  When you add a resource to a blueprint, you must update its properties in the source editor. Each property is formatted to accept the correct inputs, and all required properties in the resource are labeled. The names of resources that you add from the Templates drawer are appended with -dsp in the source editor. If you add the -dsp suffix to the names of existing resources, they are displayed in the graphical editor.

The left side of the editor shows the following sections:

• The Outline section shows the structure of the blueprint.
• The Parameters section shows the parameters in the blueprint. Click a parameter to go to its definition, or drag it to the blueprint.
• The Parameter groups section shows the parameter groups in the blueprint.
• The Resources section shows the resources that are in the template, such as virtual images.
• The Outputs section shows the output parameters, usually attributes, for the blueprint. The attributes in this section usually show relevant derived values, such as the URL of virtual instances.

resource_tree:
  type: IBM::UrbanCode::ResourceTree
  properties: 
     urbancode_deploy_url: { get_param: ucd_server_url }
     username: { get_param: ucd_user }
     password: { get_param: ucd_password }
     team_mappings: 
     application: MyApplication
     base_resource_group: MyResources