diff options
| author | Andrew Kutz <101085+akutz@users.noreply.github.com> | 2021-08-09 21:24:07 -0500 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2021-08-09 20:24:07 -0600 |
| commit | 8b4a9bc7b81e61943af873bad92e2133f8275b0b (patch) | |
| tree | 500881356564dacf85a8ff9cf0bc602b8069eda8 /requirements.txt | |
| parent | 049d62b658b06e729291def6b7b6f9520827d0ba (diff) | |
| download | vyos-cloud-init-8b4a9bc7b81e61943af873bad92e2133f8275b0b.tar.gz vyos-cloud-init-8b4a9bc7b81e61943af873bad92e2133f8275b0b.zip | |
Datasource for VMware (#953)
This patch finally introduces the Cloud-Init Datasource for VMware
GuestInfo as a part of cloud-init proper. This datasource has existed
since 2018, and rapidly became the de facto datasource for developers
working with Packer, Terraform, for projects like kube-image-builder,
and the de jure datasource for Photon OS.
The major change to the datasource from its previous incarnation is
the name. Now named DatasourceVMware, this new version of the
datasource will allow multiple transport types in addition to
GuestInfo keys.
This datasource includes several unique features developed to address
real-world situations:
* Support for reading any key (metadata, userdata, vendordata) both
from the guestinfo table when running on a VM in vSphere as well as
from an environment variable when running inside of a container,
useful for rapid dev/test.
* Allows booting with DHCP while still providing full participation
in Cloud-Init instance data and Jinja queries. The netifaces library
provides the ability to inspect the network after it is online,
and the runtime network configuration is then merged into the
existing metadata and persisted to disk.
* Advertises the local_ipv4 and local_ipv6 addresses via guestinfo
as well. This is useful as Guest Tools is not always able to
identify what would be considered the local address.
The primary author and current steward of this datasource spoke at
Cloud-Init Con 2020 where there was interest in contributing this datasource
to the Cloud-Init codebase.
The datasource currently lives in its own GitHub repository at
https://github.com/vmware/cloud-init-vmware-guestinfo. Once the datasource
is merged into Cloud-Init, the old repository will be deprecated.
Diffstat (limited to 'requirements.txt')
| -rw-r--r-- | requirements.txt | 9 |
1 files changed, 9 insertions, 0 deletions
diff --git a/requirements.txt b/requirements.txt index 5817da3b..41d01d62 100644 --- a/requirements.txt +++ b/requirements.txt @@ -32,3 +32,12 @@ jsonpatch # For validating cloud-config sections per schema definitions jsonschema + +# Used by DataSourceVMware to inspect the host's network configuration during +# the "setup()" function. +# +# This allows a host that uses DHCP to bring up the network during BootLocal +# and still participate in instance-data by gathering the network in detail at +# runtime and merge that information into the metadata and repersist that to +# disk. +netifaces>=0.10.9 |