Skip to content

docs: add karpenter.sh/nodepool, karpenter.k8s.aws/ec2nodeclass, topology.k8s.aws/zone-id labels to the list of well known labels. minor contribution guide update #8960

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.

Sign up for GitHub

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

Merged
DerekFrank merged 1 commit into from
Feb 11, 2026
Merged

docs: add karpenter.sh/nodepool, karpenter.k8s.aws/ec2nodeclass, topology.k8s.aws/zone-id labels to the list of well known labels. minor contribution guide update #8960

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion website/content/en/preview/concepts/scheduling.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -159,8 +159,10 @@ Take care to ensure the label domains are correct. A well known label like `karp
| kubernetes.io/os | linux | Operating systems are defined by [GOOS values](https://github.com/golang/go/blob/master/src/internal/syslist/syslist.go) (`KnownOS`) on the instance |
| kubernetes.io/arch | amd64 | Architectures are defined by [GOARCH values](https://github.com/golang/go/blob/master/src/internal/syslist/syslist.go) (`KnownArch`) on the instance |
| karpenter.sh/capacity-type | spot | Capacity types include `reserved`, `spot`, and `on-demand` |
| karpenter.sh/nodepool | default | The name of the nodepool used to provision the node. |
| karpenter.k8s.aws/capacity-reservation-id | cr-56fac701cc1951b03 | [AWS Specific] The capacity reservation ID. Only present on reserved nodes. |
| karpenter.k8s.aws/capacity-reservation-type | default | [AWS Specific] The capacity reservation type. Can be `default` or `capacity-block`. Only present on reserved nodes. |
| karpenter.k8s.aws/ec2nodeclass | default | [AWS Specific] The name of the ec2 nodeclass used to provision the node |
| karpenter.k8s.aws/instance-hypervisor | nitro | [AWS Specific] Instance types that use a specific hypervisor |
| karpenter.k8s.aws/instance-encryption-in-transit-supported | true | [AWS Specific] Instance types that support (or not) in-transit encryption |
| karpenter.k8s.aws/instance-category | g | [AWS Specific] Instance types of the same category, usually the string before the generation number |
Expand All @@ -180,7 +182,9 @@ Take care to ensure the label domains are correct. A well known label like `karp
| karpenter.k8s.aws/instance-gpu-memory | 16384 | [AWS Specific] Number of mebibytes of memory on the GPU |
| karpenter.k8s.aws/instance-local-nvme | 900 | [AWS Specific] Number of gibibytes of local nvme storage on the instance |
| karpenter.k8s.aws/instance-capability-flex | true | [AWS Specific] Instance with capacity flex |
| karpenter.k8s.aws/instance-tenancy | default | [AWS Specific] Tenancy types include `default`, and `dedicated` |
| karpenter.k8s.aws/instance-tenancy | default | [AWS Specific] Tenancy types include `default`, and `dedicated` |
| topology.k8s.aws/zone-id | use1-az1 | [AWS Specific] Globally consistent [zone id](https://docs.aws.amazon.com/global-infrastructure/latest/regions/az-ids.html) |


{{% alert title="Note" color="primary" %}}
Karpenter translates the following deprecated labels to their stable equivalents: `failure-domain.beta.kubernetes.io/zone`, `failure-domain.beta.kubernetes.io/region`, `beta.kubernetes.io/arch`, `beta.kubernetes.io/os`, and `beta.kubernetes.io/instance-type`.
Expand Down
2 changes: 1 addition & 1 deletion website/content/en/preview/contributing/documentation-updates.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,4 +9,4 @@ description: >
- Documentation for https://karpenter.sh/docs/ is built under website/content/en/preview/.
- Documentation updates should be made to the "preview" directory. Your changes will be promoted to website/content/en/docs/ by an automated process after the change has been merged.
- Previews for your changes are built and available a few minutes after you push. Look for the "Amplify Preview URL" link in a comment in your PR.
- If your update applies to more than just the current version of Karpenter, please backport your changes into all of the versions under website/content/en/
- If your update applies to more than just the current version of Karpenter, please backport your changes into all of the versions under website/content/en/ *besides* the /docs/ folder
3 changes: 3 additions & 0 deletions website/content/en/v1.0/concepts/scheduling.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -146,7 +146,9 @@ Take care to ensure the label domains are correct. A well known label like `karp
| node.kubernetes.io/windows-build | 10.0.17763 | Windows OS build in the format "MajorVersion.MinorVersion.BuildNumber". Can be `10.0.17763` for WS2019, or `10.0.20348` for WS2022. ([k8s](https://kubernetes.io/docs/reference/labels-annotations-taints/#nodekubernetesiowindows-build)) |
| kubernetes.io/os | linux | Operating systems are defined by [GOOS values](https://github.com/golang/go/blob/master/src/go/build/syslist.go#L10) on the instance |
| kubernetes.io/arch | amd64 | Architectures are defined by [GOARCH values](https://github.com/golang/go/blob/master/src/go/build/syslist.go#L50) on the instance |
| karpenter.sh/nodepool | default | The name of the nodepool used to provision the node. |
| karpenter.sh/capacity-type | spot | Capacity types include `spot`, `on-demand` |
| karpenter.k8s.aws/ec2nodeclass | default | [AWS Specific] The name of the ec2 nodeclass used to provision the node |
| karpenter.k8s.aws/instance-hypervisor | nitro | [AWS Specific] Instance types that use a specific hypervisor |
| karpenter.k8s.aws/instance-encryption-in-transit-supported | true | [AWS Specific] Instance types that support (or not) in-transit encryption |
| karpenter.k8s.aws/instance-category | g | [AWS Specific] Instance types of the same category, usually the string before the generation number |
Expand All @@ -164,6 +166,7 @@ Take care to ensure the label domains are correct. A well known label like `karp
| karpenter.k8s.aws/instance-gpu-count | 1 | [AWS Specific] Number of GPUs on the instance |
| karpenter.k8s.aws/instance-gpu-memory | 16384 | [AWS Specific] Number of mebibytes of memory on the GPU |
| karpenter.k8s.aws/instance-local-nvme | 900 | [AWS Specific] Number of gibibytes of local nvme storage on the instance |
| topology.k8s.aws/zone-id | use1-az1 | [AWS Specific] Globally consistent [zone id](https://docs.aws.amazon.com/global-infrastructure/latest/regions/az-ids.html) |

{{% alert title="Note" color="primary" %}}
Karpenter translates the following deprecated labels to their stable equivalents: `failure-domain.beta.kubernetes.io/zone`, `failure-domain.beta.kubernetes.io/region`, `beta.kubernetes.io/arch`, `beta.kubernetes.io/os`, and `beta.kubernetes.io/instance-type`.
Expand Down
2 changes: 1 addition & 1 deletion website/content/en/v1.0/contributing/documentation-updates.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,4 +9,4 @@ description: >
- Documentation for https://karpenter.sh/docs/ is built under website/content/en/preview/.
- Documentation updates should be made to the "preview" directory. Your changes will be promoted to website/content/en/docs/ by an automated process after the change has been merged.
- Previews for your changes are built and available a few minutes after you push. Look for the "Amplify Preview URL" link in a comment in your PR.
- If your update applies to more than just the current version of Karpenter, please backport your changes into all of the versions under website/content/en/
- If your update applies to more than just the current version of Karpenter, please backport your changes into all of the versions under website/content/en/ *besides* the /docs/ folder
3 changes: 3 additions & 0 deletions website/content/en/v1.7/concepts/scheduling.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -155,8 +155,10 @@ Take care to ensure the label domains are correct. A well known label like `karp
| kubernetes.io/os | linux | Operating systems are defined by [GOOS values](https://github.com/golang/go/blob/master/src/internal/syslist/syslist.go) (`KnownOS`) on the instance |
| kubernetes.io/arch | amd64 | Architectures are defined by [GOARCH values](https://github.com/golang/go/blob/master/src/internal/syslist/syslist.go) (`KnownArch`) on the instance |
| karpenter.sh/capacity-type | spot | Capacity types include `reserved`, `spot`, and `on-demand` |
| karpenter.sh/nodepool | default | The name of the nodepool used to provision the node. |
| karpenter.k8s.aws/capacity-reservation-id | cr-56fac701cc1951b03 | [AWS Specific] The capacity reservation ID. Only present on reserved nodes. |
| karpenter.k8s.aws/capacity-reservation-type | default | [AWS Specific] The capacity reservation type. Can be `default` or `capacity-block`. Only present on reserved nodes. |
| karpenter.k8s.aws/ec2nodeclass | default | [AWS Specific] The name of the ec2 nodeclass used to provision the node |
| karpenter.k8s.aws/instance-hypervisor | nitro | [AWS Specific] Instance types that use a specific hypervisor |
| karpenter.k8s.aws/instance-encryption-in-transit-supported | true | [AWS Specific] Instance types that support (or not) in-transit encryption |
| karpenter.k8s.aws/instance-category | g | [AWS Specific] Instance types of the same category, usually the string before the generation number |
Expand All @@ -176,6 +178,7 @@ Take care to ensure the label domains are correct. A well known label like `karp
| karpenter.k8s.aws/instance-gpu-memory | 16384 | [AWS Specific] Number of mebibytes of memory on the GPU |
| karpenter.k8s.aws/instance-local-nvme | 900 | [AWS Specific] Number of gibibytes of local nvme storage on the instance |
| karpenter.k8s.aws/instance-capability-flex | true | [AWS Specific] Instance with capacity flex |
| topology.k8s.aws/zone-id | use1-az1 | [AWS Specific] Globally consistent [zone id](https://docs.aws.amazon.com/global-infrastructure/latest/regions/az-ids.html) |

{{% alert title="Note" color="primary" %}}
Karpenter translates the following deprecated labels to their stable equivalents: `failure-domain.beta.kubernetes.io/zone`, `failure-domain.beta.kubernetes.io/region`, `beta.kubernetes.io/arch`, `beta.kubernetes.io/os`, and `beta.kubernetes.io/instance-type`.
Expand Down
2 changes: 1 addition & 1 deletion website/content/en/v1.7/contributing/documentation-updates.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,4 +9,4 @@ description: >
- Documentation for https://karpenter.sh/docs/ is built under website/content/en/preview/.
- Documentation updates should be made to the "preview" directory. Your changes will be promoted to website/content/en/docs/ by an automated process after the change has been merged.
- Previews for your changes are built and available a few minutes after you push. Look for the "Amplify Preview URL" link in a comment in your PR.
- If your update applies to more than just the current version of Karpenter, please backport your changes into all of the versions under website/content/en/
- If your update applies to more than just the current version of Karpenter, please backport your changes into all of the versions under website/content/en/ *besides* the /docs/ folder
Loading