Skip to content

Commit

Permalink
split glossary terms
Browse files Browse the repository at this point in the history
Signed-off-by: George Jenkins <[email protected]>
  • Loading branch information
gjenkins8 committed Feb 12, 2025
1 parent caacd90 commit da32ca6
Show file tree
Hide file tree
Showing 4 changed files with 38 additions and 36 deletions.
18 changes: 18 additions & 0 deletions content/en/docs/reference/glossary/api-resource.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
---
title: API resource
id: api-resource
date: 2025-02-09
full_link: /docs/reference/using-api/api-concepts/#standard-api-terminology
short_description: >
A Kubernetes entity, representing an endpoint on the Kubernetes API server.
aka:
tags:
- fundamental
---
An entity in the Kubernetes type system, corresponding to an API endpoint on the {{< glossary_tooltip text="Kubernetes API" term_id="kubernetes-api" >}}.
A resource typically represents an {{< glossary_tooltip text="objects" term_id="object" >}}.
But sometime represents an operation on objects, such as a permission check.
<!--more-->
API resources compromise the Kubernetes type system which makes up the majority of the Kubernetes API.
Each resource represents an endpoint on the Kubernetes API server, defining the schema for the objects or operations on that resource.
18 changes: 18 additions & 0 deletions content/en/docs/reference/glossary/compute-resource.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
---
title: Resource (compute)
id: compute-resource
date: 2025-02-09
full_link: /docs/concepts/architecture/nodes/#node-capacity
short_description: >
A capability of a node availble for consumption (CPU, memory, etc).
aka:
tags:
- fundamental
---
Capability of {{< glossary_tooltip text="nodes" term_id="node" >}} available for consumption (CPU, memory, etc) by processes or users of those nodes.
<!--more-->
Computers provide fundamenal capabilties: processing power, storage memory, network, etc
These resources have finite capacity, measured in a unit applicable to that resource (Number of CPUs, bytes of memory, etc).
Kubernetes abstracts common resources for allocation to workloads.
And utilizes operating system primatives (e.g. {{< glossary_tooltip text="cgroups" term_id="cgroup" >}}) to manage consumption by {{< glossary_tooltip text="workloads" term_id="workload" >}}.
4 changes: 2 additions & 2 deletions content/en/docs/reference/glossary/object.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,8 @@ aka:
tags:
- fundamental
---
An entity in the Kubernetes system. An object is an API
{{< glossary_tooltip text="resource" term_id="resource" >}} that the Kubernetes API
An entity in the Kubernetes system. An object is an
{{< glossary_tooltip text="API resource" term_id="api-resource" >}} that the Kubernetes API
uses to represent the state of your cluster.
<!--more-->
A Kubernetes object is typically a “record of intent”—once you create the object, the Kubernetes
Expand Down
34 changes: 0 additions & 34 deletions content/en/docs/reference/glossary/resource.md

This file was deleted.

0 comments on commit da32ca6

Please sign in to comment.