[zh-cn]sync custom-resources.md

Signed-off-by: xin.li <xin.li@daocloud.io>
This commit is contained in:
xin.li 2022-08-29 21:25:50 +08:00
parent a4b6b86c79
commit 54992c4dec
1 changed files with 11 additions and 11 deletions

View File

@ -50,8 +50,8 @@ many core Kubernetes functions are now built using custom resources, making Kube
Custom resources can appear and disappear in a running cluster through dynamic registration, Custom resources can appear and disappear in a running cluster through dynamic registration,
and cluster admins can update custom resources independently of the cluster itself. and cluster admins can update custom resources independently of the cluster itself.
Once a custom resource is installed, users can create and access its objects using Once a custom resource is installed, users can create and access its objects using
[kubectl](/docs/reference/kubectl/), just as they do for built-in resources like {{< glossary_tooltip text="kubectl" term_id="kubectl" >}}, just as they do for built-in resources
*Pods*. like *Pods*.
--> -->
**定制资源Custom Resource** 是对 Kubernetes API 的扩展,不一定在默认的 **定制资源Custom Resource** 是对 Kubernetes API 的扩展,不一定在默认的
Kubernetes 安装中就可用。 Kubernetes 安装中就可用。
@ -59,7 +59,7 @@ Kubernetes 安装中就可用。
不过,很多 Kubernetes 核心功能现在都用定制资源来实现,这使得 Kubernetes 更加模块化。 不过,很多 Kubernetes 核心功能现在都用定制资源来实现,这使得 Kubernetes 更加模块化。
定制资源可以通过动态注册的方式在运行中的集群内或出现或消失,集群管理员可以独立于集群更新定制资源。 定制资源可以通过动态注册的方式在运行中的集群内或出现或消失,集群管理员可以独立于集群更新定制资源。
一旦某定制资源被安装,用户可以使用 [kubectl](/zh-cn/docs/reference/kubectl/) 来创建和访问其中的对象, 一旦某定制资源被安装,用户可以使用 {{< glossary_tooltip text="kubectl" term_id="kubectl" >}} 来创建和访问其中的对象,
就像他们为 **Pod** 这种内置资源所做的一样。 就像他们为 **Pod** 这种内置资源所做的一样。
<!-- <!--
@ -100,7 +100,7 @@ for specific applications into an extension of the Kubernetes API.
你可以使用定制控制器来将特定于某应用的领域知识组织起来,以编码的形式构造对 Kubernetes API 的扩展。 你可以使用定制控制器来将特定于某应用的领域知识组织起来,以编码的形式构造对 Kubernetes API 的扩展。
<!-- <!--
## Should I add a custom resource to my Kubernetes Cluster? ## Should I add a custom resource to my Kubernetes cluster?
When creating a new API, consider whether to When creating a new API, consider whether to
[aggregate your API with the Kubernetes cluster APIs](/docs/concepts/extend-kubernetes/api-extension/apiserver-aggregation/) [aggregate your API with the Kubernetes cluster APIs](/docs/concepts/extend-kubernetes/api-extension/apiserver-aggregation/)
@ -185,13 +185,13 @@ Signs that your API might not be declarative include:
- 你决定使用操作 ID 或者操作对象来表现悬决的操作。 - 你决定使用操作 ID 或者操作对象来表现悬决的操作。
<!-- <!--
## Should I use a configMap or a custom resource? ## Should I use a ConfigMap or a custom resource?
Use a ConfigMap if any of the following apply: Use a ConfigMap if any of the following apply:
* There is an existing, well-documented config file format, such as a `mysql.cnf` or `pom.xml`. * There is an existing, well-documented configuration file format, such as a `mysql.cnf` or `pom.xml`.
* You want to put the entire config file into one key of a configMap. * You want to put the entire configuration file into one key of a configMap.
* The main use of the config file is for a program running in a Pod on your cluster to consume the file to configure itself. * The main use of the configuration file is for a program running in a Pod on your cluster to consume the file to configure itself.
* Consumers of the file prefer to consume via file in a Pod or environment variable in a pod, rather than the Kubernetes API. * Consumers of the file prefer to consume via file in a Pod or environment variable in a pod, rather than the Kubernetes API.
* You want to perform rolling updates via Deployment, etc., when the file is updated. * You want to perform rolling updates via Deployment, etc., when the file is updated.
--> -->
@ -207,10 +207,10 @@ Use a ConfigMap if any of the following apply:
* 你希望当文件被更新时通过类似 Deployment 之类的资源完成滚动更新操作。 * 你希望当文件被更新时通过类似 Deployment 之类的资源完成滚动更新操作。
<!-- <!--
Use a [secret](/docs/concepts/configuration/secret/) for sensitive data, which is similar to a configMap but more secure. Use a {{< glossary_tooltip text="Secret" term_id="secret" >}} for sensitive data, which is similar to a configMap but more secure.
--> -->
{{< note >}} {{< note >}}
请使用 [Secret](/zh-cn/docs/concepts/configuration/secret/) 来保存敏感数据。 请使用 {{< glossary_tooltip text="Secret" term_id="secret" >}} 来保存敏感数据。
Secret 类似于 configMap但更为安全。 Secret 类似于 configMap但更为安全。
{{< /note >}} {{< /note >}}
@ -525,7 +525,7 @@ Kubernetes [client libraries](/docs/reference/using-api/client-libraries/) can b
When you add a custom resource, you can access it using: When you add a custom resource, you can access it using:
- `kubectl` - `kubectl`
- The kubernetes dynamic client. - The Kubernetes dynamic client.
- A REST client that you write. - A REST client that you write.
- A client generated using [Kubernetes client generation tools](https://github.com/kubernetes/code-generator) (generating one is an advanced undertaking, but some projects may provide a client along with the CRD or AA). - A client generated using [Kubernetes client generation tools](https://github.com/kubernetes/code-generator) (generating one is an advanced undertaking, but some projects may provide a client along with the CRD or AA).
--> -->