In this example, you use a filtering rule to onboard machines whose state is On and whose name begins with the letters BG. You also create a separate vRealize Automation Cloud Assembly blueprint and deployment for each machine in the plan.

When you create a cloud account, all machines that are associated to it are data-collected and then displayed on the Infrastructure > Resources > Machines page. If the cloud account has machines that were deployed outside of vRealize Automation Cloud Assembly, you can use an onboarding plan to allow vRealize Automation Cloud Assembly to manage the machine deployments.



  1. Go to Infrastructure > Onboarding.
  2. Click New Onboarding Plan and enter values.
    Setting Sample Value
    Plan name ob_rules_1
    Description Machine onboarding with rules1
    Cloud account rs-aws
    Default project rs-project

    Initial onboarding plan user interface page

  3. Click Create.

    Onboarding plan user interface page after you click Create

  4. Click the Rules tab and then click Add Rule.

    You can create one or more rules to select a group of machines for onboarding based on specific machine characteristics.

    Onboarding plan Rules page

  5. Enter a rule name, such as ob_rules_1.

    Onboarding plan with rule name shown

  6. Build the rule by adding filters.

    For this example, use the Status and Name filters on the Filter drop-down menu to specify all the machine whose name contains BG* and whose status is On.

    Onboarding plan with rule filter options shown Onboarding plan with rule filter complete

  7. Click Save.

    Although you can make additional rules, this example uses a single rule.

    Saved rule displayed

  8. Click the Machines tab. In this example, 4 machines are selected, 3 that begin with the letters BG and one that contains the letters BG.

    4 machines selected by the rule filters

  9. Remove the machine whose name does not begin with BG by selecting its check box and then clicking Exclude.

    remove a single machine from fetch

  10. Click the Deployments tab.

    The 3 machines that begin with the letters BG and that are powered On are ready to be deployed. By default, a separate blueprint and deployment is created for each machine.

    3 machines ready to onboard

  11. Click the check box next to the three deployment names, click Blueprints, click Create blueprint in Cloud Assembly format, and click Save.

    create a blueprint for each of the three machine deployments

    Note: When your onboarding plan uses a vSphere machine, you must edit the blueprint after the onboarding process is complete. The onboarding process cannot link the source vSphere machine and its machine template, and the resultant blueprint will contain the imageRef: "no image available" entry in the blueprint code. The blueprint cannot be deployed until you specify the correct template name in the imageRef: field. To make it easier to locate and update the blueprint after the onboarding process is complete, use the Blueprint name option on the deployment's Blueprint Configuration page. Record the auto-generated blueprint name or enter and record a blueprint name of your choice. When onboarding is complete, locate and open the blueprint and replace the "no image available" entry in the imageRef: field with the correct template name.
  12. On the Deployments page, click the check box next to the three deployment names, and click Run.

    select the deployments and run the plan

  13. When prompted to confirm, click Run to onboard the machines.

    select run to confirm and run the onboarding plan

    The plan is run and the machines are brought into vRealize Automation Cloud Assembly management. A separate blueprint and deployment is created for each machine.