Dr. Pranay Jha

VMware • Cloud • AI • Enterprise Architecture

FORMERLY
VMware Insight & Cloud Pathshala
What began over a decade ago as a passion for sharing knowledge has evolved into a unified platform for Enterprise AI, VMware, Cloud Architecture, Research, and Modern Infrastructure.
, ,

Onboarding Plans in VCF Automation: Bringing Brownfield VMs Under Management (VCF Automation 9 Series, Part 33)

You do not have to rebuild the VMs you already run. Onboarding plans bring discovered machines under VCF Automation as deployments, and 9.1 adds a no-downtime VM Service import for All Apps. Here is how each works and which to use.

VCF Automation 9 Series · Part 33 of 41
TL;DR · Key Takeaways
  • Adopting VCF Automation does not mean rebuilding existing VMs. An onboarding plan brings unmanaged, data-collected machines under management as deployments, with a generated cloud template.
  • The workflow is short: discover, create a plan, configure the deployments and template, then run. One plan handles up to 3,500 machines per hour, and up to 17,000 concurrently across plans.
  • The big limitation: an onboarded deployment supports most day-2 actions except Update. Plan for that before you onboard anything you will need to re-deploy from template.
  • In 9.1, the All Apps world gets a second path: non-disruptive VM import to VM Service, no downtime and no re-IP, but the target namespace must have been created by VCF Automation.
  • My recommendation: onboarding plans for bulk brownfield in VM Apps orgs; VM Service import when you are moving toward the Supervisor model and cannot take downtime.
Who this is for: platform and cloud admins adopting VCF Automation over an existing vSphere estate, and architects planning a VM Apps to All Apps move without a forklift rebuild.
Prerequisites: a VCF Automation 9.x organization, a vCenter cloud account that is data-collecting, projects to assign onboarded workloads to, and for the All Apps path a Supervisor namespace created by VCF Automation.

Adopting VCF Automation does not mean rebuilding the hundreds of VMs you already run. The machines that predate the platform can be brought under its governance as they are, without redeploying them. The mechanism is the onboarding plan, and in 9.1 there is a second, no-downtime path for the All Apps world. The catch is that a brownfield VM does not always end up with the same capabilities as one born in the catalog, and knowing where that line falls is the difference between a clean adoption and a surprise three months later.

Two ways to bring brownfield under management

There are two distinct mechanisms, and they belong to the two organization types. In a VM Apps organization, the onboarding plan is the long-standing path inherited from Aria Automation: it takes machines that vCenter already knows about and that VCF Automation has data-collected, and turns them into managed deployments. In an All Apps organization, 9.1 adds a non-disruptive import that brings vSphere VMs into a Supervisor namespace under VM Service control with no downtime and no change of network identity. Same goal, bring the unmanaged under control, but different machinery and different constraints.

Two paths for brownfield VMs The org type decides which one you use Existing vSphere VMs unmanaged today Onboarding plan (VM Apps) Discovered machines become deployments with a generated cloud template VM Service import (All Apps, 9.1) Into a Supervisor namespace, no downtime, no re-IP; namespace must be VCFA-created
Onboarding plans serve VM Apps orgs; the 9.1 non-disruptive import serves the All Apps, Supervisor-based model.

Onboarding plans, step by step

An onboarding plan exists to identify machines that have been data-collected from a cloud account but are not yet managed by a project, and to bring them under management. The flow is four steps and it is forgiving, because nothing is destructive: you are wrapping existing machines, not recreating them.

The onboarding plan flow Nothing is recreated; existing machines are wrapped 1 Discover Origin = Discovered 2 Create plan select machines 3 Configure template + deployments 4 Run managed deployments
Discover, plan, configure, run. The plan produces deployments plus a cloud template that describes them.

Discovered machines surface under Resources, Virtual Machines, marked with an Origin of Discovered. You create a plan, add machines to it manually, and decide how they group: one deployment per machine, or many machines into a single deployment that mirrors an application. You then assign the target project and owner, and run the plan. The output is a set of managed deployments and an accompanying cloud template that describes them.

Scale and what comes across

This is built for bulk. A single onboarding plan handles up to 3,500 unmanaged machines per hour, and you can run multiple plans to onboard up to 17,000 machines concurrently per hour. Onboarding preserves more than the VM: custom properties, attached disks, vSphere networks, and deployment ownership all come across. That fidelity is what makes onboarding a real adoption tool rather than a registration trick.

The Update action you do not get

Here is the limitation that catches teams. After onboarding, you can run most day-2 actions on the deployment, but not the Update action. You can power, resize, change lease, change owner and delete, but you cannot push a changed cloud template back through Update the way you can on a deployment that was born from the catalog. The reason is that the template was reverse-generated to match what already existed, not authored as the desired state. If a workload genuinely needs full template-driven lifecycle, onboarding is the first step, not the last.

# Cloud template an onboarding plan generates (shape, not authored by hand)
formatVersion: 1
inputs: {}
resources:
  app-server-01:
    type: Cloud.vSphere.Machine
    properties:
      name: app-server-01
      networks:
        - network: '${resource.app-net.id}'
  app-net:
    type: Cloud.vSphere.Network
    properties:
      networkType: existing

Expected result: the deployment appears on the Deployments page with this template attached and the machine still running untouched. Note the existing network type, the generated template references resources that are already there. The failure mode to watch is a machine that never shows up as Discovered, which almost always means the cloud account is not data-collecting that region, not that onboarding is broken.

In practice: group machines into deployments that match how the business thinks about the app, not one giant deployment per project. A deployment that maps to a real application is one you can lease, hand off and reason about. A bucket of 200 unrelated VMs in one deployment is a governance headache you built yourself.

The 9.1 non-disruptive VM Service import

For All Apps organizations, 9.1 introduces a different answer. You can bring existing vSphere workloads into a Supervisor namespace and under VCF Automation control without downtime and without a network identity change. In the past, moving a VM into a namespace often meant a re-IP and therefore an outage. Now the import keeps the machine and its address in place, and you can move VMs in batches using the ImportOperationBatch operation. The tested constraint to remember: imported VMs are managed by VCF Automation only if the namespace they land in was created by VCF Automation itself, not one carved directly in vCenter.

This matters beyond a single import. A non-disruptive path from a plain vSphere VM into the Supervisor model is the groundwork for moving workloads from VM Apps to All Apps without rebuilding them, which has been the hardest part of that transition. If your direction of travel is toward the All Apps architecture, this is the import to learn.

FactorOnboarding planVM Service import (9.1)
Org typeVM AppsAll Apps
ResultDeployment + cloud templateVM in a Supervisor namespace
Downtime / re-IPNone (wraps in place)None, no re-IP
Scale3,500/hr per plan; 17,000 concurrentBatched via ImportOperationBatch
Key constraintNo Update day-2 actionNamespace must be VCFA-created
Best fitBulk brownfield adoptionMoving toward the Supervisor model
Which path? Org type and destination settle it Heading to the All Apps / Supervisor model, no downtime? Onboarding plan VM Apps, bulk discovered VMs into managed deployments VM Service import All Apps, into a VCFA-created namespace, no re-IP NO YES
If you are staying VM Apps for now, onboard. If you are moving to the Supervisor model, import.
Worked example
You inherit 1,200 unmanaged VMs across one vCenter. A single onboarding plan clears that in one pass, well under the 3,500 per hour ceiling. Rather than one plan with 1,200 machines in a single deployment, you group them into roughly 40 deployments aligned to applications, assign each to the owning project and a real owner, and run. Afterwards every deployment supports power, resize, lease and delete, but none support Update, so the handful of apps that need full template lifecycle get flagged for a later rebuild. For the dozen apps already targeted for All Apps, you skip onboarding and use VM Service import into VCF Automation-created namespaces instead, with no outage.
Gotcha
Two constraints bite quietly. Onboarded deployments have no Update day-2 action, so do not promise template-driven lifecycle on workloads you only onboarded. And for the All Apps import, the target namespace must have been created by VCF Automation; importing into a vCenter-created namespace leaves the VMs running but unmanaged by VCF Automation, which is the opposite of the goal.
Disclaimer
Onboarding wraps existing production machines and changes who can act on them through day-2 policies. Run a small pilot plan first, confirm ownership and lease defaults before a bulk run, and follow the current Broadcom documentation for your exact VCF Automation build, including the ImportOperationBatch reference for the All Apps path, before importing production workloads.

Where I'd Start

Onboard early and onboard in application-shaped groups. The fastest way to make VCF Automation real for an existing estate is to bring the running workloads under it, because governance, leases and day-2 only matter once they apply to the machines people actually use. Use onboarding plans for the bulk of a VM Apps estate, accept the missing Update action as the price of not rebuilding, and tag the few workloads that genuinely need template lifecycle for a later, deliberate rebuild. When would I import to VM Service instead? When the workload is already on the road to All Apps and cannot take downtime, take the non-disruptive path and keep the network identity intact. The thing not to do is leave hundreds of VMs unmanaged beside a shiny new catalog, because an automation platform that governs only the new stuff governs almost nothing. Which of your existing applications would you onboard first, and is it one that will ever need Update?

References

VCF Automation 9 Series · Part 33 of 41
« Previous: Part 32  |  VCF Automation Guide  |  Next: Part 34 »

About The Author


Discover more from Dr. Pranay Jha

Subscribe to get the latest posts sent to your email.

Leave a Reply

Your email address will not be published. Required fields are marked *

Architect’s Toolkit

About the Author

Dr. Pranay Jha is a Cloud and AI Consultant with 18+ years of experience in hybrid cloud, virtualization, and enterprise infrastructure transformation. He specializes in VMware technologies, multi-cloud strategy, and Generative AI solutions. He holds a PhD in Computer Applications with research focused on Cloud and AI, has published multiple research papers, and has been a VMware vExpert since 2016 and a VMUG Community Leader.

VCF Automation 9 Series

Discover more from Dr. Pranay Jha

Subscribe now to keep reading and get access to the full archive.

Continue reading