Skip to content

Conversation

@JamesLaverack
Copy link
Member

Description

Update examples and documentation to use the "app.kubernetes.io/name" recommended label in place of labels such as "app", "name", etc.

Labels which do not have a recommended variant, such as "tier", "role", or "k8s-app", have not been modified. Blog posts have also not been modified.

Issue

N/A

Update examples and documentation to use the app.kubernetes.io/name
reccomended label in place of labels such as "app", "name", etc.

Labels which do not have a recommended variant, such as "tier",
"role", or "k8s-app", have not been modified. Blog posts have also not
been modified.
@k8s-ci-robot k8s-ci-robot added the language/en Issues or PRs related to English language label Nov 23, 2025
@k8s-ci-robot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign sayakmukhopadhyay for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@k8s-ci-robot k8s-ci-robot requested review from ahmetb and bowei November 23, 2025 06:17
@k8s-ci-robot k8s-ci-robot added size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. labels Nov 23, 2025
@netlify
Copy link

netlify bot commented Nov 23, 2025

Pull request preview available for checking

Built without sensitive environment variables

Name Link
🔨 Latest commit 81f3280
🔍 Latest deploy log https://app.netlify.com/projects/kubernetes-io-main-staging/deploys/6922a6f1a48d5500085878a3
😎 Deploy Preview https://deploy-preview-53389--kubernetes-io-main-staging.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@lmktfy
Copy link
Member

lmktfy commented Nov 23, 2025

Much appreciated!

Copy link
Member

@lmktfy lmktfy left a comment

Choose a reason for hiding this comment

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

I think if me merge this we would make the docs better, but I also think that we'd introduce some places we then ought to go and fix.


1. Run the following commands to delete all Pods, Deployments, and Services.

```shell
Copy link
Member

Choose a reason for hiding this comment

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

It might be good to teach app.kubernetes.io/part-of here too. What do you think?

selector:
matchLabels:
app: ssd-driver-pod
app.kubernetes.io/name: ssd-driver-pod
Copy link
Member

Choose a reason for hiding this comment

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

Hmm, not sure about this one. It's not exactly an app, and highlighting the difference may help people learn.

How about using driver-name: example-ssd-driver, and updating the running text?

(for an easy-ish life, rebase the PR and omit the DaemonSet parts, then we can get someone else to revisit them)

selector:
matchLabels:
name: fluentd-elasticsearch
app.kubernetes.io/name: fluentd-elasticsearch
Copy link
Member

Choose a reason for hiding this comment

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

This seems fair. It's an app enough that we can use the label without quibbling. Many people would call Elasticsearch an app.

namespace: dra-tutorial
labels:
app: pod
app.kubernetes.io/name: pod
Copy link
Member

Choose a reason for hiding this comment

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

Hmm. Not at all sure I support this specific change.

name: audit-pod
labels:
app: audit-pod
app.kubernetes.io/name: audit-pod
Copy link
Member

Choose a reason for hiding this comment

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

Maybe a better name here?

Copy link
Member

Choose a reason for hiding this comment

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

If it needs a label, I would use a private label that is nothing to with app.

spec:
selector:
app: hello
app.kubernetes.io/name: hello
Copy link
Member

Choose a reason for hiding this comment

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

For this one, the running text might need a tweak too to explain that some of these labels have a cluster-private meaning, and some have a definite public meaning.

selector:
matchLabels:
app: hello
app.kubernetes.io/name: hello
Copy link
Member

Choose a reason for hiding this comment

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

For this one, the running text might need a tweak too to explain that some of these labels have a cluster-private meaning, and some have a definite public meaning.

selector:
matchLabels:
app: curlpod
app.kubernetes.io/name: curlpod
Copy link
Member

Choose a reason for hiding this comment

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

nit: can we coin a better name?

name: my-daemonset
labels:
app: foo
app.kubernetes.io/name: foo
Copy link
Member

Choose a reason for hiding this comment

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

For a DaemonSet, I might not suggest an "app" label.

Copy link
Member

Choose a reason for hiding this comment

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

aside: this example is stale

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. language/en Issues or PRs related to English language size/XL Denotes a PR that changes 500-999 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants