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

  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 or revert to versions, clone, or deploy your blueprint.


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

  • Cloud Agnostic. You can deploy cloud agnostic components to any cloud vendor. At provisioning time, the deployment uses cloud specific resources that match.

    If you have a blueprint to deploy to Amazon Web Services cloud zones and to vSphere cloud zones, use cloud agnostic components.

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

  • Configuration Management. Configuration management components depend on your integrated applications. For example, a Puppet component can monitor and enforce 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 basic entries. To add the details for a fully deployable blueprint, you usually need to edit the YAML code directly.

To help with direct editing, the Cloud Assembly YAML editor includes code completion and error checking features.

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 Do I Use CloudConfig Properties

You can add cloud-init scripts within the CloudConfig section of component YAML. For more about using cloud-init for customization and configuration, see

Can I Use an Outside YAML Editor

You can use an outside editor to create YAML files. You can also download Cloud Assembly blueprints, edit them in an outside editor, and then upload them.

To verify that uploaded files contain no errors, inspect them in the Cloud Assembly YAML editor.

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