diff --git a/content/zh/docs/api-reference/api-docs.md b/content/zh/docs/api-reference/api-docs.md index c7976a5f4..e106df315 100644 --- a/content/zh/docs/api-reference/api-docs.md +++ b/content/zh/docs/api-reference/api-docs.md @@ -117,4 +117,4 @@ KubeSphere API Swagger JSON 文件可以在 https://github.com/kubesphere/kubesp - KubeSphere 已指定 API [Swagger Json](https://github.com/kubesphere/kubesphere/blob/release-3.0/api/ks-openapi-spec/swagger.json) 文件，它包含所有只适用于 KubeSphere 的 API。 - KubeSphere 已指定 CRD [Swagger Json](https://github.com/kubesphere/kubesphere/blob/release-3.0/api/openapi-spec/swagger.json) 文件，它包含所有已生成的 CRD API 文档，与 Kubernetes API 对象相同。 -你也可以[点击这里](https://kubesphere.io/api/kubesphere)查看 KubeSphere API 文档。 +您也可以[点击这里](https://kubesphere.io/api/kubesphere)查看 KubeSphere API 文档。 diff --git a/content/zh/docs/faq/observability/logging.md b/content/zh/docs/faq/observability/logging.md index 858e72c88..2c1329c9d 100644 --- a/content/zh/docs/faq/observability/logging.md +++ b/content/zh/docs/faq/observability/logging.md @@ -8,7 +8,7 @@ weight: 16310 ## 如何将日志存储改为外部弹性搜索并关闭内部弹性搜索 -如果您使用的是 KubeSphere 内部的 Elasticsearch，并且想把它改成您的外部备用，请按照下面的指南操作。否则，如果你还没有启用日志系统，请到[启用日志系统](.../.../logging/)直接设置外部 Elasticsearch。 +如果您使用的是 KubeSphere 内部的 Elasticsearch，并且想把它改成您的外部备用，请按照下面的指南操作。否则，如果您还没有启用日志系统，请到[启用日志系统](.../.../logging/)直接设置外部 Elasticsearch。 首先，更新 KubeKey 配置。 @@ -54,7 +54,7 @@ status: kubectl rollout restart deploy -n kubesphere-system ks-installer ``` -最后，要删除内部的 Elasticsearch，请运行以下命令。请确认你已经备份了内部 Elasticsearch 中的数据。 +最后，要删除内部的 Elasticsearch，请运行以下命令。请确认您已经备份了内部 Elasticsearch 中的数据。 ```shell helm uninstall -n kubesphere-logging-system elasticsearch-logging @@ -66,7 +66,7 @@ helm uninstall -n kubesphere-logging-system elasticsearch-logging ## 如何修改日志数据保留天数 -你需要更新 KubeKey 配置并重新运行 ks-installer。 +您需要更新 KubeKey 配置并重新运行 ks-installer。 ```shell kubectl edit cc -n kubesphere-system ks-installer @@ -106,7 +106,7 @@ kubectl rollout restart deploy -n kubesphere-system ks-installer ## 无法从工具箱中的某些节点上的工作负载中找出日志 -如果你采用[多节点安装](.../.../installing-on-linux/introduction/multioverview/)，并且使用符号链接作为 Docker 根目录，请确保所有节点遵循完全相同的符号链接。日志代理在 DaemonSet 中部署到节点上。容器日志路径的任何差异都可能导致该节点上的收集失败。 +如果您采用[多节点安装](.../.../installing-on-linux/introduction/multioverview/)，并且使用符号链接作为 Docker 根目录，请确保所有节点遵循完全相同的符号链接。日志代理在 DaemonSet 中部署到节点上。容器日志路径的任何差异都可能导致该节点上的收集失败。 要找出节点上的 Docker 根目录路径，可以运行以下命令。确保所有节点都适用相同的值。 diff --git a/content/zh/docs/faq/observability/monitoring.md b/content/zh/docs/faq/observability/monitoring.md index d5e4e3c15..28b2a96d3 100644 --- a/content/zh/docs/faq/observability/monitoring.md +++ b/content/zh/docs/faq/observability/monitoring.md @@ -16,7 +16,7 @@ kubectl edit svc -n kubesphere-monitoring-system prometheus-k8s ## Node Exporter 引起的主机端口 9100 冲突 -如果有进程占用主机端口 9100，`kubespher-monitoring-system` 下的 Node Exporter 会崩溃。为了解决冲突，你需要终止进程或将 Node Exporter 换到另一个可用端口。 +如果有进程占用主机端口 9100，`kubespher-monitoring-system` 下的 Node Exporter 会崩溃。为了解决冲突，您需要终止进程或将 Node Exporter 换到另一个可用端口。 要采用另一个主机端口，例如 `29100`，运行以下命令，将所有 `9100` 替换为 `29100`（需要更改 5 处）。 @@ -57,7 +57,7 @@ kubectl edit svc -n kubesphere-monitoring-system prometheus-k8s ## 与现有的 Prometheus Operator 相冲突 -如果你已经自行部署了 Prometheus Operator，请确保在安装 KubeSphere 之前将 Prometheus Operator 删除。否则，可能会出现 KubeSphere 内置的 Prometheus Operator 选择重复的 ServiceMonitor 对象的冲突。 +如果您已经自行部署了 Prometheus Operator，请确保在安装 KubeSphere 之前将 Prometheus Operator 删除。否则，可能会出现 KubeSphere 内置的 Prometheus Operator 选择重复的 ServiceMonitor 对象的冲突。 ## 如何修改监控数据保留天数 diff --git a/content/zh/docs/installing-on-linux/public-cloud/install-kubesphere-on-ali-ecs.md b/content/zh/docs/installing-on-linux/public-cloud/install-kubesphere-on-ali-ecs.md index 166774c22..70578a6f7 100644 --- a/content/zh/docs/installing-on-linux/public-cloud/install-kubesphere-on-ali-ecs.md +++ b/content/zh/docs/installing-on-linux/public-cloud/install-kubesphere-on-ali-ecs.md @@ -6,7 +6,7 @@ description: "本教程用于安装高可用性集群" Weight: 3240 --- -对于生产环境，我们需要考虑集群的高可用性。本文教你部署如何在多台阿里 ECS 实例快速部署一套高可用的生产环境。要满足 Kubernetes 集群服务需要做到高可用，需要保证 kube-apiserver 的 HA ，可使用以下下列两种方式： +对于生产环境，我们需要考虑集群的高可用性。本文教您部署如何在多台阿里 ECS 实例快速部署一套高可用的生产环境。要满足 Kubernetes 集群服务需要做到高可用，需要保证 kube-apiserver 的 HA ，可使用以下下列两种方式： - 阿里云 SLB （推荐） - keepalived + haproxy [keepalived + haproxy](https://kubesphere.com.cn/forum/d/1566-kubernetes-keepalived-haproxy)对 kube-apiserver 进行负载均衡，实现高可用 kubernetes 集群。 diff --git a/content/zh/docs/installing-on-linux/public-cloud/install-kubesphere-on-huaweicloud-ecs.md b/content/zh/docs/installing-on-linux/public-cloud/install-kubesphere-on-huaweicloud-ecs.md index a3c3ff3db..8aa9ee8d1 100644 --- a/content/zh/docs/installing-on-linux/public-cloud/install-kubesphere-on-huaweicloud-ecs.md +++ b/content/zh/docs/installing-on-linux/public-cloud/install-kubesphere-on-huaweicloud-ecs.md @@ -6,7 +6,7 @@ description: "本教程用于安装高可用性集群" Weight: 3230 --- -由于对于生产环境，我们需要考虑集群的高可用性。教你部署如何在华为云 ECS 实例服务快速部署一套高可用的生产环境 +由于对于生产环境，我们需要考虑集群的高可用性。教您部署如何在华为云 ECS 实例服务快速部署一套高可用的生产环境 Kubernetes 服务需要做到高可用，需要保证 kube-apiserver 的 HA ，推荐华为云负载均衡器服务. ## 前提条件 @@ -273,7 +273,7 @@ spec: 如本文开头的前提条件所说，对于生产环境，我们建议您准备持久性存储，可参考以下说明进行配置。若搭建开发和测试，您可以直接使用默认集成的 OpenEBS 准备 LocalPV，则可以跳过这小节。 {{< notice note >}} -如果你有已有存储服务端，例如华为云可使用 [弹性文件存储（SFS）](https://support.huaweicloud.com/productdesc-sfs/zh-cn_topic_0034428718.html) 来作为存储服务。继续编辑上述 `config-sample.yaml` 文件，找到 `[addons]` 字段，这里支持定义任何持久化存储的插件或客户端，如 CSI、NFS Client、Ceph、GlusterFS，您可以根据您自己的持久化存储服务类型，并参考 [持久化存储服务](https://kubesphere.com.cn/docs/installing-on-linux/introduction/storage-configuration/) 中对应的示例 yaml 文件进行设置。 +如果您有已有存储服务端，例如华为云可使用 [弹性文件存储（SFS）](https://support.huaweicloud.com/productdesc-sfs/zh-cn_topic_0034428718.html) 来作为存储服务。继续编辑上述 `config-sample.yaml` 文件，找到 `[addons]` 字段，这里支持定义任何持久化存储的插件或客户端，如 CSI、NFS Client、Ceph、GlusterFS，您可以根据您自己的持久化存储服务类型，并参考 [持久化存储服务](https://kubesphere.com.cn/docs/installing-on-linux/introduction/storage-configuration/) 中对应的示例 yaml 文件进行设置。 {{}} ### 执行命令创建集群 diff --git a/content/zh/docs/quick-start/deploy-bookinfo-to-k8s.md b/content/zh/docs/quick-start/deploy-bookinfo-to-k8s.md index 0c31c44bf..c7e2fa1a0 100644 --- a/content/zh/docs/quick-start/deploy-bookinfo-to-k8s.md +++ b/content/zh/docs/quick-start/deploy-bookinfo-to-k8s.md @@ -1,8 +1,8 @@ --- -title: "部署和访问 Bookinfo" +title: "部署并访问 Bookinfo" keywords: 'KubeSphere, Kubernetes, Bookinfo, Istio' description: '在 K8s 上部署 Bookinfo 并通过 NodePort 访问该应用' -linkTitle: "部署和访问 Bookinfo" +linkTitle: "部署并访问 Bookinfo" weight: 2400 --- @@ -51,7 +51,7 @@ Bookinfo 应用由以下四个独立的微服务组成，其中 **reviews** 微 {{< notice note >}} - KubeSphere 会自动创建主机名。若要更改主机名，请将鼠标悬停在默认路由规则上，然后点击铅笔图标进行编辑。有关更多信息，请参见[创建基于微服务的应用](../../project-user-guide/application/compose-app/)。 +KubeSphere 会自动创建主机名。若要更改主机名，请将鼠标悬停在默认路由规则上，然后点击铅笔图标进行编辑。有关更多信息，请参见[创建基于微服务的应用](../../project-user-guide/application/compose-app/)。 {{}} @@ -60,7 +60,7 @@ Bookinfo 应用由以下四个独立的微服务组成，其中 **reviews** 微 ![running](/images/docs/zh-cn/quickstart/deploy-bookinfo-to-k8s/running.png) {{< notice note >}} - 可能需要等几分钟才能看到部署正常运行。 +可能需要等几分钟才能看到部署正常运行。 {{}} ### 步骤 2：访问 Bookinfo @@ -82,13 +82,15 @@ Bookinfo 应用由以下四个独立的微服务组成，其中 **reviews** 微 4. 在本地 hosts 文件 (`/etc/hosts`) 中添加一个条目将主机名映射到对应的 IP 地址，例如： ```bash - 139.198.19.38 productpage.demo-project.192.168.0.2.nip.io + 139.198.19.38 productpage.demo-project.192.168.0.4.nip.io ``` -{{< notice warning >}} - 请勿直接复制上述内容到本地 hosts 文件，请将其替换成您自己的 IP 地址与主机名。 -{{}} + {{< notice warning >}} +请勿直接复制上述内容到本地 hosts 文件，请将其替换成您自己的 IP 地址与主机名。 +{{}} + + 5. 完成后，点击**点击访问**按钮访问该应用。 ![click-to-visit](/images/docs/zh-cn/quickstart/deploy-bookinfo-to-k8s/click-to-visit.png) @@ -101,7 +103,7 @@ Bookinfo 应用由以下四个独立的微服务组成，其中 **reviews** 微 ![ratings-page](/images/docs/zh-cn/quickstart/deploy-bookinfo-to-k8s/ratings-page.png) -{{< notice note >}} + {{< notice note >}} KubeSphere 基于 Istio 提供了三种灰度策略，包括[蓝绿部署](../../project-user-guide/grayscale-release/blue-green-deployment/)，[金丝雀发布](../../project-user-guide/grayscale-release/canary-release/)和[流量镜像](../../project-user-guide/grayscale-release/traffic-mirroring/)。 {{}} \ No newline at end of file diff --git a/content/zh/docs/quick-start/wordpress-deployment.md b/content/zh/docs/quick-start/wordpress-deployment.md index 710cf301d..e44c734c9 100644 --- a/content/zh/docs/quick-start/wordpress-deployment.md +++ b/content/zh/docs/quick-start/wordpress-deployment.md @@ -91,7 +91,7 @@ WordPress（使用 PHP 语言编写）是免费、开源的内容管理系统， ![add-container](/images/docs/zh-cn/quickstart/wordpress-deployment/add-container.png) {{< notice note >}} - 在**高级设置**中，请确保内存限制不小于 1000 Mi，否则 MySQL 可能因内存不足而无法启动。 +在**高级设置**中，请确保内存限制不小于 1000 Mi，否则 MySQL 可能因内存不足而无法启动。 {{}} 8. 向下滚动到**环境变量**，点击**引用配置文件或密匙**。输入名称 `MYSQL_ROOT_PASSWORD`，然后选择资源 `mysql-secret` 和前面步骤中创建的密钥 `MYSQL_ROOT_PASSWORD`，完成后点击 **√** 保存配置，最后点击**下一步**继续。 @@ -128,7 +128,7 @@ WordPress（使用 PHP 语言编写）是免费、开源的内容管理系统， - 点击**添加环境变量**，分别输入 `WORDPRESS_DB_HOST` 和 `mysql` 作为键 (Key) 和值 (Value)。 {{< notice warning >}} - 对于此处添加的第二个环境变量，该值必须与步骤 5 中创建 MySQL 有状态服务设置的名称完全相同。否则，WordPress 将无法连接到 MySQL 对应的数据库。 +对于此处添加的第二个环境变量，该值必须与步骤 5 中创建 MySQL 有状态服务设置的名称完全相同。否则，WordPress 将无法连接到 MySQL 对应的数据库。 {{}} ![environment-varss](/images/docs/zh-cn/quickstart/wordpress-deployment/environment-varss.png)