whentimeslows/website
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

[zh] Tidy up and fix links in tasks section (6/10)

Browse Source
This commit is contained in:
Qiming Teng
2020-08-14 15:14:21 +08:00
parent fcd8af988c
commit 2c8a55a6e6
8 changed files with 689 additions and 650 deletions
Download Patch File Download Diff File Expand all files Collapse all files
content/zh/docs/tasks/administer-cluster/namespaces-walkthrough.md
+182 -136
View File
@@ -1,81 +1,82 @@
---
reviewers:
- derekwaynecarr
- janetkuo
title: 命名空间演练
title: 名字空间演练
content_type: task
---
<!-- ---
<!--
reviewers:
- derekwaynecarr
- janetkuo
title: Namespaces Walkthrough
content_type: task
--- -->
-->
<!-- overview -->
<!-- Kubernetes {{< glossary_tooltip text="namespaces" term_id="namespace" >}}
help different projects, teams, or customers to share a Kubernetes cluster. -->
Kubernetes {{< glossary_tooltip text="命名空间" term_id="namespace" >}}
<!--
Kubernetes {{< glossary_tooltip text="namespaces" term_id="namespace" >}}
help different projects, teams, or customers to share a Kubernetes cluster.
-->
Kubernetes {{< glossary_tooltip text="名字空间" term_id="namespace" >}}
有助于不同的项目、团队或客户去共享 Kubernetes 集群。
<!-- It does this by providing the following:
<!--
It does this by providing the following:
1. A scope for [Names](/docs/concepts/overview/working-with-objects/names/).
2. A mechanism to attach authorization and policy to a subsection of the cluster. -->
2. A mechanism to attach authorization and policy to a subsection of the cluster.
-->
名字空间通过以下方式实现这点：
1. 为[名字](/docs/concepts/overview/working-with-objects/names/)设置作用域.
1. 为[名字](/zh/docs/concepts/overview/working-with-objects/names/)设置作用域.
2. 为集群中的部分资源关联鉴权和策略的机制。
<!-- Use of multiple namespaces is optional. -->
使用多个命名空间是可选的。
<!-- This example demonstrates how to use Kubernetes namespaces to subdivide your cluster. -->
此示例演示了如何使用 Kubernetes 命名空间细分群集。
<!--
Use of multiple namespaces is optional.
This example demonstrates how to use Kubernetes namespaces to subdivide your cluster.
-->
使用多个名字空间是可选的。
此示例演示了如何使用 Kubernetes 名字空间细分群集。
## {{% heading "prerequisites" %}}
{{< include "task-tutorial-prereqs.md" >}} {{< version-check >}}
<!-- steps -->
<!-- ## Prerequisites -->
<!--
## Prerequisites
## 环境准备
<!-- This example assumes the following:
This example assumes the following:
1. You have an [existing Kubernetes cluster](/docs/setup/).
2. You have a basic understanding of Kubernetes _[Pods](/docs/concepts/workloads/pods/pod/)_, _[Services](/docs/concepts/services-networking/service/)_, and _[Deployments](/docs/concepts/workloads/controllers/deployment/)_. -->
2. You have a basic understanding of Kubernetes _[Pods](/docs/concepts/workloads/pods/pod/)_, _[Services](/docs/concepts/services-networking/service/)_, and _[Deployments](/docs/concepts/workloads/controllers/deployment/)_.
-->
## 环境准备
此示例作如下假设：
1. 您已拥有一个 [配置好的 Kubernetes 集群](/docs/setup/)。
2. 您已对 Kubernetes 的 _[Pods](/docs/concepts/workloads/pods/pod/)_, _[Services](/docs/concepts/services-networking/service/)_ 和 _[Deployments](/docs/concepts/workloads/controllers/deployment/)_ 有基本理解。
1. 你已拥有一个[配置好的 Kubernetes 集群](/zh/docs/setup/)。
2. 你已对 Kubernetes 的 _[Pods](/zh/docs/concepts/workloads/pods/)_、
_[Services](/zh/docs/concepts/services-networking/service/)_ 和
_[Deployments](/zh/docs/concepts/workloads/controllers/deployment/)_
有基本理解。
<!-- ## Understand the default namespace
<!--
## Understand the default namespace
By default, a Kubernetes cluster will instantiate a default namespace when provisioning the cluster to hold the default set of Pods,
Services, and Deployments used by the cluster. -->
Services, and Deployments used by the cluster.
-->
1. 理解默认名字空间
1. 理解默认命名空间
默认情况下，Kubernetes 集群会在配置集群时实例化一个默认名字空间，用以存放集群所使用的默认
Pod、Service 和 Deployment 集合。
默认情况下，Kubernetes 集群会在配置集群时实例化一个默认命名空间，用以存放集群所使用的默认 Pods、Services 和 Deployments 集合。
<!-- Assuming you have a fresh cluster, you can inspect the available namespaces by doing the following: -->
假设您有一个新的集群，您可以通过执行以下操作来检查可用的命名空间：
<!--
Assuming you have a fresh cluster, you can inspect the available namespaces by doing the following:
-->
假设你有一个新的集群，你可以通过执行以下操作来检查可用的名字空间：
```shell
kubectl get namespaces
@@ -85,72 +86,89 @@ NAME STATUS AGE
default Active 13m
```
<!-- ## Create new namespaces -->
<!--
## Create new namespaces
## 创建新的命名空间
For this exercise, we will create two additional Kubernetes namespaces to hold our content.
-->
## 创建新的名字空间
<!-- For this exercise, we will create two additional Kubernetes namespaces to hold our content. -->
在本练习中，我们将创建两个额外的 Kubernetes 命名空间来保存我们的内容。
<!-- Let's imagine a scenario where an organization is using a shared Kubernetes cluster for development and production use cases. -->
在本练习中，我们将创建两个额外的 Kubernetes 名字空间来保存我们的内容。
<!--
Let's imagine a scenario where an organization is using a shared Kubernetes cluster for development and production use cases.
-->
我们假设一个场景，某组织正在使用共享的 Kubernetes 集群来支持开发和生产：
<!-- The development team would like to maintain a space in the cluster where they can get a view on the list of Pods, Services, and Deployments
<!--
The development team would like to maintain a space in the cluster where they can get a view on the list of Pods, Services, and Deployments
they use to build and run their application. In this space, Kubernetes resources come and go, and the restrictions on who can or cannot modify resources
are relaxed to enable agile development. -->
are relaxed to enable agile development.
-->
开发团队希望在集群中维护一个空间，以便他们可以查看用于构建和运行其应用程序的 Pod、Service
和 Deployment 列表。在这个空间里，Kubernetes 资源被自由地加入或移除，
对谁能够或不能修改资源的限制被放宽，以实现敏捷开发。
开发团队希望在集群中维护一个空间，以便他们可以查看用于构建和运行其应用程序的 Pods、Services 和 Deployments 列表。在这个空间里，Kubernetes 资源被自由地加入或移除，对谁能够或不能修改资源的限制被放宽，以实现敏捷开发。
<!--
The operations team would like to maintain a space in the cluster where they can enforce strict procedures on who can or cannot manipulate the set of
Pods, Services, and Deployments that run the production site.
-->
运维团队希望在集群中维护一个空间，以便他们可以强制实施一些严格的规程，
对谁可以或谁不可以操作运行生产站点的 Pod、Service 和 Deployment 集合进行控制。
<!-- The operations team would like to maintain a space in the cluster where they can enforce strict procedures on who can or cannot manipulate the set of
Pods, Services, and Deployments that run the production site. -->
<!--
One pattern this organization could follow is to partition the Kubernetes cluster into two namespaces: `development` and `production`.
-->
该组织可以遵循的一种模式是将 Kubernetes 集群划分为两个名字空间：`development` 和 `production`。
运维团队希望在集群中维护一个空间，以便他们可以强制实施一些严格的规程，对谁可以或谁不可以操作运行生产站点的 Pods、Services 和 Deployments 集合进行控制。
<!--
Let's create two new namespaces to hold our work.
-->
让我们创建两个新的名字空间来保存我们的工作。
<!-- One pattern this organization could follow is to partition the Kubernetes cluster into two namespaces: `development` and `production`. -->
该组织可以遵循的一种模式是将 Kubernetes 集群划分为两个命名空间：development 和 production。
<!-- Let's create two new namespaces to hold our work. -->
让我们创建两个新的命名空间来保存我们的工作。
<!-- Use the file [`namespace-dev.json`](/examples/admin/namespace-dev.json) which describes a `development` namespace: -->
文件 [`namespace-dev.json`](/examples/admin/namespace-dev.json) 描述了 development 命名空间:
<!--
Use the file [`namespace-dev.json`](/examples/admin/namespace-dev.json) which describes a `development` namespace:
-->
文件 [`namespace-dev.json`](/examples/admin/namespace-dev.json) 描述了 `development` 名字空间:
{{< codenew language="json" file="admin/namespace-dev.json" >}}
<!-- Create the `development` namespace using kubectl. -->
<!--
Create the `development` namespace using kubectl.
-->
使用 kubectl 创建 development 命名空间。
使用 kubectl 创建 `development` 名字空间。
```shell
kubectl create -f https://k8s.io/examples/admin/namespace-dev.json
```
<!-- Save the following contents into file [`namespace-prod.json`](/examples/admin/namespace-prod.json) which describes a `production` namespace: -->
将下列的内容保存到文件 [`namespace-prod.json`](/examples/admin/namespace-prod.json) 中，这些内容是对 production 命名空间的描述：
<!--
Save the following contents into file [`namespace-prod.json`](/examples/admin/namespace-prod.json) which describes a `production` namespace:
-->
将下列的内容保存到文件 [`namespace-prod.json`](/examples/admin/namespace-prod.json) 中，
这些内容是对 `production` 名字空间的描述：
{{< codenew language="json" file="admin/namespace-prod.json" >}}
<!-- And then let's create the `production` namespace using kubectl. -->
让我们使用 kubectl 创建 production 命名空间。
<!--
And then let's create the `production` namespace using kubectl.
-->
让我们使用 kubectl 创建 `production` 名字空间。
```shell
kubectl create -f https://k8s.io/examples/admin/namespace-prod.json
```
<!-- To be sure things are right, let's list all of the namespaces in our cluster. -->
为了确保一切正常，我们列出集群中的所有命名空间。
<!--
To be sure things are right, let's list all of the namespaces in our cluster.
-->
为了确保一切正常，我们列出集群中的所有名字空间。
```shell
kubectl get namespaces --show-labels
```
```
NAME STATUS AGE LABELS
default Active 32m <none>
@@ -158,29 +176,32 @@ development Active 29s name=development
production Active 23s name=production
```
<!-- ## Create pods in each namespace -->
<!--
## Create pods in each namespace
## 在每个命名空间中创建 pod
A Kubernetes namespace provides the scope for Pods, Services, and Deployments in the cluster.
<!-- A Kubernetes namespace provides the scope for Pods, Services, and Deployments in the cluster.
Users interacting with one namespace do not see the content in another namespace.
Users interacting with one namespace do not see the content in another namespace. -->
To demonstrate this, let's spin up a simple Deployment and Pods in the `development` namespace.
-->
## 在每个名字空间中创建 pod
Kubernetes 命名空间为集群中的 Pods、Services 和 Deployments 提供了作用域。
Kubernetes 名字空间为集群中的 Pod、Service 和 Deployment 提供了作用域。
与一个命名空间交互的用户不会看到另一个命名空间中的内容。
与一个名字空间交互的用户不会看到另一个名字空间中的内容。
<!-- To demonstrate this, let's spin up a simple Deployment and Pods in the `development` namespace. -->
为了演示这一点，让我们在 development 命名空间中启动一个简单的 Deployment 和 Pod。
<!-- We first check what is the current context: -->
为了演示这一点，让我们在 development 名字空间中启动一个简单的 Deployment 和 Pod。
<!--
We first check what is the current context:
-->
我们首先检查一下当前的上下文：
```shell
kubectl config view
```
```yaml
apiVersion: v1
clusters:
@@ -207,6 +228,7 @@ users:
password: h5M0FtUUIflBSdI7
username: admin
```
```shell
kubectl config current-context
```
@@ -214,9 +236,11 @@ kubectl config current-context
lithe-cocoa-92103_kubernetes
```
<!-- The next step is to define a context for the kubectl client to work in each namespace. The value of "cluster" and "user" fields are copied from the current context. -->
下一步是为 kubectl 客户端定义一个上下文，以便在每个命名空间中工作。"cluster" 和 "user" 字段的值将从当前上下文中复制。
<!--
The next step is to define a context for the kubectl client to work in each namespace. The value of "cluster" and "user" fields are copied from the current context.
-->
下一步是为 kubectl 客户端定义一个上下文，以便在每个名字空间中工作。
"cluster" 和 "user" 字段的值将从当前上下文中复制。
```shell
kubectl config set-context dev --namespace=development \
@@ -228,15 +252,17 @@ kubectl config set-context prod --namespace=production \
--user=lithe-cocoa-92103_kubernetes
```
<!-- By default, the above commands adds two contexts that are saved into file
<!--
By default, the above commands adds two contexts that are saved into file
`.kube/config`. You can now view the contexts and alternate against the two
new request contexts depending on which namespace you wish to work against. -->
默认地，上述命令会添加两个上下文到 `.kube/config` 文件中。
您现在可以查看上下文并根据您希望使用的命名空间并在这两个新的请求上下文之间切换。
<!-- To view the new contexts: -->
new request contexts depending on which namespace you wish to work against.
-->
默认情况下，上述命令会添加两个上下文到 `.kube/config` 文件中。
你现在可以查看上下文并根据你希望使用的名字空间并在这两个新的请求上下文之间切换。
<!--
To view the new contexts:
-->
查看新的上下文：
```shell
@@ -279,41 +305,50 @@ users:
username: admin
```
<!-- Let's switch to operate in the `development` namespace. -->
让我们切换到 development 命名空间进行操作。
<!--
Let's switch to operate in the `development` namespace.
-->
让我们切换到 `development` 名字空间进行操作。
```shell
kubectl config use-context dev
```
<!-- You can verify your current context by doing the following: -->
您可以使用下列命令验证当前上下文：
<!--
You can verify your current context by doing the following:
-->
你可以使用下列命令验证当前上下文：
```shell
kubectl config current-context
```
```
dev
```
<!-- At this point, all requests we make to the Kubernetes cluster from the command line are scoped to the `development` namespace. -->
此时，我们从命令行向 Kubernetes 集群发出的所有请求都限定在 development 命名空间中。
<!-- Let's create some contents. -->
<!--
At this point, all requests we make to the Kubernetes cluster from the command line are scoped to the `development` namespace.
-->
此时，我们从命令行向 Kubernetes 集群发出的所有请求都限定在 `development` 名字空间中。
<!--
Let's create some contents.
-->
让我们创建一些内容。
```shell
kubectl run snowflake --image=k8s.gcr.io/serve_hostname --replicas=2
```
<!-- We have just created a deployment whose replica size is 2 that is running the pod called `snowflake` with a basic container that just serves the hostname.
Note that `kubectl run` creates deployments only on Kubernetes cluster >= v1.2. If you are running older versions, it creates replication controllers instead.
If you want to obtain the old behavior, use `--generator=run/v1` to create replication controllers. See [`kubectl run`](/docs/reference/generated/kubectl/kubectl-commands/#run) for more details. -->
{{< codenew file="admin/snowflake-deployment.yaml" >}}
我们刚刚创建了一个副本大小为 2 的 deployment，该 deployment 运行名为 snowflake 的 pod，其中包含一个仅提供主机名服务的基本容器。请注意，`kubectl run` 仅在 Kubernetes 集群版本 >= v1.2 时创建 deployment。如果您运行在旧版本上，则会创建 replication controller。如果期望执行旧版本的行为，请使用 `--generator=run/v1` 创建 replication controller。 参见 [`kubectl run`](/docs/reference/generated/kubectl/kubectl-commands/#run) 获取更多细节。
<!--
Apply the manifest to create a Deployment
-->
应用清单文件来创建 Deployment。
<!--
We have just created a deployment whose replica size is 2 that is running the pod called `snowflake` with a basic container that just serves the hostname.
-->
我们刚刚创建了一个副本大小为 2 的 Deployment，该 Deployment 运行名为 `snowflake` 的 Pod，
其中包含一个仅提供主机名服务的基本容器。
```shell
kubectl get deployment
@@ -324,7 +359,7 @@ snowflake 2 2 2 2 2m
```
```shell
kubectl get pods -l run=snowflake
kubectl get pods -l app=snowflake
```
```
NAME READY STATUS RESTARTS AGE
@@ -332,41 +367,51 @@ snowflake-3968820950-9dgr8 1/1 Running 0 2m
snowflake-3968820950-vgc4n 1/1 Running 0 2m
```
<!-- And this is great, developers are able to do what they want, and they do not have to worry about affecting content in the `production` namespace. -->
<!--
And this is great, developers are able to do what they want, and they do not have to worry about affecting content in the `production` namespace.
-->
这很棒，开发人员可以做他们想要的事情，而不必担心影响 `production` 名字空间中的内容。
这很棒，开发人员可以做他们想要的事情，而不必担心影响 production 命名空间中的内容。
<!-- Let's switch to the `production` namespace and show how resources in one namespace are hidden from the other. -->
让我们切换到 production 命名空间，展示一个命名空间中的资源如何对另一个命名空间不可见。
<!--
Let's switch to the `production` namespace and show how resources in one namespace are hidden from the other.
-->
让我们切换到 `production` 名字空间，展示一个名字空间中的资源如何对另一个名字空间不可见。
```shell
kubectl config use-context prod
```
<!-- The `production` namespace should be empty, and the following commands should return nothing. -->
`production` 命名空间应该是空的，下列命令应该返回的内容为空。
<!--
The `production` namespace should be empty, and the following commands should return nothing.
-->
`production` 名字空间应该是空的，下列命令应该返回的内容为空。
```shell
kubectl get deployment
kubectl get pods
```
<!-- Production likes to run cattle, so let's create some cattle pods. -->
生产环境需要运行 cattle，让我们创建一些名为 cattle 的 pods。
<!--
Production likes to run cattle, so let's create some cattle pods.
-->
生产环境需要以放牛的方式运维，让我们创建一些名为 `cattle` 的 Pod。
```shell
kubectl run cattle --image=k8s.gcr.io/serve_hostname --replicas=5
kubectl create deployment cattle --image=k8s.gcr.io/serve_hostname
kubectl scale deployment cattle --replicas=5
kubectl get deployment
```
```
NAME DESIRED CURRENT UP-TO-DATE AVAILABLE AGE
cattle 5 5 5 5 10s
```
```shell
kubectl get pods -l run=cattle
```
```
NAME READY STATUS RESTARTS AGE
cattle-2263376956-41xy6 1/1 Running 0 34s
cattle-2263376956-kw466 1/1 Running 0 34s
@@ -375,13 +420,14 @@ cattle-2263376956-p5p3i 1/1 Running 0 34s
cattle-2263376956-sxpth 1/1 Running 0 34s
```
<!-- At this point, it should be clear that the resources users create in one namespace are hidden from the other namespace. -->
此时，应该很清楚的展示了用户在一个命名空间中创建的资源对另一个命名空间是不可见的。
<!-- As the policy support in Kubernetes evolves, we will extend this scenario to show how you can provide different
authorization rules for each namespace. -->
随着 Kubernetes 中的策略支持的发展，我们将扩展此场景，以展示如何为每个命名空间提供不同的授权规则。
<!--
At this point, it should be clear that the resources users create in one namespace are hidden from the other namespace.
-->
此时，应该很清楚的展示了用户在一个名字空间中创建的资源对另一个名字空间是不可见的。
<!--
As the policy support in Kubernetes evolves, we will extend this scenario to show how you can provide different
authorization rules for each namespace.
-->
随着 Kubernetes 中的策略支持的发展，我们将扩展此场景，以展示如何为每个名字空间提供不同的授权规则。