nodepool/doc/source
James E. Blair 6320b06950 Add support for dynamic tags
This allows users to create tags (or properties in the case of OpenStack)
on instances using string interpolation values.  The use case is to be
able to add information about the tenant* which requested the instance
to cloud-provider tags.

* Note that ultimately Nodepool may not end up using a given node for
the request which originally prompted its creation, so care should be
taken when using information like this.  The documentation notes that.

This feature uses a new configuration attribute on the provider-label
rather than the existing "tags" or "instance-properties" because existing
values may not be safe for use as Python format strings (e.g., an
existing value might be a JSON blob).  This could be solved with YAML
tags (like !unsafe) but the most sensible default for that would be to
assume format strings and use a YAML tag to disable formatting, which
doesn't help with our backwards-compatibility problem.  Additionally,
Nodepool configuration does not use YAML anchors (yet), so this would
be a significant change that might affect people's use of external tools
on the config file.

Testing this was beyond the ability of the AWS test framework as written,
so some redesign for how we handle patching boto-related methods is
included.  The new approach is simpler, more readable, and flexible
in that it can better accomodate future changes.

Change-Id: I5f1befa6e2f2625431523d8d94685f79426b6ae5
2022-08-23 11:06:55 -07:00
..
_static Switch docs theme to versioned RTD 2021-12-16 11:23:30 -08:00
_templates Switch docs theme to versioned RTD 2021-12-16 11:23:30 -08:00
aws.rst Add support for dynamic tags 2022-08-23 11:06:55 -07:00
azure.rst Add support for dynamic tags 2022-08-23 11:06:55 -07:00
conf.py Correct tagged version docs build 2022-03-21 10:23:22 -07:00
configuration.rst Allow specifying diskimage metadata/tags 2022-08-23 06:39:08 -07:00
devguide.rst Add a state machine driver framework 2021-03-19 10:47:10 -07:00
gce.rst Merge "Add provider/pool priority support" 2022-05-24 16:02:34 +00:00
ibmvpc.rst Merge "Add provider/pool priority support" 2022-05-24 16:02:34 +00:00
index.rst Clarify in doc introduction that OpenStack is not required 2018-04-27 07:43:26 -05:00
installation.rst Remove statsd args to OpenStack API client call 2021-04-20 10:19:37 +10:00
kubernetes.rst Merge "Default limits for k8s labels and quota support" 2022-05-31 09:19:59 +00:00
metastatic.rst Add provider/pool priority support 2022-05-23 13:28:21 -07:00
openshift-pods.rst Add provider/pool priority support 2022-05-23 13:28:21 -07:00
openshift.rst Add provider/pool priority support 2022-05-23 13:28:21 -07:00
openstack.rst Add support for dynamic tags 2022-08-23 11:06:55 -07:00
operation.rst Add nodepool.image_build_requests metric 2022-06-21 14:52:53 -07:00
releasenotes.rst Publish docs on release 2018-06-29 15:41:46 -07:00
static.rst Merge "Add provider/pool priority support" 2022-05-24 16:02:34 +00:00