Skip to content

Commit d13fc66

Browse files
windsonseawindsonsea
committed
Add glossary: api-resource and infrastructure-resource
1 parent 914faaa commit d13fc66

File tree

3 files changed

+105
-6
lines changed

3 files changed

+105
-6
lines changed

‎content/zh-cn/docs/reference/glossary/api-resource.md

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
---
2+
title: API 资源
3+
id: api-resource
4+
date: 2025-02-09
5+
full_link: /zh-cn/docs/reference/using-api/api-concepts/#standard-api-terminology
6+
short_description: >
7+
Kubernetes 实体，表示 Kubernetes API 服务器上的端点。
8+
9+
aka:
10+
- Resource
11+
tags:
12+
- architecture
13+
---
14+
<!--
15+
title: API resource
16+
id: api-resource
17+
date: 2025-02-09
18+
full_link: /docs/reference/using-api/api-concepts/#standard-api-terminology
19+
short_description: >
20+
A Kubernetes entity, representing an endpoint on the Kubernetes API server.
21+
22+
aka:
23+
- Resource
24+
tags:
25+
- architecture
26+
-->
27+
28+
<!--
29+
An entity in the Kubernetes type system, corresponding to an endpoint on the {{< glossary_tooltip text="Kubernetes API" term_id="kubernetes-api" >}}.
30+
A resource typically represents an {{< glossary_tooltip text="object" term_id="object" >}}.
31+
Some resources represent an operation on other objects, such as a permission check.
32+
-->
33+
Kubernetes 类别系统中的实体，对应于
34+
{{< glossary_tooltip text="Kubernetes API" term_id="kubernetes-api" >}} 上的端点。
35+
一个资源通常表示一个{{< glossary_tooltip text="对象" term_id="object" >}}。
36+
一些资源表示对其他对象执行的操作，例如权限检查。
37+
38+
<!--more-->
39+
40+
<!--
41+
Each resource represents an HTTP endpoint (URI) on the Kubernetes API server, defining the schema for the objects or operations on that resource.
42+
-->
43+
每个资源表示 Kubernetes API 服务器上的一个 HTTP 端点（URI），用于定义该资源的对象或操作的模式。

‎content/zh-cn/docs/reference/glossary/infrastructure-resource.md

Lines changed: 53 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,53 @@
1+
---
2+
title: 资源（基础设施）
3+
id: infrastructure-resource
4+
date: 2025-02-09
5+
short_description: >
6+
数量确定的可供使用的基础设施（CPU、内存等）。
7+
8+
aka:
9+
tags:
10+
- architecture
11+
---
12+
<!--
13+
title: Resource (infrastructure)
14+
id: infrastructure-resource
15+
date: 2025-02-09
16+
short_description: >
17+
A defined amount of infrastructure available for consumption (CPU, memory, etc).
18+
19+
aka:
20+
tags:
21+
- architecture
22+
-->
23+
24+
<!--
25+
Capabilities provided to one or more {{< glossary_tooltip text="nodes" term_id="node" >}} (CPU, memory, GPUs, etc), and made available for consumption by
26+
{{< glossary_tooltip text="Pods" term_id="pod" >}} running on those nodes.
27+
28+
Kubernetes also uses the term _resource_ to describe an {{< glossary_tooltip text="API resource" term_id="api-resource" >}}.
29+
-->
30+
提供给一个或多个{{< glossary_tooltip text="节点" term_id="node" >}}的能力（CPU、内存、GPU 等），
31+
这些能力可以供这些节点上运行的 {{< glossary_tooltip text="Pod" term_id="pod" >}} 使用。
32+
33+
Kubernetes 也使用**资源**这个术语来描述 {{< glossary_tooltip text="API 资源" term_id="api-resource" >}}。
34+
35+
<!--more-->
36+
37+
<!--
38+
Computers provide fundamental hardware facilities: processing power, storage memory, network, etc.
39+
These resources have finite capacity, measured in a unit applicable to that resource (number of CPUs, bytes of memory, etc).
40+
Kubernetes abstracts common [resources](/docs/concepts/configuration/manage-resources-containers/)
41+
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" >}}).
42+
-->
43+
计算机提供基础硬件设施：处理能力、存储内存、网络等。
44+
这些资源的容量有限，每个资源具有合适的测量单位（CPU 个数、内存字节数等）。
45+
Kubernetes 抽象出常见的[资源](/zh-cn/docs/concepts/configuration/manage-resources-containers/)分配给工作负载，
46+
并利用操作系统的原语（例如 Linux {{< glossary_tooltip text="cgroup" term_id="cgroup" >}}）
47+
来管理{{< glossary_tooltip text="工作负载" term_id="workload" >}}的使用。
48+
49+
<!--
50+
You can also use [dynamic resource allocation](/docs/concepts/scheduling-eviction/dynamic-resource-allocation/) to
51+
manage complex resource allocations automatically.
52+
-->
53+
你也可以使用[动态资源分配](/zh-cn/docs/concepts/scheduling-eviction/dynamic-resource-allocation/)来自动管理复杂的资源分配。

‎content/zh-cn/docs/reference/glossary/object.md

Lines changed: 9 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ short_description: >
77
Kubernetes 系统中的实体，代表了集群的部分状态。
88
aka:
99
tags:
10+
- architecture
1011
- fundamental
1112
---
1213
<!--
@@ -16,19 +17,22 @@ date: 2020-10-12
1617
full_link: /docs/concepts/overview/working-with-objects/#kubernetes-objects
1718
short_description: >
1819
An entity in the Kubernetes system, representing part of the state of your cluster.
19-
aka:
20+
aka:
2021
tags:
22+
- architecture
2123
- fundamental
2224
-->
2325

2426
<!--
25-
An entity in the Kubernetes system. The Kubernetes API uses these entities to represent the state
26-
of your cluster.
27+
An entity in the Kubernetes system. An object is an
28+
{{< glossary_tooltip text="API resource" term_id="api-resource" >}} that the Kubernetes API
29+
uses to represent the state of your cluster.
2730
-->
28-
Kubernetes 系统中的实体。Kubernetes API 用这些实体表示集群的状态。
31+
Kubernetes 系统中的实体。对象是 Kubernetes API 用于表示集群状态的
32+
{{< glossary_tooltip text="API 资源" term_id="api-resource" >}}。
2933

3034
<!--more-->
31-
<!--
35+
<!--
3236
A Kubernetes object is typically a “record of intent”—once you create the object, the Kubernetes
3337
{{< glossary_tooltip text="control plane" term_id="control-plane" >}} works constantly to ensure
3438
that the item it represents actually exists.
@@ -39,4 +43,3 @@ Kubernetes 对象通常是一个“意向表述（Record of Intent）”—一
3943
{{< glossary_tooltip text="控制平面（Control Plane）" term_id="control-plane" >}} 就不断工作，
4044
以确保它所代表的事物确实存在。
4145
创建一个对象相当于告知 Kubernetes 系统：你期望这部分集群负载看起来像什么；这也就是你集群的期望状态。
42-

0 commit comments

Comments
 (0)