From f91917109f3e00d7e8ae03c9494cc7094fdd223c Mon Sep 17 00:00:00 2001 From: windsonsea Date: Thu, 11 Aug 2022 18:23:12 +0800 Subject: [PATCH] [zh-cn] Updated mysql-wordpress-persistent-volume.md --- .../mysql-wordpress-persistent-volume.md | 360 ++++++++---------- 1 file changed, 155 insertions(+), 205 deletions(-) diff --git a/content/zh-cn/docs/tutorials/stateful-application/mysql-wordpress-persistent-volume.md b/content/zh-cn/docs/tutorials/stateful-application/mysql-wordpress-persistent-volume.md index 6104c00410..b4de72f73d 100644 --- a/content/zh-cn/docs/tutorials/stateful-application/mysql-wordpress-persistent-volume.md +++ b/content/zh-cn/docs/tutorials/stateful-application/mysql-wordpress-persistent-volume.md @@ -1,5 +1,5 @@ --- -title: 示例：使用 Persistent Volumes 部署 WordPress 和 MySQL +title: 示例：使用持久卷部署 WordPress 和 MySQL content_type: tutorial weight: 20 card: @@ -27,29 +27,30 @@ This tutorial shows you how to deploy a WordPress site and a MySQL database usin 这两个应用都使用 PersistentVolumes 和 PersistentVolumeClaims 保存数据。 -[PersistentVolume](/zh-cn/docs/concepts/storage/persistent-volumes/)（PV）是一块集群里由管理员手动提供， -或 kubernetes 通过 [StorageClass](/zh-cn/docs/concepts/storage/storage-classes) 动态创建的存储。 +[PersistentVolume](/zh-cn/docs/concepts/storage/persistent-volumes/)（PV）是在集群里由管理员手动制备或 +Kubernetes 通过 [StorageClass](/zh-cn/docs/concepts/storage/storage-classes) 动态制备的一块存储。 [PersistentVolumeClaim](/zh-cn/docs/concepts/storage/persistent-volumes/#persistentvolumeclaims) 是用户对存储的请求，该请求可由某个 PV 来满足。 PersistentVolumes 和 PersistentVolumeClaims 独立于 Pod 生命周期而存在， -在 Pod 重启，重新调度甚至删除过程中保存数据。 +在 Pod 重启、重新调度甚至删除过程中用于保存数据。 {{< warning >}} -这种部署并不适合生产场景，它使用单实例 WordPress 和 MySQL Pods。 +This deployment is not suitable for production use cases, as it uses single instance WordPress and MySQL Pods. Consider using [WordPress Helm Chart](https://github.com/kubernetes/charts/tree/master/stable/wordpress) to deploy WordPress in production. +--> +这种部署并不适合生产场景，因为它使用的是单实例 WordPress 和 MySQL Pod。 在生产场景中，请考虑使用 [WordPress Helm Chart](https://github.com/kubernetes/charts/tree/master/stable/wordpress) 部署 WordPress。 {{< /warning >}} {{< note >}} -本教程中提供的文件使用 GA Deployment API，并且特定于 kubernetes 1.9 或更高版本。如果你希望将本教程与 Kubernetes 的早期版本一起使用，请相应地更新 API 版本，或参考本教程的早期版本。 +本教程中提供的文件使用 GA Deployment API，并且特定于 kubernetes 1.9 或更高版本。 +如果你希望将本教程与 Kubernetes 的早期版本一起使用，请相应地更新 API 版本，或参考本教程的早期版本。 {{< /note >}} ## {{% heading "objectives" %}} @@ -64,11 +65,11 @@ PersistentVolumes 和 PersistentVolumeClaims 独立于 Pod 生命周期而存在 * Clean up --> * 创建 PersistentVolumeClaims 和 PersistentVolumes -* 创建 `kustomization.yaml` 使用 +* 创建 `kustomization.yaml` 以使用 * Secret 生成器 * MySQL 资源配置 * WordPress 资源配置 -* 应用整个 kustomization 目录 `kubectl apply -k ./` +* `kubectl apply -k ./` 来应用整个 kustomization 目录 * 清理 ## {{% heading "prerequisites" %}} @@ -84,7 +85,7 @@ Download the following configuration files: 1. [wordpress-deployment.yaml](/examples/application/wordpress/wordpress-deployment.yaml) --> -此例在`kubectl` 1.14 或者更高版本有效。 +此例在 `kubectl` 1.14 或者更高版本有效。 下载下面的配置文件： @@ -98,28 +99,27 @@ Download the following configuration files: ## Create PersistentVolumeClaims and PersistentVolumes --> ## 创建 PersistentVolumeClaims 和 PersistentVolumes + - MySQL 和 Wordpress 都需要一个 PersistentVolume 来存储数据。 -他们的 PersistentVolumeClaims 将在部署步骤中创建。 +它们的 PersistentVolumeClaims 将在部署步骤中创建。 许多集群环境都安装了默认的 StorageClass。如果在 PersistentVolumeClaim 中未指定 StorageClass， 则使用集群的默认 StorageClass。 -创建 PersistentVolumeClaim 时，将根据 StorageClass 配置动态设置 PersistentVolume。 +创建 PersistentVolumeClaim 时，将根据 StorageClass 配置动态制备一个 PersistentVolume。 {{< warning >}} - -在本地集群中，默认的 StorageClass 使用`hostPath`供应器。 `hostPath`卷仅适用于开发和测试。 -使用 `hostPath` 卷，你的数据位于 Pod 调度到的节点上的`/tmp`中，并且不会在节点之间移动。 +在本地集群中，默认的 StorageClass 使用 `hostPath` 制备程序。`hostPath` 卷仅适用于开发和测试。 +使用 `hostPath` 卷时，你的数据位于 Pod 调度到的节点上的 `/tmp` 中，并且不会在节点之间移动。 如果 Pod 死亡并被调度到集群中的另一个节点，或者该节点重新启动，则数据将丢失。 {{< /warning >}} @@ -127,13 +127,14 @@ In local clusters, the default StorageClass uses the `hostPath` provisioner. `h -如果要建立需要使用`hostPath`设置程序的集群， -则必须在 controller-manager 组件中设置`--enable-hostpath-provisioner`标志。 +如果要建立需要使用 `hostPath` 制备程序的集群， +则必须在 `controller-manager` 组件中设置 `--enable-hostpath-provisioner` 标志。 {{< /note >}} {{< note >}} - - + 如果你已经有运行在 Google Kubernetes Engine 的集群， 请参考[此指南](https://cloud.google.com/kubernetes-engine/docs/tutorials/persistent-disk)。 {{< /note >}} @@ -153,12 +154,12 @@ A [Secret](/docs/concepts/configuration/secret/) is an object that stores a piec Add a Secret generator in `kustomization.yaml` from the following command. You will need to replace `YOUR_PASSWORD` with the password you want to use. --> -[Secret](/zh-cn/docs/concepts/configuration/secret/) 是存储诸如密码或密钥之类的敏感数据的对象。 -从 1.14 开始，`kubectl`支持使用 kustomization 文件管理 Kubernetes 对象。 -你可以通过`kustomization.yaml`中的生成器创建一个 Secret。 +[Secret](/zh-cn/docs/concepts/configuration/secret/) 是存储诸如密码或密钥之类敏感数据的对象。 +从 1.14 开始，`kubectl` 支持使用一个 kustomization 文件来管理 Kubernetes 对象。 +你可以通过 `kustomization.yaml` 中的生成器创建一个 Secret。 -通过以下命令在`kustomization.yaml`中添加一个 Secret 生成器。 -你需要用你要使用的密码替换`YOUR_PASSWORD`。 +通过以下命令在 `kustomization.yaml` 中添加一个 Secret 生成器。 +你需要将 `YOUR_PASSWORD` 替换为自己要用的密码。 ```shell cat <./kustomization.yaml @@ -177,8 +178,8 @@ EOF -以下 manifest 文件描述了单实例 MySQL 部署。MySQL 容器将 PersistentVolume 挂载在`/var/lib/mysql`。 -`MYSQL_ROOT_PASSWORD`环境变量设置来自 Secret 的数据库密码。 +以下清单文件描述的是一个单实例的 MySQL Deployment。MySQL 容器将 PersistentVolume 挂载在 `/var/lib/mysql`。 +`MYSQL_ROOT_PASSWORD` 环境变量根据 Secret 设置数据库密码。 {{< codenew file="application/wordpress/mysql-deployment.yaml" >}} @@ -188,47 +189,36 @@ PersistentVolume at `/var/www/html` for website data files. The `WORDPRESS_DB_HO the name of the MySQL Service defined above, and WordPress will access the database by Service. The `WORDPRESS_DB_PASSWORD` environment variable sets the database password from the Secret kustomize generated. --> -以下 manifest 文件描述了单实例 WordPress 部署。WordPress 容器将网站数据文件位于`/var/www/html`的 PersistentVolume。`WORDPRESS_DB_HOST`环境变量集上面定义的 MySQL Service 的名称，WordPress 将通过 Service 访问数据库。`WORDPRESS_DB_PASSWORD`环境变量设置从 Secret kustomize 生成的数据库密码。 +以下清单文件描述的是一个单实例 WordPress Deployment。WordPress 容器将 PersistentVolume +挂载到 `/var/www/html`，用于保存网站数据文件。 +`WORDPRESS_DB_HOST` 环境变量设置上面定义的 MySQL Service 的名称，WordPress 将通过 Service 访问数据库。 +`WORDPRESS_DB_PASSWORD` 环境变量根据使用 kustomize 生成的 Secret 设置数据库密码。 {{< codenew file="application/wordpress/wordpress-deployment.yaml" >}} -1. 下载 MySQL deployment 配置文件。 +1. 下载 MySQL Deployment 配置文件。 ```shell curl -LO https://k8s.io/examples/application/wordpress/mysql-deployment.yaml ``` + 2. 下载 WordPress 配置文件。 ```shell curl -LO https://k8s.io/examples/application/wordpress/wordpress-deployment.yaml ``` -3. 补充到 `kustomization.yaml` 文件。 + +3. 将上述内容追加到 `kustomization.yaml` 文件。 - ```shell + ``` cat <>./kustomization.yaml resources: - mysql-deployment.yaml @@ -243,219 +233,179 @@ the name of the MySQL Service defined above, and WordPress will access the datab +`kustomization.yaml` 包含用于部署 WordPress 网站以及 MySQL 数据库的所有资源。你可以通过以下方式应用目录： + ```shell kubectl apply -k ./ ``` + -`kustomization.yaml`包含用于部署 WordPress 网站的所有资源以及 MySQL 数据库。你可以通过以下方式应用目录 -```shell -kubectl apply -k ./ -``` - 现在，你可以验证所有对象是否存在。 1. 通过运行以下命令验证 Secret 是否存在： - ```shell - kubectl get secrets - ``` + ```shell + kubectl get secrets + ``` - 响应应如下所示： + - ```shell - NAME TYPE DATA AGE - mysql-pass-c57bb4t7mf Opaque 1 9s - ``` + 响应应如下所示： -2. 验证是否已动态配置 PersistentVolume： + ```shell + NAME TYPE DATA AGE + mysql-pass-c57bb4t7mf Opaque 1 9s + ``` - ```shell - kubectl get pvc - ``` + +2. 验证是否已动态制备 PersistentVolume： - {{< note >}} - 设置和绑定 PV 可能要花费几分钟。 - {{< /note >}} + ```shell + kubectl get pvc + ``` - 响应应如下所示： + {{< note >}} + - ```shell - NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS AGE - mysql-pv-claim Bound pvc-8cbd7b2e-4044-11e9-b2bb-42010a800002 20Gi RWO standard 77s - wp-pv-claim Bound pvc-8cd0df54-4044-11e9-b2bb-42010a800002 20Gi RWO standard 77s - ``` + 制备和绑定 PV 可能要花费几分钟。 + {{< /note >}} + + + 响应应如下所示： + + ```shell + NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS AGE + mysql-pv-claim Bound pvc-8cbd7b2e-4044-11e9-b2bb-42010a800002 20Gi RWO standard 77s + wp-pv-claim Bound pvc-8cd0df54-4044-11e9-b2bb-42010a800002 20Gi RWO standard 77s + ``` + + 3. 通过运行以下命令来验证 Pod 是否正在运行： - ```shell - kubectl get pods - ``` + ```shell + kubectl get pods + ``` - {{< note >}} - 等待 Pod 状态变成`RUNNING`可能会花费几分钟。 - {{< /note >}} + {{< note >}} + - 响应应如下所示： + 等待 Pod 状态变成 `RUNNING` 可能会花费几分钟。 + {{< /note >}} - ``` - NAME READY STATUS RESTARTS AGE - wordpress-mysql-1894417608-x5dzt 1/1 Running 0 40s - ``` + + 响应应如下所示： + + ``` + NAME READY STATUS RESTARTS AGE + wordpress-mysql-1894417608-x5dzt 1/1 Running 0 40s + ``` + + 4. 通过运行以下命令来验证 Service 是否正在运行： - ```shell - kubectl get services wordpress - ``` + ```shell + kubectl get services wordpress + ``` - 响应应如下所示： + - ``` - NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE - wordpress ClusterIP 10.0.0.89 80:32406/TCP 4m - ``` + 响应应如下所示： - {{< note >}} - Minikube 只能通过 NodePort 公开服务。EXTERNAL-IP 始终处于挂起状态 - {{< /note >}} + ``` + NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE + wordpress ClusterIP 10.0.0.89 80:32406/TCP 4m + ``` + {{< note >}} + + + Minikube 只能通过 NodePort 公开服务。EXTERNAL-IP 始终处于 pending 状态。 + {{< /note >}} + + 5. 运行以下命令以获取 WordPress 服务的 IP 地址： - ```shell - minikube service wordpress --url - ``` + ```shell + minikube service wordpress --url + ``` - 响应应如下所示： + + 响应应如下所示： - ``` - http://1.2.3.4:32406 - ``` + ``` + http://1.2.3.4:32406 + ``` + 6. 复制 IP 地址，然后将页面加载到浏览器中来查看你的站点。 - 你应该看到类似于以下屏幕截图的 WordPress 设置页面。 + 你应该看到类似于以下屏幕截图的 WordPress 设置页面。 - ![wordpress-init](https://raw.githubusercontent.com/kubernetes/examples/master/mysql-wordpress-pd/WordPress.png) + ![wordpress-init](https://raw.githubusercontent.com/kubernetes/examples/master/mysql-wordpress-pd/WordPress.png) {{< warning >}} 不要在此页面上保留 WordPress 安装。如果其他用户找到了它，他们可以在你的实例上建立一个网站并使用它来提供恶意内容。

通过创建用户名和密码来安装 WordPress 或删除你的实例。 - {{< /warning >}} ## {{% heading "cleanup" %}} +1. 运行以下命令删除你的 Secret、Deployment、Service 和 PersistentVolumeClaims： -1. 运行一下命令删除你的 Secret，Deployments，Services and PersistentVolumeClaims： - - ```shell - kubectl delete -k ./ - ``` + ```shell + kubectl delete -k ./ + ``` ## {{% heading "whatsnext" %}} * 进一步了解[自省与调试](/zh-cn/docs/tasks/debug/debug-application/debug-running-pod/) -* 进一步了解 [Job](/zh-cn/docs/concepts/workloads/controllers/jobs-run-to-completion/) +* 进一步了解 [Job](/zh-cn/docs/concepts/workloads/controllers/job/) * 进一步了解[端口转发](/zh-cn/docs/tasks/access-application-cluster/port-forward-access-application-cluster/) * 了解如何[获得容器的 Shell](/zh-cn/docs/tasks/debug/debug-application/get-shell-running-container/)