kubesphere-retired / docs.kubesphere.io Goto Github PK

示例十二，地址：https://kubesphere.io/docs/v2.1/zh-CN/quick-start/ingress-canary/

开头给出的步骤看的不明所以，需要完善一下，比如：

1. 先用project-admin用户登陆创建ingress-demo项目，因为production.yaml文件需要
2. 然后使用admin用户登陆，在KubeSphere 右下角的工具箱打开 web kubectl 继续进行如下的操作。。

第二处需要完善的。
2.3. 如下访问 Production 版本的应用。
$ curl --resolve kubesphere.io:30205:192.168.0.88 kubesphere.io:30205
这个命令需要详细解释一下
首先这个命令是在宿主机中执行的，不是在web kubectl 中执行的
其次30202是高级设置，外网访问，NodePort中的http端口号，根据实际情况而定，或者在应用负载，应用路由中，点开production，规则显示的那个
最后，192.168.0.88是宿主机的ip地址，根据实际情况而定

第三处需要完善的
4.2. 访问应用的域名。
按照图中给的命令在宿主机中进行操作，返回结果为空，此时可以参考2.3. 如下访问 Production 版本的应用 中的命令，这里面正好有个Hostname参数，命令中的参数根据实际情况而定。
我这边的示例操作如下：

[root@ks-allinone ~]# for i in $(seq 1 10);do curl --resolve kubesphere.io:31291:192.168.75.100 kubesphere.io:31291 | grep "Hostname";done
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   728    0   728    0     0  39698      0 --:--:-- --:--:-- --:--:-- 40444
Hostname: canary-7946d7969c-c7szt
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   728    0   728    0     0   373k      0 --:--:-- --:--:-- --:--:--  710k
Hostname: canary-7946d7969c-c7szt
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   736    0   736    0     0   154k      0 --:--:-- --:--:-- --:--:--  179k
Hostname: production-7b887bf96c-42m7d
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   736    0   736    0     0  46170      0 --:--:-- --:--:-- --:--:-- 49066
Hostname: production-7b887bf96c-42m7d
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   736    0   736    0     0   120k      0 --:--:-- --:--:-- --:--:--  359k
Hostname: production-7b887bf96c-42m7d
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   736    0   736    0     0   333k      0 --:--:-- --:--:-- --:--:--  718k
Hostname: production-7b887bf96c-42m7d
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   736    0   736    0     0   277k      0 --:--:-- --:--:-- --:--:--  359k
Hostname: production-7b887bf96c-42m7d
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   736    0   736    0     0   201k      0 --:--:-- --:--:-- --:--:--  239k
Hostname: production-7b887bf96c-42m7d
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   736    0   736    0     0   354k      0 --:--:-- --:--:-- --:--:--  718k
Hostname: production-7b887bf96c-42m7d
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   728    0   728    0     0   102k      0 --:--:-- --:--:-- --:--:--  118k
Hostname: canary-7946d7969c-c7szt

虽繁返回的结果有点多，不过想要的结果已经能能实现了。但是有个其他问题，就是30%的流量切换有很大的概率上下浮动。。。。。

另外，基于Request Header的，新加主解nginx.ingress.kubernetes.io/canary-by-header：never还是有流量进来

总之这个灰度发布，流量切分，没有达到想要的效果，不该进来的流量进来了，该进来的流量没有进来完

https://docs.kubesphere.io/express/zh-CN/manage-imageregistries/

• 创建 Harbor 镜像仓库

pls add more content to tell users what to do if no daemon.json existed:
user should create daemon.json manually and add configuration like below:
{
"insecure-registries": ["ip-addr:port"]
}

@leoendless
The 2nd-level filter always guide users to blank page in website, the filter design is not smart, could you please help to optimize the filter, or remove the 2nd-level filter directly.

https://kubesphere.com.cn/zh-CN/videos/

示例十三，地址：https://kubesphere.io/docs/v2.1/zh-CN/quick-start/b2i-war/
创建服务，将它的 WAR 包（b2i-war-java8） b2i-war-java8.war 上传到 KubeSphere。

但是给出的链接地址是b2i-war-java11.war的下载地址，不匹配。。。

4.3、FAELED - RETRYING: KubeSphere Waiting for ks-console (30 retries left)一直卡在这里。

答： 检查cpu和内存，目前单机版部署至少8核16G 当free -m时buff/cache占用内存资源多，执行echo 3 > /proc/sys/vm/drop_caches指令释放下内存

这个配置跟 2.1 的推荐配置不符合，需要修正。

When PR has been merged, the updates can be reflected on KubeSphere Docs.

• https://kubesphere.com.cn/docs/v2.1/en/installation/all-in-one/ has a broken link to FAQ of installation.

2、填写应用仓库的详细信息，如下添加一个 http 协议的示例仓库：http://docs-repo.gd2.qingstor.com，完成后点击 确定。

这里换成 https 就能验证通过了。

• The HA architecture at https://kubesphere.com.cn/docs/v2.1/en/installation/master-ha/

• https://kubesphere.com.cn/docs/v2.1/en/installation/port-firewall/ has a Chinese screenshot.

监控技术选型
第一条 “Prometheus 和 Kubenetes 天然集成...”
Kubernetes 拼写错误

• https://kubesphere.io/docs/v2.1/en/api-reference/api-guide/

2.3. 下一步，设置标签为 app: wordpress-pvc，点击创建。>>> 2.3. 点击 下一步，设置标签为 app: wordpress-pvc，点击创建。

2.4. 查看存储卷列表，可以看到存储卷 wordpress-pvc 已经创建成功 >>> 2.4. 点击左侧菜单中的 存储卷 ，查看存储卷列表，可以看到存储卷 wordpress-pvc 已经创建成功

7.3. 点击左侧菜单中的 工作负载->存储卷，查看创建的部署 Wordpress，可以看到其状态显示运行中 >>> 7.3. 查看创建的部署 Wordpress，可以看到其状态显示运行中

9.3 例如，集群的公网 IP 地址为 139.198.16.160 …… 这里建议增加一个说明，让学员知道去哪里查这个集群的公网 IP 地址。如先展示 kubesphere 安装成功后的截图，里面包含了集群 IP 地址，然后在配合上 vpc 绑定的公网 IP ，以及将此公网 IP 做地址转发时的截图。

9.4. Annotation 是用户定义的 “附加” 信息，本示例暂不设置注解，点击 下一步 进入标签设置。为方便识别此应用，我们标签设置如下。点击 创建，即可创建成功。

这里建议分成两个步骤，更加清晰。例如：
9.4. Annotation 是用户定义的 “附加” 信息，本示例暂不设置注解，点击 下一步 进入标签设置。
9.5 标签设置。为方便识别此应用，我们标签设置如下，点击 创建。

10.2 LoadBalancer：如果用 LoadBalancer 的方式暴露服务，需要有云服务厂商的 LoadBalancer 插件支持，比如 QingCloud KubeSphere 托管服务 可以将公网 IP 地址的 ID 填入 Annotation 中，即可通过公网 IP 访问该服务。(如果外网访问方式设置的是 LoadBalancer，参见 应用路由 的 LoadBalancer 方式。)
上述内容其实属于备注说明，建议采用统一风格，前面加绿色竖线，标注这段话。避免它干扰目前的NodePort 选项

10.3 注意：可能需要进行端口转发和防火墙放行对应的端口，保证外网流量能够通过需要访问的端口如 30517，否则外网无法访问。
这里建议提供 端口转发和防火墙放行截图，以避免学员设置错误，例如将 30517 转发给 80 端口。也更容易让学员知道地址转发到内网的哪个 node 节点上。

If KubeSphere instances are not startup with OS, pls Add doc about how to restart kubesphere

在产品介绍-产品功能文章中，最后的那个多网络方案支持这一段，多打了三个字“适用于”

https://docs.kubesphere.io/advanced-v1.0.0/zh-CN/installation/all-in-one/

broken link on local volume, 存储配置说明.

also missing the doc about nfs server parameter in vars.yml

用admin用户登陆后平台管理和应用模板界面不显示，这个要怎么处理？谢谢

10 秒过去了，这个记录还在那里

在推荐配置里列出的磁盘容量
磁盘：500 G
没有明确说明这个是 OS 系统盘的容量，还是数据磁盘的容量，QingCloud 云平台上最大的 OS 盘容量为 100G，这里易引起歧义，建议分别对系统盘和数据盘提供推荐配置。

• The first two links are missing at https://kubesphere.com.cn/docs/v2.1/en/installation/install-logging/

https://kubesphere.com.cn/docs/v2.1/zh-CN/quick-start/one-click-deploy/

导入应用仓库
创建一个企业空间（Workspace），然后在该企业空间，进入 企业空间管理 → 应用仓库，点击 创建应用仓库。

这里没有与前面示例保持一致，没有执行人，需要补充。例如，使用 ws-admin 账号登录KS，进入已有企业空间，进入 企业空间管理 → 应用仓库，点击 创建应用仓库。

• https://kubesphere.com.cn/docs/v2.1/en/installation/install-on-k8s-airgapped/ says a script can do all things for you. The script looks like downloading images one by one and pushing them to a registry. The doc also says two ways to download images. After download, then says pushing the images to registry using the SAME script. It is kind of confusing.

第一步：创建密钥
1.2. 填写密钥的基本信息。
描述信息：简单介绍该密钥，如 MySQL 初始密码。
建议增加步骤『点击 “下一步”』

第三步：填写基本信息
描述信息：简单介绍该工作负载，方便用户进一步了解
建议增加步骤『点击 “下一步”』

第六步：服务配置
建议在开始前增加步骤『添加存储卷模板完成后点击 下一步』
建议在描述文字“参考以下截图完成参数设置”后增加步骤『点击 下一步』

3、添加完成后，可以在 应用模板 中查看新添加仓库的应用，点击应用名称为 nginx 的应用，准备部署该应用。

建议添加如下提示性截图，便于快速找到应用模板位置。

There is no result return when search in the .io site.

Expected result

It works normally, and only return the result in English.

Use Cloudflare to add CDN for .io

"Edit this page" button is covered by the title, pls help to change the position of this button.

Need add two docs as follows:

1. HA installation on AWS
2. Install KubeSphere on EKS

• There are two Chinese Screenshots in https://kubesphere.com.cn/docs/v2.1/en/installation/ldap-ad/

9.3 Paths：应用规则的路径和对应的后端服务，路径填写 "/"，服务选择之前创建的服务 wordpress-service，端口填写 wordpress 服务端口 80 >>>

9.3 Paths：应用规则的路径和对应的后端服务，路径填写 "/"，服务选择之前创建的服务 wordpress-service，端口填写 wordpress-service 服务端口 80

这里用 wordpress-service 替换原文的 wordpress 更准确，避免歧义，即作为 service 的 wordpress ，还是作为 deployment 的 wordpress .

We need to set .io for English only and .com.cn for Chinese only, which means it's not allowed com.cn/en or .io/zh-CN.

4.22、ubuntu系统，非root用户安装时，在kubernetes-apps/network_plugin/calico: start calico resources get http://localhost:8080/api?timeout=32s: dial tcp 127.0.0.1: 8080: connect: connection refused

答：采用root用户安装脚本。 4.23、FAILED - RETRYING: container_download | Download containers if pull is required or told to always pull (all nodes) (4 retries left)

可见，4.23 需要换行。

• Any screenshots related to role should be updated since the word "Authority Settings" is changed to "Authorization Settings". This one is low priority

• https://kubesphere.com.cn/docs/v2.1/zh-CN/installation/intro/ and the English one need to update the first screenshot since the supported k8s versions changed to 1.17.x

3. 除了在控制台查看组件状态，还可以通过 kubectl 命令确认可插拔的组件是否安装成功，通常情况下，当该 namespace 下的所有 Pod 状态都为 Running，则说明其安装成功。

kubectl get pod -n namespace

这里的 namespace 应该替换为真实的 kubesphere namespace : kubesphere-system，否则该指令没有意义。

示例 6：设置弹性伸缩
https://kubesphere.com.cn/docs/v2.1/zh-CN/quick-start/hpa/

all-in-one 环境，在执行 修改弹性伸缩 步骤时，例如将最大 pod 数值从 10 改为 6，系统报错：
HorizontalPodAutoscaler.autoscaling "hpa-1uoyeb" is invalid: spec.metrics[0].resource.target.averageValue: Invalid value: resource.Quantity{i:resource.int64Amount{value:0, scale:0}, d:resource.infDecAmount{Dec:(*inf.Dec)(nil)}, s:"0", Format:"DecimalSI"}: must be positive

The edit button in each page is missing, we need to display it in each page.

Devops 文档保留分支天数/个数容易引起歧义：

输入框下的提示 默认值-1 表示将会丢弃已经被删除的分支

说明却说默认值-1 表示不自动删除分支

这个到底是删还是不删？

• https://kubesphere.com.cn/docs/v2.1/en/installation/intro/ "air gapped installation please refer to Disconnected Installation on Multi-Node" links to a Chinese forum page.

Add an input box to support mail subscription feature in kubesphere.io, it allows distribute any announcements or blogs updates.

When I choose an older version doc then try to switch back, the latest version is missing.

@leoendless User survey in kubesphere.com.cn/docs/ displays English version, it should be English.

• kubesphere.io/docs/ should be set as English version by default, and kubesphere.com.cn/docs/ should be set as Chinese version.

示例七，地址:https://kubesphere.io/docs/v2.1/zh-CN/quick-start/source-to-image/
第二步：构建设置
5、配置「健康检查器」下的「容器就绪检查」，选择 「HTTP请求检查」。
路径：必填，该示例默认使用根路径 \；

根路径应该是/ ，而不是\