Files
kuboard-press/install/faq/logs-terminal.md
2020-07-25 21:08:14 +08:00

112 lines
4.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
vssueId: 150
description: Kuboard_的日志界面和终端界面都使用了WebSocket与服务器进行通信_在部分情况下_可能出现连通性问题_本文描述了一种解决此问题的办法
meta:
- name: keywords
content: Kubernetes 管理界面, Kuboard
---
# 日志终端访问的问题
<AdSenseTitle/>
极少数情况下,您可能能够正常访问 Kuboard 和使用 Kuboard 的各项功能,但是,访问 Kuboard 提供的日志界面和终端界面时,始终会出现弹窗提示,并将您指引到了现在的这个页面上来。本文描述了如何排查 Kuboard 日志/终端界面不能访问的问题
## 第一步
Kuboard 日志界面和终端界面都使用了 websocket 与服务器端通信正常情况下会工作得很好但是当出现如下几种情况时websocket 的连接就会出现问题:
* 您所访问的容器已经停止
* 您当前使用的浏览器不支持 WebSocket推荐使用最新版本的 chrome 浏览器,也可以尝试最新版本的 firefox
如果您还有问题,请尝试:
* (如果刚完成 Kuboard 的升级)退出 Kuboard 登录,重新输入 token 登录 Kuboard
* 清空浏览器缓存
## 第二步
当您排除了上述两个问题之后,剩下极有可能的情况就是:
* 您访问服务器时,网络链路上存在代理,比如:
* 您配置了 Nginx 反向代理,通过 Nginx 将请求转发到 Kuboard 的节点端口 32567
* 您的浏览器设置了代理程序,并通过代理访问网站内容
* 您使用了科学上网的工具
* 您通过 VPN 接入到服务器所在的网络,然后访问 Kuboard 的节点端口 32567
* 您的网络运营商(如长城宽带、小区宽带、电力猫等)为了节省出口带宽,对所有的 HTTP 服务都做了代理和缓存
此时,您可以为 Kuboard 启用 https (请在方向代理上配置 https或者您可以尝试使用 kubectl port-forward 的方式来访问 Kuboard。具体步骤如下
* 请参考 [在客户端电脑安装 kubectl](/install/install-kubectl.html)
* 在客户端电脑上执行端口转发命令,此命令将监听您客户端机器的 8000 端口,并将请求转发到 kuboard 所在 Pod 的 80 端口
``` sh
kubectl port-forward svc/kuboard -n kube-system 8000:80
```
* 在 chrome 打开地址 `http://localhost:8000/
登录重试,此时应该能够正常访问 kuboard 的日志界面和终端界面。
::: tip 如果还解决不了
请参考本文末尾的方式联系 Kuboard 团队
:::
## Ingress设置
如果通过 Ingress 的方式访问 Kuboard需要在 IngressController 上开启 websocket以 nginx-ingress 为例,下面的 YAML 可以开启 websocket。更多信息请参考 [Ingress 注解配置](/learning/k8s-intermediate/service/ingress-annotation.html)
``` yaml {8}
apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
annotations:
k8s.kuboard.cn/displayName: kuboard
k8s.kuboard.cn/workload: kuboard
nginx.com/sticky-cookie-services: serviceName=kuboard srv_id expires=1h path=/
nginx.org/websocket-services: kuboard
labels:
k8s.kuboard.cn/layer: monitor
k8s.kuboard.cn/name: kuboard
name: kuboard
namespace: kube-system
spec:
rules:
- host: kuboard.demo.kuboard.cn
http:
paths:
- backend:
serviceName: kuboard
servicePort: http
path: /
```
## 反向代理设置
如果您为 Kuboard 设置了 nginx 反向代理,请在 nginx 上开启 websocket配置文件如下所示
``` nginx {9,13,14}
server {
listen 80;
server_name kuboard.yourdomain.com; # 替换成你的域名
location / {
proxy_pass http://192.168.2.39:32567; # 替换成你的节点地址
proxy_http_version 1.1;
proxy_pass_header Authorization;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
# proxy_set_header X-Forwarded-Proto https; # 如果您在反向代理上启用了 HTTPS
}
location /k8s-ws/ {
proxy_pass http://192.168.2.39:32567; # 替换成你的节点地址
proxy_http_version 1.1;
proxy_pass_header Authorization;
proxy_set_header Upgrade "websocket";
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
# proxy_set_header X-Forwarded-Proto https; # 如果您在反向代理上启用了 HTTPS
}
gzip on;
}
```