Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Deprecate use of "master" in resource labels and names #1139

Merged
merged 1 commit into from
Jul 7, 2020

Conversation

zubron
Copy link
Contributor

@zubron zubron commented Jul 7, 2020

What this PR does / why we need it:
We renamed the master command to aggregator in #847 (released in
v0.15.3). However, master was still being used in some of our
Kubernetes resource labels and names. We want to remove usage of
insensitive language and as such use different labels for
identifying resources.

Now, any aggregator resources will have the label
sonobuoy-component: aggregator and plugin resources will have
sonobuoy-component: plugin. The existing label is still in place as it
was used to identify the aggregator pod (which is required most sonobuoy
commands once a run has started). Removing it now would prevent users
with older clients from using newer images, or querying the state of
runs started by newer clients. Instead, both labels will be applied
howeve the sonobuoy-component: aggregator label is the preferred
label. If the aggregator pod cannot be found using the new label, the
client will retry using the now deprecated label. When retrying, the
client will display a warning that it is attempting to find the pod
using the deprecated label.

Newer clients will be able to query the state of runs with old labels
applied, and older clients will be able to query the state of runs
created by the newer clients.

The name of the service created by Sonobuoy has been renamed to
sonobuoy-aggregator. This has no user facing impact.

Signed-off-by: Bridget McErlean [email protected]

Release note:

The label for identifying the aggregator pod is now `sonobuoy-component: aggregator` (replacing `run: sonobuoy-master`). The label `run: sonobuoy-master` is still applied but is now deprecated and its use will be removed in a later release. Once removed, older clients will not be able to query runs started by newer versions of Sonobuoy which do not use this label. A warning about the deprecated label will now be printed if using a newer client to query a run by an older version.

@@ -177,15 +178,15 @@ kind: Service
metadata:
labels:
component: sonobuoy
run: sonobuoy-master
name: sonobuoy-master
sonobuoy-component: aggregator
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The aggregator service is not queried within the Sonobuoy codebase so this label could be updated without impact.

We renamed the `master` command to `aggregator` in vmware-tanzu#847 (released in
v0.15.3). However, `master` was still being used in some of our
Kubernetes resource labels and names. We want to remove uses of
insensitive language and as such use different labels for
identifying resources.

Now, any aggregator resources will have the label
`sonobuoy-component: aggregator` and plugin resources will have
`sonobuoy-component: plugin`. The existing label is still in place as it
was used to identify the aggregator pod (which is required most sonobuoy
commands once a run has started). Removing it now would prevent users
with older clients from using newer images, or querying the state of
runs started by newer clients. Instead, both labels will be applied
howeve the `sonobuoy-component: aggregator` label is the preferred
label. If the aggregator pod cannot be found using the new label, the
client will retry using the now deprecated label. When retrying, the
client will display a warning that it is attempting to find the pod
using the deprecated label.

Newer clients will be able to query the state of runs with old labels
applied, and older clients will be able to query the state of runs
created by the newer clients.

The name of the service created by Sonobuoy has been renamed to
`sonobuoy-aggregator`. This has no user facing impact.

Signed-off-by: Bridget McErlean <[email protected]>
@zubron zubron force-pushed the deprecate-master-label branch from 48b00e2 to d7f1f4f Compare July 7, 2020 18:59
@zubron zubron merged commit 750f015 into vmware-tanzu:master Jul 7, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant