Skip to content

Commit 914faaa

Browse files
authored
Merge pull request #49706 from gjenkins8/define_resource_glossary
Define 'resource' in glossary
2 parents 91919bd + acb85c3 commit 914faaa

File tree

3 files changed

+47
-3
lines changed

3 files changed

+47
-3
lines changed
Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
---
2+
title: API resource
3+
id: api-resource
4+
date: 2025-02-09
5+
full_link: /docs/reference/using-api/api-concepts/#standard-api-terminology
6+
short_description: >
7+
A Kubernetes entity, representing an endpoint on the Kubernetes API server.
8+
9+
aka:
10+
- Resource
11+
tags:
12+
- architecture
13+
---
14+
An entity in the Kubernetes type system, corresponding to an endpoint on the {{< glossary_tooltip text="Kubernetes API" term_id="kubernetes-api" >}}.
15+
A resource typically represents an {{< glossary_tooltip text="object" term_id="object" >}}.
16+
Some resources represent an operation on other objects, such as a permission check.
17+
<!--more-->
18+
Each resource represents an HTTP endpoint (URI) on the Kubernetes API server, defining the schema for the objects or operations on that resource.
Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
---
2+
title: Resource (infrastructure)
3+
id: infrastructure-resource
4+
date: 2025-02-09
5+
short_description: >
6+
A defined amount of infrastructure available for consumption (CPU, memory, etc).
7+
8+
aka:
9+
tags:
10+
- architecture
11+
---
12+
Capabilities provided to one or more {{< glossary_tooltip text="nodes" term_id="node" >}} (CPU, memory, GPUs, etc), and made available for consumption by
13+
{{< glossary_tooltip text="Pods" term_id="pod" >}} running on those nodes.
14+
15+
Kubernetes also uses the term _resource_ to describe an {{< glossary_tooltip text="API resource" term_id="api-resource" >}}.
16+
17+
<!--more-->
18+
Computers provide fundamental hardware facilities: processing power, storage memory, network, etc.
19+
These resources have finite capacity, measured in a unit applicable to that resource (number of CPUs, bytes of memory, etc).
20+
Kubernetes abstracts common [resources](/docs/concepts/configuration/manage-resources-containers/)
21+
for allocation to workloads and utilizes operating system primitives (for example, Linux {{< glossary_tooltip text="cgroups" term_id="cgroup" >}}) to manage consumption by {{< glossary_tooltip text="workloads" term_id="workload" >}}).
22+
23+
You can also use [dynamic resource allocation](/docs/concepts/scheduling-eviction/dynamic-resource-allocation/) to
24+
manage complex resource allocations automatically.

content/en/docs/reference/glossary/object.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,12 +5,14 @@ date: 2020-10-12
55
full_link: /docs/concepts/overview/working-with-objects/#kubernetes-objects
66
short_description: >
77
An entity in the Kubernetes system, representing part of the state of your cluster.
8-
aka:
8+
aka:
99
tags:
10+
- architecture
1011
- fundamental
1112
---
12-
An entity in the Kubernetes system. The Kubernetes API uses these entities to represent the state
13-
of your cluster.
13+
An entity in the Kubernetes system. An object is an
14+
{{< glossary_tooltip text="API resource" term_id="api-resource" >}} that the Kubernetes API
15+
uses to represent the state of your cluster.
1416
<!--more-->
1517
A Kubernetes object is typically a “record of intent”—once you create the object, the Kubernetes
1618
{{< glossary_tooltip text="control plane" term_id="control-plane" >}} works constantly to ensure

0 commit comments

Comments
 (0)