Permalink
Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
206 lines (183 sloc) 30.4 KB

Kubernetes GitHub Labels

Table of Contents

Intro

These file was auto generated by the label_sync tool, based on the labels.yaml that it uses to sync github labels across repos in the kubernetes github org

Why these labels?

The rule of thumb is that labels are here because they are intended to be produced or consumed by our automation (primarily prow) across all repos. There are some labels that can only be manually applied/removed, and where possible we would rather remove them or add automation to allow a larger set of contributors to apply/remove them.

How do I add a new label?

  • Add automation that consumes/produces the label
  • Open a PR, with a single commit, that:
    • updates labels.yaml with the new label(s)
    • runs hack/update-labels.sh (to regenerate the label descriptions and associated CSS)
  • Involve sig-contributor-experience in the change, eg: chat about it in slack, mention @kubernetes/sig-contributor-experience-pr-reviews in the PR, etc.
  • After the PR is merged, a kubernetes CronJob is responsible for syncing labels daily

Labels that apply to all repos, for both issues and PRs

Name Description Added By Prow Plugin
committee/conduct Denotes an issue or PR intended to be handled by the code of conduct committee. anyone label
committee/steering Denotes an issue or PR intended to be handled by the steering committee. anyone label
kind/api-change Categorizes issue or PR as related to adding, removing, or otherwise changing an API

This was previously kind/new-api,
anyone label
kind/bug Categorizes issue or PR as related to a bug.

This was previously bug,
anyone label
kind/cleanup Categorizes issue or PR as related to cleaning up code, process, or technical debt.

This was previously kind/friction, kind/technical-debt,
anyone label
kind/design Categorizes issue or PR as related to design. anyone label
kind/documentation Categorizes issue or PR as related to documentation.

This was previously kind/old-docs,
anyone label
kind/failing-test Categorizes issue or PR as related to a consistently or frequently failing test.

This was previously priority/failing-test, kind/e2e-test-failure, kind/upgrade-test-failure,
anyone label
kind/feature Categorizes issue or PR as related to a new feature.

This was previously enhancement, kind/enhancement,
anyone label
kind/flake Categorizes issue or PR as related to a flaky test. anyone label
lifecycle/active Indicates that an issue or PR is actively being worked on by a contributor.

This was previously active,
anyone lifecycle
lifecycle/frozen Indicates that an issue or PR should not be auto-closed due to staleness.

This was previously keep-open,
anyone lifecycle
lifecycle/rotten Denotes an issue or PR that has aged beyond stale and will be auto-closed. anyone or @fejta-bot via periodic-test-infra-rotten prowjob lifecycle
lifecycle/stale Denotes an issue or PR has remained open with no activity and has become stale.

This was previously stale,
anyone or @fejta-bot via periodic-test-infra-stale prowjob lifecycle
needs-sig Indicates an issue or PR lacks a sig/foo label and requires one. prow require-matching-label
priority/awaiting-more-evidence Lowest priority. Possibly useful, but not yet enough support to actually get it done. anyone label
priority/backlog Higher priority than priority/awaiting-more-evidence. anyone label
priority/critical-urgent Highest priority. Must be actively worked on as someone's top priority right now. anyone label
priority/important-longterm Important over the long term, but may not be staffed and/or may need multiple releases to complete. anyone label
priority/important-soon Must be staffed and worked on either currently, or very soon, ideally in time for the next release. anyone label
sig/api-machinery Categorizes an issue or PR as relevant to sig-api-machinery. anyone label
sig/apps Categorizes an issue or PR as relevant to sig-apps. anyone label
sig/architecture Categorizes an issue or PR as relevant to sig-architecture. anyone label
sig/auth Categorizes an issue or PR as relevant to sig-auth. anyone label
sig/autoscaling Categorizes an issue or PR as relevant to sig-autoscaling. anyone label
sig/aws Categorizes an issue or PR as relevant to sig-aws. anyone label
sig/azure Categorizes an issue or PR as relevant to sig-azure. anyone label
sig/big-data Categorizes an issue or PR as relevant to sig-big-data. anyone label
sig/cli Categorizes an issue or PR as relevant to sig-cli. anyone label
sig/cloud-provider Categorizes an issue or PR as relevant to sig-cloud-provider. anyone label
sig/cluster-lifecycle Categorizes an issue or PR as relevant to sig-cluster-lifecycle. anyone label
sig/cluster-ops Categorizes an issue or PR as relevant to sig-cluster-ops. anyone label
sig/contributor-experience Categorizes an issue or PR as relevant to sig-contributor-experience. anyone label
sig/docs Categorizes an issue or PR as relevant to sig-docs. anyone label
sig/gcp Categorizes an issue or PR as relevant to sig-gcp. anyone label
sig/ibmcloud Categorizes an issue or PR as relevant to sig-ibmcloud. anyone label
sig/instrumentation Categorizes an issue or PR as relevant to sig-multicluster. anyone label
sig/multicluster Categorizes an issue or PR as relevant to sig-multicluster.

This was previously sig/federation, sig/federation (deprecated - do not use),
anyone label
sig/network Categorizes an issue or PR as relevant to sig-network. anyone label
sig/node Categorizes an issue or PR as relevant to sig-node. anyone label
sig/onprem Categorizes an issue or PR as relevant to sig-onprem. anyone label
sig/openstack Categorizes an issue or PR as relevant to sig-openstack. anyone label
sig/pm Categorizes an issue or PR as relevant to sig-pm. anyone label
sig/release Categorizes an issue or PR as relevant to sig-release. anyone label
sig/scalability Categorizes an issue or PR as relevant to sig-scalability. anyone label
sig/scheduling Categorizes an issue or PR as relevant to sig-scheduling. anyone label
sig/service-catalog Categorizes an issue or PR as relevant to sig-service-catalog. anyone label
sig/storage Categorizes an issue or PR as relevant to sig-storage. anyone label
sig/testing Categorizes an issue or PR as relevant to sig-testing. anyone label
sig/ui Categorizes an issue or PR as relevant to sig-ui. anyone label
sig/vmware Categorizes an issue or PR as relevant to sig-vmware. anyone label
sig/windows Categorizes an issue or PR as relevant to sig-windows. anyone label
status/approved-for-milestone Used during release burndown. Denotes an issue or PR is approved to be part of the release

This was previously approved-for-milestone,
members of a configurable github team. default: @kubernetes/kubernetes-milestone-maintainers milestonestatus
status/in-progress Used during release burndown. Denotes that an issue is actively being worked. members of a configurable github team. default: @kubernetes/kubernetes-milestone-maintainers milestonestatus
status/in-review Used during release burndown. Denotes that a fix for an issue is actively being reviewed. members of a configurable github team. default: @kubernetes/kubernetes-milestone-maintainers milestonestatus
triage/duplicate Indicates an issue is a duplicate of other open issue.

This was previously close/duplicate, duplicate,
humans
triage/needs-information Indicates an issue needs more information in order to work on it.

This was previously close/needs-information,
humans
triage/not-reproducible Indicates an issue can not be reproduced as described.

This was previously close/not-reproducible,
humans
triage/support Indicates an issue that is a support question.

This was previously close/support, kind/support, question,
humans
triage/unresolved Indicates an issue that can not or will not be resolved.

This was previously close/unresolved, invalid, wontfix,
humans
wg/app-def Categorizes an issue or PR as relevant to wg-app-def. anyone label
wg/apply Categorizes an issue or PR as relevant to wg-apply. anyone label
wg/cluster-api Categorizes an issue or PR as relevant to wg-cluster-api. anyone label
wg/container-identity Categorizes an issue or PR as relevant to wg-container-identity. anyone label
wg/iot-edge Categorizes an issue or PR as relevant to wg-iot-edge. anyone label
wg/kubeadm-adoption Categorizes an issue or PR as relevant to wg-kubeadm-adoption. anyone label
wg/machine-learning Categorizes an issue or PR as relevant to wg-machine-learning. anyone label
wg/multitenancy Categorizes an issue or PR as relevant to wg-multitenancy. anyone label
wg/policy Categorizes an issue or PR as relevant to wg-policy. anyone label
wg/resource-management Categorizes an issue or PR as relevant to wg-resource-management. anyone label
¯\_(ツ)_/¯ ¯_(ツ)_/¯ humans shrug

Labels that apply to all repos, only for issues

Name Description Added By Prow Plugin
good first issue Denotes an issue ready for a new contributor, according to the "help wanted" guidelines.

This was previously for-new-contributors,
anyone help
help wanted Denotes an issue that needs help from a contributor. Must meet "help wanted" guidelines.

This was previously help-wanted,
anyone help

Labels that apply to all repos, only for PRs

Name Description Added By Prow Plugin
approved Indicates a PR has been approved by an approver from all required OWNERS files. approvers approve
cherry-pick-approved Indicates a cherry-pick PR into a release branch has been approved by the release branch manager.

This was previously cherrypick-approved,
humans
cherrypick-candidate Denotes a PR to master as a candidate for cherry picking into a release branch. humans
cncf-cla: no Indicates the PR's author has not signed the CNCF CLA. prow cla
cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. prow cla
do-not-merge DEPRECATED. Indicates that a PR should not merge. Label can only be manually applied/removed. humans
do-not-merge/blocked-paths Indicates that a PR should not merge because it touches files in blocked paths. prow blockade
do-not-merge/cherry-pick-not-approved Indicates that a PR is not yet approved to merge into a release branch. prow cherrypickunapproved
do-not-merge/hold Indicates that a PR should not merge because someone has issued a /hold command. anyone hold
do-not-merge/invalid-owners-file Indicates that a PR should not merge because it has an invalid OWNERS file in it. prow verify-owners
do-not-merge/release-note-label-needed Indicates that a PR should not merge because it's missing one of the release note labels.

This was previously release-note-label-needed,
prow releasenote
do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. prow wip
lgtm Indicates that a PR is ready to be merged. reviewers or members lgtm
needs-kind Indicates a PR lacks a kind/foo label and requires one. prow require-matching-label
needs-ok-to-test Indicates a PR that requires an org member to verify it is safe to test. prow trigger
needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. prow needs-rebase
queue/blocks-others DEPRECATED. humans
queue/critical-fix DEPRECATED. humans
queue/fix DEPRECATED. humans
queue/multiple-rebases DEPRECATED. humans
release-note Denotes a PR that will be considered when it comes time to generate release notes. prow releasenote
release-note-action-required Denotes a PR that introduces potentially breaking changes that require user action. prow releasenote
release-note-none Denotes a PR that doesn't merit a release note. prow or member or author releasenote
retest-not-required Indicates that a PR doesn't need to be retested prior to merge. humans
retest-not-required-docs-only Indicates that a PR doesn't need to be retested prior to merge because it only changes docs. prow docs-no-retest
size/L Denotes a PR that changes 100-499 lines, ignoring generated files. prow size
size/M Denotes a PR that changes 30-99 lines, ignoring generated files. prow size
size/S Denotes a PR that changes 10-29 lines, ignoring generated files. prow size
size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. prow size
size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. prow size
size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. prow size
tide/squash Denotes a PR that should be squashed by tide when it merges. humans

Labels that apply to kubernetes/kubernetes, only for issues

Name Description Added By Prow Plugin
area/admin Indicates an issue on admin area. label
area/api Indicates an issue on api area. label

Labels that apply to kubernetes/test-infra, for both issues and PRs

Name Description Added By Prow Plugin
area/boskos Issues or PRs related to code in /boskos label
area/config Issues or PRs related to code in /config label
area/ghproxy Issues or PRs related to code in /ghproxy label
area/greenhouse Issues or PRs related to code in /greenhouse (our remote bazel cache) label
area/gubernator Issues or PRs related to code in /gubernator label
area/kind Issues or PRs related to code in /kind label
area/label_sync Issues or PRs related to code in /label_sync label
area/mungegithub Issues or PRs related to code in /mungegithub label
area/planter Issues or PRs related to code in /planter label
area/prow Issues or PRs related to prow label
area/prow/artifact-uploader Issues or PRs related to prow's artifact-uploader component label
area/prow/branchprotector Issues or PRs related to prow's branchprotector component label
area/prow/clonerefs Issues or PRs related to prow's clonerefs component label
area/prow/deck Issues or PRs related to prow's deck component label
area/prow/entrypoint Issues or PRs related to prow's entrypoint component label
area/prow/gcsupload Issues or PRs related to prow's gcsupload component label
area/prow/gerrit Issues or PRs related to prow's gerrit component label
area/prow/hook Issues or PRs related to prow's hook component label
area/prow/horologium Issues or PRs related to prow's horologium component label
area/prow/initupload Issues or PRs related to prow's initupload component label
area/prow/jenkins-operator Issues or PRs related to prow's jenkins-operator component label
area/prow/mkbuild-cluster Issues or PRs related to prow's mkbuild-cluster component label
area/prow/mkpj Issues or PRs related to prow's mkpj component label
area/prow/mkpod Issues or PRs related to prow's mkpod component label
area/prow/peribolos Issues or PRs related to prow's peribolos component label
area/prow/phony Issues or PRs related to prow's phony component label
area/prow/plank Issues or PRs related to prow's plank component label
area/prow/pod-utilities Issues or PRs related to prow's pod-utilities component label
area/prow/pubsub Issues or PRs related to prow's pubsub reporter component label
area/prow/sidecar Issues or PRs related to prow's sidecar component label
area/prow/sinker Issues or PRs related to prow's sinker component label
area/prow/splice Issues or PRs related to prow's splice component label
area/prow/spyglass Issues or PRs related to prow's spyglass UI label
area/prow/tide Issues or PRs related to prow's tide component label
area/prow/tot Issues or PRs related to prow's tot component label