installer_bringup

VCF Installer bringup — validate spec, submit, poll progress.

The bringup spec is a sizable JSON document describing the target management domain: ESXi hosts, network pools, DNS/NTP, vCenter spec, NSX spec, vSAN config, and credentials. The standard workflow is:

spec = {...}
val_id = installer_bringup.validate(opts, spec)["id"]
while True:
    v = installer_bringup.validation_status(opts, val_id)
    if v["executionStatus"] != "IN_PROGRESS":
        break
if v["resultStatus"] != "SUCCEEDED":
    raise RuntimeError(v)
sddc = installer_bringup.submit(opts, spec)
sddc_id = sddc["id"]
# Poll for ~hours...
while installer_bringup.status(opts, sddc_id)["status"] == "IN_PROGRESS":
    time.sleep(60)

saltext.vcf.clients.installer_bringup.validate(opts, spec, profile=None)

Submit a bringup spec for validation. Returns {id, executionStatus, ...}.

Validation is asynchronous; poll with validation_status().

saltext.vcf.clients.installer_bringup.validation_status(opts, validation_id, profile=None)

Return the current state of a validation.

saltext.vcf.clients.installer_bringup.list_validations(opts, profile=None)

Return all known validations.

saltext.vcf.clients.installer_bringup.wait_validation(opts, validation_id, *, timeout=1800, poll_interval=10, profile=None)

Block until validation_id terminates. Returns the final dict.

Raises TimeoutError after timeout seconds; raises RuntimeError if the validation finishes with a non-success resultStatus.

saltext.vcf.clients.installer_bringup.submit(opts, spec, profile=None)

Submit a validated bringup spec. Returns {id, status, ...}.

Bringup runs for ~hours. Poll with status() or use wait().

saltext.vcf.clients.installer_bringup.status(opts, sddc_id, profile=None)

Return current bringup task state.

saltext.vcf.clients.installer_bringup.list_(opts, profile=None)

Return all known bringup tasks (current + historical).

saltext.vcf.clients.installer_bringup.retry(opts, sddc_id, profile=None)

Retry a failed bringup at the failed step. Returns the task dict.

saltext.vcf.clients.installer_bringup.wait(opts, sddc_id, *, timeout=14400, poll_interval=60, profile=None)

Block until bringup terminates. Default timeout is 4 hours.

Returns the final task dict. Raises RuntimeError on failure, TimeoutError if the deadline is hit.