Files
napalm-vmware/CHANGELOG.md
T
Christian Manivong 52c802ed41
driver / standard (pull_request) Successful in 14s
driver / lint (pull_request) Successful in 13s
driver / types (pull_request) Failing after 1m2s
driver / test (3.12) (pull_request) Failing after 57s
driver / test (3.13) (pull_request) Failing after 52s
driver / lowest (pull_request) Failing after 25s
driver / build (pull_request) Successful in 24s
driver / security (pull_request) Successful in 57s
CI / driver (pull_request) Failing after 2m21s
driver / publish (pull_request) Skipped
feat: get_clusters() and create_vm_from_cloud_init(node=)
vCenter reports each cluster compute resource, and each standalone host
it runs as a cluster of one, identified by "<instanceUuid>/<moref>"; an
ESXi host reports itself. Nodes carry state, maintenance, CPU and memory;
datastores and port groups carry the hosts that see them.

create_vm_from_cloud_init(node=) places the VM on that host and refuses
one that does not exist or cannot take it, before anything is created.
Placement now runs before the image download, so a refused host fails at
once instead of after the download.

Refs NetOrk/netork#484, NetOrk/netork#1822
2026-11-01 16:38:38 +01:00

3.7 KiB
Raw Blame History

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

Added

  • get_clusters() on both drivers. The vCenter reports each cluster and each host added to a datacenter directly (as a cluster of one with no name), with the id <instanceUuid>/<MoRef>; an ESXi host reports itself, local, with its system UUID as the id. Each cluster lists its hosts (state, maintenance mode, CPU and memory; a disconnected host keeps only its name and state), the accessible datastores and the port groups its hosts see, each with the hosts that see it (NetOrk/netork#484).
  • create_vm_from_cloud_init(node=…): the host to create the VM on. A host that does not exist, is not connected, is in maintenance mode or does not see the datastore and port groups is refused with ValueError, before the image is downloaded (NetOrk/netork#1822).

Changed

  • Provisioning chooses the host before it downloads the image, so a request no host can take fails at once.
  • Python 3.12 is the floor (requires-python = ">=3.12"): netOrk runs every driver on 3.12, so 3.10 and 3.11 are no longer tested (NAPALM/driver-standard#6).
  • The floor on napalm is 5.1: older releases import pkg_resources, which a Python 3.12 venv no longer has.
  • The floor on PyYAML is 6.0.1: 6.0 has no Python 3.12 wheel and does not build there.

[0.3.0] - 2026-10-23

The first release on PyPI.

Changed

  • The driver follows the NAPALM driver standard (https://git.netork.io/NAPALM/driver-standard): CI on Gitea runs ruff, mypy, the tests on Python 3.10–3.13 and at the lowest declared versions, bandit, pip-audit and a build check, and a release tag publishes to PyPI. Python 3.10 remains the floor; requires napalm-device-types 4.21.1.
  • Provisioning fails, and removes the imported VM, when vSphere hands back fewer network adapters than NICs were asked for, instead of leaving a NIC unconfigured. A failed abort of the import lease is logged at debug level.

Added

  • VM provisioning (create_vm_from_cloud_init, destroy_vm, get_vm_status, get_network_targets, get_image_storages) from qcow2/raw cloud images: converted with qemu-img, imported over OVF/NFC, configured by cloud-init from a NoCloud seed ISO. Tested against vcsim.
  • reboot_host on ESXi, refused outside maintenance mode.
  • Declares open-vm-tools as the guest agent for provisioned VMs.

Changed

  • Breaking: get_device_warnings is gone; the driver reports facts and the caller names the warnings (netOrk #1111). get_hypervisor_hosts() gives each host's connection state (None on ESXi, which cannot tell), maintenance mode, configuration issues and managing vCenter (ESXi only); get_licenses() gives the assigned licenses with their edition key as edition. Requires napalm-device-types 4.14.0; version 0.2.0.
  • The guest agent is declared per guest OS (GUEST_AGENTS, napalm-device-types 3.0); VMware provisions Linux guests only and refuses any other guest_os.
  • The NoCloud network-config comes from napalm-device-types (provisioning.network_config), which Proxmox uses as well.

[0.1.0] - 2026-09-24

Added

  • vmware_esxi and vmware_vcenter drivers (hypervisor role) over the vSphere API: facts, interfaces, LLDP/CDP, environment, VMs, VM config, power actions, snapshots, datastores, port groups and raw device warnings.
  • tools/harvest.py and tools/sanitize.py to capture fixtures from real hosts.

Pending

  • Validation against real ESXi and vCenter installations; tested against vcsim only.