Skip to content

Commit

Permalink
zh-trans:/docs/concepts/overview/working-with-objects/names.md (#16812)
Browse files Browse the repository at this point in the history
Signed-off-by: PingWang <wang.ping5@zte.com.cn>

update /docs/concepts/overview/working-with-objects/names.md

Signed-off-by: PingWang <wang.ping5@zte.com.cn>

update some description

Signed-off-by: PingWang <wang.ping5@zte.com.cn>

update type

Signed-off-by: PingWang <wang.ping5@zte.com.cn>

add name and uid in /docs/reference/glossary/

Signed-off-by: PingWang <wang.ping5@zte.com.cn>
  • Loading branch information
ping035627 authored and k8s-ci-robot committed Oct 12, 2019
1 parent 981eee1 commit 36f4d27
Show file tree
Hide file tree
Showing 3 changed files with 119 additions and 0 deletions.
67 changes: 67 additions & 0 deletions content/zh/docs/concepts/overview/working-with-objects/names.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
---
title: 名称
content_template: templates/concept
weight: 20
---

{{% capture overview %}}

<!--
All objects in the Kubernetes REST API are unambiguously identified by a Name and a UID.
-->

Kubernetes REST API 中的所有对象都由名称和 UID 明确标识。

<!--
For non-unique user-provided attributes, Kubernetes provides [labels](/docs/user-guide/labels) and [annotations](/docs/concepts/overview/working-with-objects/annotations/).
See the [identifiers design doc](https://git.k8s.io/community/contributors/design-proposals/architecture/identifiers.md) for the precise syntax rules for Names and UIDs.
-->

对于非唯一的用户提供的属性,Kubernetes 提供了[标签](/docs/user-guide/labels)[注释](/docs/concepts/overview/working-with-objects/annotations/)

有关名称和 UID 的精确语法规则,请参见[标识符设计文档](https://git.k8s.io/community/contributors/design-proposals/architecture/identifiers.md)

{{% /capture %}}


{{% capture body %}}

<!--
## Names1
-->

## 名称

{{< glossary_definition term_id="name" length="all" >}}

<!--
By convention, the names of Kubernetes resources should be up to maximum length of 253 characters and consist of lower case alphanumeric characters, `-`, and `.`, but certain resources have more specific restrictions.
-->

按照惯例,Kubernetes 资源的名称最大长度应为 253 个字符,由小写字母、数字、`-``.` 组成,但某些资源有更具体的限制。

<!--
For example, here’s the configuration file with a Pod name as `nginx-demo` and a Container name as `nginx`:
-->

例如,下面是一个配置文件,Pod 名为 `nginx demo`,容器名为 `nginx`

```yaml
apiVersion: v1
kind: Pod
metadata:
name: nginx-demo
spec:
containers:
- name: nginx
image: nginx:1.7.9
ports:
- containerPort: 80
```
## UIDs
{{< glossary_definition term_id="uid" length="all" >}}
{{% /capture %}}
25 changes: 25 additions & 0 deletions content/zh/docs/reference/glossary/name.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
---
title: Name
id: name
date: 2018-04-12
full_link: /docs/concepts/overview/working-with-objects/names
short_description: >
A client-provided string that refers to an object in a resource URL, such as `/api/v1/pods/some-name`.
aka:
tags:
- fundamental
---
<!--
A client-provided string that refers to an object in a resource URL, such as `/api/v1/pods/some-name`.
-->

客户端提供的字符串,引用资源 url 中的对象,如`/api/v1/pods/some name`

<!--more-->

<!--
Only one object of a given kind can have a given name at a time. However, if you delete the object, you can make a new object with the same name.
-->

一次只能有一个给定类型的对象具有给定的名称。但是,如果删除对象,则可以创建同名的新对象。
27 changes: 27 additions & 0 deletions content/zh/docs/reference/glossary/uid.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
---
title: UID
id: uid
date: 2018-04-12
full_link: /docs/concepts/overview/working-with-objects/names
short_description: >
A Kubernetes systems-generated string to uniquely identify objects.
aka:
tags:
- fundamental
---
<!--
A Kubernetes systems-generated string to uniquely identify objects.
-->

Kubernetes 系统生成的字符串,唯一标识对象。

<!--more-->

<!--
Every object created over the whole lifetime of a Kubernetes cluster has a distinct UID. It is intended to distinguish between historical occurrences of similar entities.
-->

在 Kubernetes 集群的整个生命周期中创建的每个对象都有一个不同的 uid,它旨在区分类似实体的历史事件。


0 comments on commit 36f4d27

Please sign in to comment.