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

78 lines
3.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Changelog
All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [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.