You use the Cloud Assembly blueprint canvas to create a machine or application specification.

You use the basic workflow when creating a blueprint.

  1. Locate the components.

  2. Drag the components to the canvas.

  3. Connect the components.

  4. Add and edit YAML properties to configure how the components are deployed.

Blueprint Canvas

From the canvas, you can also change the blueprint name, version and revert to versions, clone, and deploy your blueprint.


The components are the blueprint building blocks. Some components are cloud agnostic, others are more specific. You can include a mix of components in a blueprint if the associated project includes cloud zones that support the mixture.

  • Cloud Agnostic. The cloud agnostic components can be deployed to any cloud vendor. The cloud-specific details are included in the blueprint at deployment time. If you have a blueprint that you want to deploy to your Amazon Web Services cloud zones and to your vSphere cloud zones, use cloud agnostic components.

  • AWS, Azure, and vSphere. The Amazon Web Services, Microsoft Azure, and vSphere components can only be deployed to matching AWS, Azure, or vSphere cloud zones.

  • Configuration Management. The configuration management components depend on your integrated applications. For example, a Puppet component monitors and enforces the configuration of the other components.

Connecting Components

You can connect compatible components in the canvas. Click and drag the connection bubble to the target component. The connections that you configure on the canvas are added to the YAML.

Editing the YAML

Adding components and connecting them in the canvas updates the YAML with the basic information. You must edit the YAML to create a deployable blueprint.

The YAML editor helps you with some of the editing.

Schema Hints


Available values.

Suggested blueprint values

Allowed properties.

Allowed properties in the blueprint editor

Provided subfields.

Provided subfields

Error message if you make a mistake.

Blueprint schema error message

Find a string. With your cursor in the YAML editor pane, enter <CTRL>F.

YAML editor search option

How to Use the CloudConfig Properties

The CloudConfig section of a component accepts Cloud-Init scripts for customization and configuration.

Can I Use an Outside YAML Editor

You can use an outside editor to create YML files. You can also download blueprints, edit them, and then upload them. Validate the uploaded files in the YAML editor. This validation ensures that the file does not contain any errors.

Download and upload

More Information About Building Blueprints

What Are Cloud Assembly Blueprint Input Parameters

What Is the Advantage of Versioning Cloud Assembly Blueprints

Blueprint Examples

WordPress Use Case: Create and Iteratively Develop a Blueprint

Use Cases: vSphere Component Configuration Blueprint Examples

What Are Marketplace Blueprints and Image Files