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.
, ,

Cloud Accounts in VCF Automation: Connecting vCenter and NSX (VCF Automation Series, Part 9)

A cloud account is the credential that lets VCF Automation collect inventory and deploy. Adding vCenter and NSX accounts, the VCF account and SDDC Manager, and the NSX manager-mode removal in 9.0.

VCF Automation Series · Part 9 of 30

TL;DR · Key Takeaways

  • A cloud account is a stored credential that lets VCF Automation collect inventory from, and deploy resources to, real infrastructure.
  • A vCenter cloud account handles compute and storage; an NSX cloud account handles network resources; a VCF cloud account ties in SDDC Manager.
  • Add them under Connections, then Cloud accounts, then Add cloud account, and validate the credentials before you rely on them.
  • A VCF cloud account needs SDDC Manager 4.1 or later configured as an Automation Assembler integration first.
  • VCF 9.0 removed NSX-T manager-mode cloud accounts. You connect NSX in Policy mode now, which matters if you are carrying an 8.x design.
Who this is for: admins wiring VCF Automation to the vCenter and NSX underneath it.  Prerequisites: projects and cloud zones from Part 8, plus credentials for vCenter, NSX, and SDDC Manager.

VCF Automation does not deploy anything until you give it the keys. A cloud account is exactly that: a stored credential that lets the platform read inventory from and push workloads to a vCenter or NSX. No cloud account, no infrastructure, and the most carefully designed catalog in the world has nowhere to land a machine. This Part is short on theory and long on the connections that turn an empty platform into one that can actually build something.

What a cloud account actually is

Strip away the name and a cloud account is a credential with a job. A vCenter cloud account is the credential VCF Automation uses to collect data from and deploy compute and storage to that vCenter. An NSX cloud account is the credential it uses to create and deploy network resources. A VCF cloud account brings SDDC Manager into the picture so the platform understands the wider fabric. The Infrastructure tab is where the inventory those accounts collect shows up: machines, networks, storage, and volumes, ready for templates to reference.

Why this matters beyond plumbing: the account is also a blast radius. The credential you store here can read and change real infrastructure, so it deserves the same care as any service account. Scope it to what VCF Automation actually needs, store it where secrets belong, and rotate it on a schedule. A cloud account quietly using a domain admin credential is a convenience today and an audit finding tomorrow.

Cloud accounts are the keys VCF AutomationAssembler infrastructure vCenter: compute, storage NSX: network resources VCF: SDDC Manager Each account is a scopedcredential, not a person.
Three account types, three jobs. Treat each stored credential as a service account with a blast radius.
Account typeCredential forUsed to
vCentervCenter ServerCollect and deploy compute and storage
NSXNSX Manager (Policy mode)Create and deploy network resources
VCFSDDC Manager 4.1+ integrationTie deployments to the VCF fabric

Adding a vCenter cloud account

The path is Connections, then Cloud accounts, then Add cloud account, then pick the type. For vCenter you supply the server address and a credential, and the platform validates it before saving. That validation step is not a formality; it is the cheapest place to catch a typo in the hostname, a wrong password, or a firewall that quietly drops the connection. If validation fails here, nothing downstream will work, so fix it before moving on rather than saving a broken account and debugging it from a failed deployment later.

# vCenter cloud account, inputs (Connections > Cloud accounts > Add)
vcenter_cloud_account:
  name:        vc-wld-prod-01
  fqdn:        vcenter-wld-01.lab.local
  username:    svc-vcfa@vsphere.local     # scoped service account, not a person
  password:    ''
  validate:    true                       # validate BEFORE saving
# On success, the Infrastructure tab fills with machines, networks and storage.

NSX, and the 9.0 change you cannot ignore

An NSX cloud account gives VCF Automation the credentials to build network resources. When you add one, you can either enter NSX Manager credentials directly or use Create and Validate Service Credentials, which has Automation Assembler create and validate the NSX credentials for you. The second option is the one I prefer, because it produces a purpose-built credential rather than reusing an admin login you will forget to rotate.

Here is the part that bites people migrating from 8.x. VCF 9.0 removed the ability to add NSX-T cloud accounts using the manager setting, the one that leverages NSX-T Manager APIs, and removed VCF cloud accounts with an underlying NSX-T manager mode. In plain terms: manager mode is gone, and you connect NSX in Policy mode. If your old runbooks or scripts assume manager mode, they do not just need updating, they describe a path that no longer exists.

NSX connection mode in 9.0 Manager modeNSX-T Manager APIsremoved in VCF 9.0 Policy modethe supported NSX pathuse this for new accounts
Manager mode is gone in 9.0. Connect NSX in Policy mode and update any 8.x assumptions accordingly.

Gotcha

If you lifted an NSX integration design straight from Aria Automation 8.x, the manager-mode cloud account it depends on will not exist in VCF 9.0. Do not spend an afternoon hunting for a setting that was deliberately removed. Plan for Policy mode from the start, and treat any 8.x document that mentions manager mode as out of date for this platform.

The VCF cloud account and SDDC Manager

A VCF cloud account is the one that ties deployments to the broader VCF fabric, and it has a prerequisite: SDDC Manager 4.1 or later must be configured as an Automation Assembler integration before the VCF cloud account will work. So the order is integration first, account second. Skip the integration and the VCF account has nothing to bind to. This is the account that lets the platform reason about the VCF instance rather than just a lone vCenter, which matters once you are deploying across workload domains rather than a single cluster.

In practice: the first thing I check when a deployment cannot find capacity is whether the cloud account actually collected the inventory. An account that validated but shows an empty Infrastructure tab usually means the credential lacks the permissions to read the objects, not that the objects are missing. Permissions, then panic.

Worked example

Onboarding one workload domain looks like three accounts in order: a vCenter cloud account for the domain’s vCenter, scoped to a service account that can read and deploy; an NSX cloud account in Policy mode, created with Create and Validate Service Credentials so the credential is purpose-built; and a VCF cloud account, but only after SDDC Manager 4.1 or later is registered as an Assembler integration. Validate each before moving to the next, and confirm the Infrastructure tab fills with that domain’s machines, networks, and storage. Three validated accounts and the domain is consumable; one unvalidated account and you are debugging a deployment instead.

Disclaimer: cloud accounts store credentials that can change real infrastructure. Use scoped service accounts rather than personal or domain-admin logins, keep the secrets in a proper store, rotate them, and test account changes outside production first. A cloud account is a key to your estate; treat it like one.

Validating accounts and reading the Infrastructure tab

Adding an account is only half the job; the account has to actually collect inventory before anything can deploy onto it. The flow is the same every time: you add the account, the platform validates the credential, it runs a data collection against the target, and the results land in the Infrastructure tab as machines, networks, storage, and volumes. A template can only reference what data collection found, so an empty Infrastructure tab is not a cosmetic problem, it is a deployment that will fail to place.

From credential to inventory Add accountfqdn + credential Validatecredential works Data collectionneeds read permission Infrastructure tabmachines, networks, storage
Validation proves the credential connects; data collection is what actually fills the inventory templates draw on.

When the tab comes back empty after a green validation, the cause is almost always permissions rather than a missing object. A credential that can authenticate but cannot read clusters, datastores, or port groups validates cleanly and then collects nothing, which looks like a platform fault and is really a role assignment one rung too low. Check what the service account can actually see in vCenter or NSX before you suspect anything deeper. The other usual suspects are a network path that blocks the collection traffic even though the login succeeded, and an account pointed at the wrong instance entirely, easy to do when hostnames differ by one character.

Build the habit of confirming inventory, not just validation, as the real done signal for a cloud account. Validation tells you the door opened; the populated Infrastructure tab tells you the platform walked in and took a complete picture. Until you have seen the second thing, the account is not finished, however green the first looked. That one extra glance saves the awkward later moment where a perfectly designed template cannot find a single cluster to run on.

Final Thoughts

Cloud accounts are the seam between the platform and reality, and they reward a little discipline. My recommendation: add accounts in order, vCenter then NSX then VCF, validate every one before moving on, and confirm the Infrastructure tab actually populated rather than assuming it did. Use scoped service accounts and the Create and Validate option for NSX so your credentials are purpose-built and rotatable. And internalise the 9.0 change: NSX is Policy mode now, manager mode is gone, so any design that assumes otherwise needs rewriting before it wastes your afternoon. Get the accounts right and templates have something real to deploy onto. Get them wrong and every later Part is built on a connection that does not work.

Next we turn that connected infrastructure into placement targets: cloud zones, regions, and how mappings tie templates to real capacity. For the projects that consume these accounts, see Part 8 on projects. Have you hit the NSX manager-mode removal yet? Tell me how it went in the comments.

VCF Automation Series navigation:
Previous: Part 8, projects.  Next: Part 10, cloud zones and infrastructure mapping (coming soon).  Up: VCF Automation Guide (pillar).

References

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.

Discover more from Dr. Pranay Jha

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

Continue reading