Tweak and use glossary entry for duration

- Revise wording
- Use the glossary entry where appropriate

Co-authored-by: Dipesh Rawat <rawat.dipesh@gmail.com>
pull/48241/head
Tim Bannister 2024-10-07 18:00:36 +01:00
parent a0020d3866
commit 255394310e
No known key found for this signature in database
GPG Key ID: 31BA93F2DB289EFE
2 changed files with 19 additions and 14 deletions

View File

@ -149,20 +149,15 @@ until disk usage reaches the `LowThresholdPercent` value.
As a beta feature, you can specify the maximum time a local image can be unused for, As a beta feature, you can specify the maximum time a local image can be unused for,
regardless of disk usage. This is a kubelet setting that you configure for each node. regardless of disk usage. This is a kubelet setting that you configure for each node.
To configure the setting, you need to set a value for the `imageMaximumGCAge` To configure the setting, you need to set a value for the `imageMaximumGCAge`
field in the kubelet configuration file. field in the kubelet configuration file.
The value is specified as a Kubernetes _duration_; The value is specified as a Kubernetes {{< glossary_tooltip text="duration" term_id="duration" >}}.
Valid time units for the `imageMaximumGCAge` field in the kubelet configuration file are: See [duration](/docs/reference/glossary/?all=true#term-duration) in the glossary
- "ns" for nanoseconds for more details.
- "us" or "µs" for microseconds
- "ms" for milliseconds
- "s" for seconds
- "m" for minutes
- "h" for hours
For example, you can set the configuration field to `12h45m`, For example, you can set the configuration field to `12h45m`,
which means 12 hours and 45 minutes. which means 12 hours and 45 minutes.
{{< note >}} {{< note >}}
This feature does not track image usage across kubelet restarts. If the kubelet This feature does not track image usage across kubelet restarts. If the kubelet

View File

@ -4,11 +4,21 @@ id: duration
date: 2024-10-05 date: 2024-10-05
full_link: full_link:
short_description: > short_description: >
A time interval specified as a string in the format accepted by Go's [time.Duration](https://pkg.go.dev/time), allowing for flexible time specifications using various units like seconds, minutes, and hours. A string value representing an amount of time.
aka:
tags: tags:
- fundamental - fundamental
--- ---
In Kubernetes APIs, a duration must be non-negative and is typically expressed with a suffix. A string value representing an amount of time.
For example, `5s` for five seconds or `1m30s` for one minute and thirty seconds.
<!--more-->
The format of a (Kubernetes) duration is based on the
[`time.Duration`](https://pkg.go.dev/time#Duration) type from the Go programming language.
In Kubernetes APIs that use durations, the value is expressed as series of a non-negative
integers combined with a time unit suffix. You can have more than one time quantity and
the duration is the sum of those time quantities.
The valid time units are "ns", "µs" (or "us"), "ms", "s", "m", and "h".
For example: `5s` represents a duration of five seconds, and `1m30s` represents a duration
of one minute and thirty seconds.