Switch language name 'zh' to 'zh-cn'

This is the first step to rename 'zh' to 'zh-cn'. There are several reasons why we rename the language name. - The upstream docsy theme changed the language name, leading to many warnings during site build; The side-effect is that the i18n strings are no longer working. - We believe renaming the language is the right thing to do, because this move can make room for other variants of Chinese language, such as 'zh-tw', 'zh-sg' etc. There would be several follow-ups to this PR, such as fixing the intra-site links, adding redirects etc. We will lock up changes to zh/zh-cn pages for the moment, until this one gets in. This PR is based on commit cdad0a7342.
2022-06-10 20:25:27 +08:00
parent 3d345b1816
commit c52818c03d
1347 changed files with 8 additions and 6 deletions
@@ -0,0 +1,444 @@
+---
+title: "示例：使用 StatefulSet 部署 Cassandra"
+content_type: tutorial
+weight: 30
+---
+
+<!--
+title: "Example: Deploying Cassandra with a StatefulSet"
+reviewers:
+- ahmetb
+content_type: tutorial
+weight: 30
+-->
+
+<!-- overview -->
+<!--
+This tutorial shows you how to run [Apache Cassandra](https://cassandra.apache.org/) on Kubernetes.
+Cassandra, a database, needs persistent storage to provide data durability (application _state_).
+In this example, a custom Cassandra seed provider lets the database discover new Cassandra instances as they join the Cassandra cluster.
+-->
+本教程描述拉如何在 Kubernetes 上运行 [Apache Cassandra](https://cassandra.apache.org/)。
+数据库 Cassandra 需要永久性存储提供数据持久性（应用“状态”）。
+在此示例中，自定义 Cassandra seed provider 使数据库在加入 Cassandra
+集群时发现新的 Cassandra 实例。
+
+<!--
+*StatefulSets* make it easier to deploy stateful applications into your Kubernetes cluster.
+For more information on the features used in this tutorial, see
+[StatefulSet](/docs/concepts/workloads/controllers/statefulset/).
+-->
+使用"StatefulSets"可以更轻松地将有状态的应用程序部署到你的 Kubernetes 集群中。
+有关本教程中使用的功能的更多信息，
+参阅 [StatefulSet](/zh/docs/concepts/workloads/controllers/statefulset/)。
+
+{{< note >}}
+<!--
+Cassandra and Kubernetes both use the term _node_ to mean a member of a cluster. In this
+tutorial, the Pods that belong to the StatefulSet are Cassandra nodes and are members
+of the Cassandra cluster (called a _ring_). When those Pods run in your Kubernetes cluster,
+the Kubernetes control plane schedules those Pods onto Kubernetes
+{{< glossary_tooltip text="Nodes" term_id="node" >}}.
+-->
+Cassandra 和 Kubernetes 都使用术语“节点（node）”来表示集群的成员。
+在本教程中，属于 StatefulSet 的 Pod 是 Cassandra 节点，并且是 Cassandra 集群的成员（称为 “ring”）。
+当这些 Pod 在你的 Kubernetes 集群中运行时，Kubernetes 控制平面会将这些 Pod 调度到 Kubernetes 的
+{{< glossary_tooltip text="节点" term_id="node" >}}上。
+
+<!--
+When a Cassandra node starts, it uses a _seed list_ to bootstrap discovery of other
+nodes in the ring.
+This tutorial deploys a custom Cassandra seed provider that lets the database discover
+new Cassandra Pods as they appear inside your Kubernetes cluster.
+-->
+当 Cassandra 节点启动时，使用 _seed列表_ 来引导发现 ring 中其他节点。
+本教程部署了一个自定义的 Cassandra seed provider，使数据库可以发现新的 Cassandra Pod
+出现在 Kubernetes 集群中。
+{{< /note >}}
+
+## {{% heading "objectives" %}}
+
+<!--
+* Create and validate a Cassandra headless {{< glossary_tooltip text="Service" term_id="service" >}}.
+* Use a {{< glossary_tooltip term_id="StatefulSet" >}} to create a Cassandra ring.
+* Validate the StatefulSet.
+* Modify the StatefulSet.
+* Delete the StatefulSet and its {{< glossary_tooltip text="Pods" term_id="pod" >}}.
+-->
+* 创建并验证 Cassandra 无头（headless）{{< glossary_tooltip text="Service" term_id="service" >}}..
+* 使用 {{< glossary_tooltip term_id="StatefulSet" >}} 创建一个 Cassandra ring。
+* 验证 StatefulSet。
+* 修改 StatefulSet。
+* 删除 StatefulSet 及其 {{< glossary_tooltip text="Pod" term_id="pod" >}}.
+
+## {{% heading "prerequisites" %}}
+
+{{< include "task-tutorial-prereqs.md" >}}
+
+<!--
+To complete this tutorial, you should already have a basic familiarity with
+{{< glossary_tooltip text="Pods" term_id="pod" >}},
+{{< glossary_tooltip text="Services" term_id="service" >}}, and
+{{< glossary_tooltip text="StatefulSets" term_id="StatefulSet" >}}.
+-->
+要完成本教程，你应该已经熟悉 {{< glossary_tooltip text="Pod" term_id="pod" >}}，
+{{< glossary_tooltip text="Service" term_id="service" >}} 和
+{{< glossary_tooltip text="StatefulSet" term_id="StatefulSet" >}}。
+
+<!--
+### Additional Minikube setup instructions
+
+{{< caution >}}
+[Minikube](https://minikube.sigs.k8s.io/docs/) defaults to 2048MB of memory and 2 CPU.
+Running Minikube with the default resource configuration results in insufficient resource
+errors during this tutorial. To avoid these errors, start Minikube with the following settings:
+-->
+### 额外的 Minikube 设置说明
+
+{{< caution >}}
+[Minikube](https://minikube.sigs.k8s.io/docs/)默认为 2048MB 内存和 2 个 CPU。
+在本教程中，使用默认资源配置运行 Minikube 会导致资源不足的错误。为避免这些错误，请使用以下设置启动 Minikube：
+
+```shell
+minikube start --memory 5120 --cpus=4
+```
+{{< /caution >}}
+
+
+<!-- lessoncontent -->
+<!--
+## Creating a headless Service for Cassandra {#creating-a-cassandra-headless-service}
+
+In Kubernetes, a {{< glossary_tooltip text="Service" term_id="service" >}} describes a set of
+{{< glossary_tooltip text="Pods" term_id="pod" >}} that perform the same task.
+
+The following Service is used for DNS lookups between Cassandra Pods and clients within your cluster:
+
+Create a Service to track all Cassandra StatefulSet members from the `cassandra-service.yaml` file:
+-->
+## 为 Cassandra 创建无头（headless） Services {#creating-a-cassandra-headless-service}
+
+在 Kubernetes 中，一个 {{< glossary_tooltip text="Service" term_id="service" >}}
+描述了一组执行相同任务的 {{< glossary_tooltip text="Pod" term_id="pod" >}}。
+
+以下 Service 用于在 Cassandra Pod 和集群中的客户端之间进行 DNS 查找：
+
+{{< codenew file="application/cassandra/cassandra-service.yaml" >}}
+
+创建一个 Service 来跟踪 `cassandra-service.yaml` 文件中的所有 Cassandra StatefulSet：
+
+```shell
+kubectl apply -f https://k8s.io/examples/application/cassandra/cassandra-service.yaml
+```
+
+<!--
+### Validating (optional) {#validating}
+
+Get the Cassandra Service.
+-->
+### 验证(可选) {#validating}
+
+获取 Cassandra Service。
+
+```shell
+kubectl get svc cassandra
+```
+
+<!-- 
+The response is 
+-->
+响应是：
+
+```
+NAME        TYPE        CLUSTER-IP   EXTERNAL-IP   PORT(S)    AGE
+cassandra   ClusterIP   None         <none>        9042/TCP   45s
+```
+
+<!--
+If you don't see a Service named `cassandra`, that means creation failed. Read
+[Debug Services](/docs/tasks/debug/debug-application/debug-service/)
+for help troubleshooting common issues.
+-->
+如果没有看到名为 `cassandra` 的服务，则表示创建失败。
+请阅读[调试服务](/zh/docs/tasks/debug/debug-application/debug-service/)，以解决常见问题。
+
+<!--
+## Using a StatefulSet to create a Cassandra ring
+
+The StatefulSet manifest, included below, creates a Cassandra ring that consists of three Pods.
+
+{{< note >}}
+This example uses the default provisioner for Minikube.
+Please update the following StatefulSet for the cloud you are working with.
+{{< /note >}}
+-->
+## 使用 StatefulSet 创建 Cassandra Ring
+
+下面包含的 StatefulSet 清单创建了一个由三个 Pod 组成的 Cassandra ring。
+
+{{< note >}}
+本示例使用 Minikube 的默认配置程序。
+请为正在使用的云更新以下 StatefulSet。
+{{< /note >}}
+
+{{< codenew file="application/cassandra/cassandra-statefulset.yaml" >}}
+
+<!--
+Create the Cassandra StatefulSet from the `cassandra-statefulset.yaml` file:
+-->
+使用 `cassandra-statefulset.yaml` 文件创建 Cassandra StatefulSet ：
+
+```shell
+# 如果你能未经修改地 apply cassandra-statefulset.yaml，请使用此命令
+kubectl apply -f https://k8s.io/examples/application/cassandra/cassandra-statefulset.yaml
+```
+
+<!--
+If you need to modify `cassandra-statefulset.yaml` to suit your cluster, download
+https://k8s.io/examples/application/cassandra/cassandra-statefulset.yaml and then apply
+that manifest, from the folder you saved the modified version into:
+-->
+如果你为了适合你的集群需要修改 `cassandra-statefulset.yaml`，
+下载 https://k8s.io/examples/application/cassandra/cassandra-statefulset.yaml，
+然后 apply 修改后的清单。
+
+```shell
+# 如果使用本地的 cassandra-statefulset.yaml ，请使用此命令
+kubectl apply -f cassandra-statefulset.yaml
+```
+
+<!--
+## Validating the Cassandra StatefulSet
+
+1. Get the Cassandra StatefulSet:
+-->
+## 验证 Cassandra StatefulSet
+
+1. 获取 Cassandra StatefulSet:
+
+   ```shell
+   kubectl get statefulset cassandra
+   ```
+   
+   <!--
+   The response should be similar to:
+   -->
+   响应应该与此类似：
+
+   ```
+   NAME        DESIRED   CURRENT   AGE
+   cassandra   3         0         13s
+   ```
+
+   <!--
+   The `StatefulSet` resource deploys Pods sequentially.
+   -->
+   `StatefulSet` 资源会按顺序部署 Pod。
+
+<!--
+1. Get the Pods to see the ordered creation status:
+-->
+2. 获取 Pod 查看已排序的创建状态：
+   
+   ```shell
+   kubectl get pods -l="app=cassandra"
+   ```
+
+   <!--
+   The response should be similar to:
+   -->
+   响应应该与此类似：
+
+   ```
+   NAME          READY     STATUS              RESTARTS   AGE
+   cassandra-0   1/1       Running             0          1m
+   cassandra-1   0/1       ContainerCreating   0          8s
+   ```
+
+   <!--
+   It can take several minutes for all three Pods to deploy. Once they are deployed, the same command
+   returns output similar to:
+   -->
+   这三个 Pod 要花几分钟的时间才能部署。部署之后，相同的命令将返回类似于以下的输出：
+
+   ```
+   NAME          READY     STATUS    RESTARTS   AGE
+   cassandra-0   1/1       Running   0          10m
+   cassandra-1   1/1       Running   0          9m
+   cassandra-2   1/1       Running   0          8m
+   ```
+<!--
+3. Run the Cassandra [nodetool](https://cwiki.apache.org/confluence/display/CASSANDRA2/NodeTool) inside the first Pod, to
+   display the status of the ring.
+-->
+3. 运行第一个 Pod 中的 Cassandra [nodetool](https://cwiki.apache.org/confluence/display/CASSANDRA2/NodeTool)，
+   以显示 ring 的状态。
+
+   ```shell
+   kubectl exec -it cassandra-0 -- nodetool status
+   ```
+
+   <!--
+   The response should be similar to:
+   -->
+   响应应该与此类似：
+
+   ```
+   Datacenter: DC1-K8Demo
+   ======================
+   Status=Up/Down
+   |/ State=Normal/Leaving/Joining/Moving
+   --  Address     Load       Tokens       Owns (effective)  Host ID                               Rack
+   UN  172.17.0.5  83.57 KiB  32           74.0%             e2dd09e6-d9d3-477e-96c5-45094c08db0f  Rack1-K8Demo
+   UN  172.17.0.4  101.04 KiB  32           58.8%             f89d6835-3a42-4419-92b3-0e62cae1479c  Rack1-K8Demo
+   UN  172.17.0.6  84.74 KiB  32           67.1%             a6a1e8c2-3dc5-4417-b1a0-26507af2aaad  Rack1-K8Demo
+   ```
+
+<!--
+## Modifying the Cassandra StatefulSet
+
+Use `kubectl edit` to modify the size of a Cassandra StatefulSet.
+
+1. Run the following command:
+-->
+## 修改 Cassandra StatefulSet
+
+使用 `kubectl edit` 修改 Cassandra StatefulSet 的大小。
+
+1. 运行以下命令：
+
+   ```shell
+   kubectl edit statefulset cassandra
+   ```
+
+   <!--
+   This command opens an editor in your terminal. The line you need to change is the `replicas` field.
+   The following sample is an excerpt of the StatefulSet file:
+   -->
+   此命令你的终端中打开一个编辑器。需要更改的是 `replicas` 字段。下面是 StatefulSet 文件的片段示例：
+
+    ```yaml
+    # Please edit the object below. Lines beginning with a '#' will be ignored,
+    # and an empty file will abort the edit. If an error occurs while saving this file will be
+    # reopened with the relevant failures.
+    #
+    apiVersion: apps/v1
+    kind: StatefulSet
+    metadata:
+      creationTimestamp: 2016-08-13T18:40:58Z
+      generation: 1
+      labels:
+      app: cassandra
+      name: cassandra
+      namespace: default
+      resourceVersion: "323"
+      uid: 7a219483-6185-11e6-a910-42010a8a0fc0
+    spec:
+      replicas: 3
+    ```
+
+<!--
+1. Change the number of replicas to 4, and then save the manifest.
+
+   The StatefulSet now scales to run with 4 Pods.
+
+1. Get the Cassandra StatefulSet to verify your change:
+-->
+2. 将副本数（replicas）更改为 4，然后保存清单。
+
+   StatefulSet 现在可以扩展到运行 4 个 Pod。
+
+3. 获取 Cassandra StatefulSet 验证更改：
+
+   ```shell
+   kubectl get statefulset cassandra
+   ```
+
+   <!--
+   The response should be similar to:
+   -->
+   响应应该与此类似：
+
+   ```
+   NAME        DESIRED   CURRENT   AGE
+   cassandra   4         4         36m
+   ```
+
+## {{% heading "cleanup" %}}
+
+<!--
+Deleting or scaling a StatefulSet down does not delete the volumes associated with the StatefulSet.
+This setting is for your safety because your data is more valuable than automatically purging all related StatefulSet resources.
+-->
+删除或缩小 StatefulSet 不会删除与 StatefulSet 关联的卷。
+这个设置是出于安全考虑，因为你的数据比自动清除所有相关的 StatefulSet 资源更有价值。
+
+{{< warning >}}
+<!--
+Depending on the storage class and reclaim policy, deleting the *PersistentVolumeClaims* may cause the associated volumes
+to also be deleted. Never assume you'll be able to access data if its volume claims are deleted.
+-->
+根据存储类和回收策略，删除 *PersistentVolumeClaims* 可能导致关联的卷也被删除。
+千万不要认为其容量声明被删除，你就能访问数据。
+{{< /warning >}}
+
+<!--
+1. Run the following commands (chained together into a single command) to delete everything in the Cassandra StatefulSet:
+-->
+1. 运行以下命令（连在一起成为一个单独的命令）删除 Cassandra StatefulSet 中的所有内容：
+
+   ```shell
+   grace=$(kubectl get pod cassandra-0 -o=jsonpath='{.spec.terminationGracePeriodSeconds}') \
+     && kubectl delete statefulset -l app=cassandra \
+     && echo "Sleeping ${grace} seconds" 1>&2 \
+     && sleep $grace \
+     && kubectl delete persistentvolumeclaim -l app=cassandra
+   ```
+
+<!--
+1. Run the following command to delete the Service you set up for Cassandra:
+-->
+2. 运行以下命令，删除你为 Cassandra 设置的 Service：
+
+   ```shell
+   kubectl delete service -l app=cassandra
+   ```
+
+<!--
+## Cassandra container environment variables
+
+The Pods in this tutorial use the [`gcr.io/google-samples/cassandra:v13`](https://github.com/kubernetes/examples/blob/master/cassandra/image/Dockerfile)
+image from Google's [container registry](https://cloud.google.com/container-registry/docs/).
+The Docker image above is based on [debian-base](https://github.com/kubernetes/release/tree/master/images/build/debian-base)
+and includes OpenJDK 8.
+
+This image includes a standard Cassandra installation from the Apache Debian repo.
+By using environment variables you can change values that are inserted into `cassandra.yaml`.
+-->
+## Cassandra 容器环境变量
+
+本教程中的 Pod 使用来自 Google [容器镜像库](https://cloud.google.com/container-registry/docs/)
+的 [`gcr.io/google-samples/cassandra:v13`](https://github.com/kubernetes/examples/blob/master/cassandra/image/Dockerfile)
+镜像。上面的 Docker 镜像基于 [debian-base](https://github.com/kubernetes/release/tree/master/images/build/debian-base)，
+并且包含 OpenJDK 8。
+
+该映像包括来自 Apache Debian 存储库的标准 Cassandra 安装。
+通过使用环境变量，你可以更改插入到 `cassandra.yaml` 中的值。
+
+| 环境变量                 | 默认值           |
+| ------------------------ |:---------------: |
+| `CASSANDRA_CLUSTER_NAME` | `'Test Cluster'` |
+| `CASSANDRA_NUM_TOKENS`   | `32`             |
+| `CASSANDRA_RPC_ADDRESS`  | `0.0.0.0`        |
+
+## {{% heading "whatsnext" %}}
+
+<!--
+* Learn how to [Scale a StatefulSet](/docs/tasks/run-application/scale-stateful-set/).
+* Learn more about the [*KubernetesSeedProvider*](https://github.com/kubernetes/examples/blob/master/cassandra/java/src/main/java/io/k8s/cassandra/KubernetesSeedProvider.java)
+* See more custom [Seed Provider Configurations](https://git.k8s.io/examples/cassandra/java/README.md)
+-->
+* 了解如何[扩缩 StatefulSet](/docs/tasks/run-application/scale-stateful-set/)。
+* 了解有关 [*KubernetesSeedProvider*](https://github.com/kubernetes/examples/blob/master/cassandra/java/src/main/java/io/k8s/cassandra/KubernetesSeedProvider.java) 的更多信息
+* 查看更多自定义 [Seed Provider Configurations](https://git.k8s.io/examples/cassandra/java/README.md)
+