Uses the vSphere "GuestInfo" data object to pass information to the newly-cloned virtual machine.
The guest operating system can retrieve this information using the vmtoolsd utility.
e.g. Passing in a GuestInfo property named
"JNLPURL"
with value
"${JENKINS_URL}computer/${NODE_NAME}/slave-agent.jnlp"
could tell a virtual machine what URL to connect to in order to run the Jenkins slave.jar agent,
and the virtual machine could retrieve that information using the command
vmtoolsd --cmd "info-get guestinfo.JNLPURL".
Variables which can be used within the values of these properties include
- All variables from the Jenkins global configuration, e.g. environment variables.
- All variables exposed from "this" node's own properties, e.g. tool locations.
- Environment variables available in build steps that are not build-dependent:
JENKINS_URL,
NODE_NAME,
NODE_LABELS.
- The value to be passed with the -secret argument if the agent is connecting via JNLP: JNLP_SECRET.
- The following properties from this vSphere template definition:
cluster,
datastore,
labelString,
masterImageName,
remoteFS,
snapshotName,
targetHost,
templateDescription.
Note: This is not a list of properties that are exposed as GuestInfo properties by default.
The above list is a list of variables that may be used in the GuestInfo properties.
By default, no GuestInfo properties are passed.