Files
kuboard-press/docs/install/install-dashboard.html
huanqing.shao e2bb7fa69f sidebar
2019-07-25 22:26:28 +08:00

40 lines
16 KiB
HTML
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.

<!DOCTYPE html>
<html lang="en-US">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>安装 kuboard | Kuboard</title>
<meta name="description" content="A cool Kubernetes Dashboard">
<link rel="preload" href="/assets/css/0.styles.f7270952.css" as="style"><link rel="preload" href="/assets/js/app.1aea5246.js" as="script"><link rel="preload" href="/assets/js/11.ece05c2e.js" as="script"><link rel="preload" href="/assets/js/2.7beee842.js" as="script"><link rel="preload" href="/assets/js/37.9c3a8113.js" as="script"><link rel="prefetch" href="/assets/js/10.1fb09bde.js"><link rel="prefetch" href="/assets/js/12.36a43db6.js"><link rel="prefetch" href="/assets/js/13.a3c7408e.js"><link rel="prefetch" href="/assets/js/14.848c4d4d.js"><link rel="prefetch" href="/assets/js/15.4e867c35.js"><link rel="prefetch" href="/assets/js/16.8fc07fa2.js"><link rel="prefetch" href="/assets/js/17.63b12ede.js"><link rel="prefetch" href="/assets/js/18.ce28b0b6.js"><link rel="prefetch" href="/assets/js/19.15c5282f.js"><link rel="prefetch" href="/assets/js/20.0fcdd81e.js"><link rel="prefetch" href="/assets/js/21.e225b222.js"><link rel="prefetch" href="/assets/js/22.7c147cae.js"><link rel="prefetch" href="/assets/js/23.595c64cb.js"><link rel="prefetch" href="/assets/js/24.334d8141.js"><link rel="prefetch" href="/assets/js/25.1b5f98e3.js"><link rel="prefetch" href="/assets/js/26.3a77fe9f.js"><link rel="prefetch" href="/assets/js/27.d031e218.js"><link rel="prefetch" href="/assets/js/28.178bbcd9.js"><link rel="prefetch" href="/assets/js/29.a90b24f5.js"><link rel="prefetch" href="/assets/js/3.be84d8fc.js"><link rel="prefetch" href="/assets/js/30.5e2e0648.js"><link rel="prefetch" href="/assets/js/31.22ed528f.js"><link rel="prefetch" href="/assets/js/32.735c7fda.js"><link rel="prefetch" href="/assets/js/33.559772c6.js"><link rel="prefetch" href="/assets/js/34.568a49f8.js"><link rel="prefetch" href="/assets/js/35.b9912582.js"><link rel="prefetch" href="/assets/js/36.5fbc1f27.js"><link rel="prefetch" href="/assets/js/38.0324f620.js"><link rel="prefetch" href="/assets/js/4.caad100e.js"><link rel="prefetch" href="/assets/js/5.84a977be.js"><link rel="prefetch" href="/assets/js/6.0bed3517.js"><link rel="prefetch" href="/assets/js/7.8a40c4b7.js"><link rel="prefetch" href="/assets/js/8.bb1f98a1.js"><link rel="prefetch" href="/assets/js/9.8cc06980.js">
<link rel="stylesheet" href="/assets/css/0.styles.f7270952.css">
</head>
<body>
<div id="app" data-server-rendered="true"><div class="theme-container" data-v-79c95b4d><header class="navbar"><div class="sidebar-button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" role="img" viewBox="0 0 448 512" class="icon"><path fill="currentColor" d="M436 124H12c-6.627 0-12-5.373-12-12V80c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12z"></path></svg></div> <a href="/" class="home-link router-link-active"><!----> <span class="site-name">Kuboard</span></a> <div class="links"><div class="search-box"><input aria-label="Search" autocomplete="off" spellcheck="false" value=""> <!----></div> <nav class="nav-links can-hide"><div class="nav-item"><a href="/overview/" class="nav-link">简介</a></div><div class="nav-item"><a href="/install/" class="nav-link router-link-active">安装</a></div><div class="nav-item"><a href="/guide/" class="nav-link">使用</a></div><div class="nav-item"><a href="/support/" class="nav-link">支持</a></div> <!----></nav></div></header> <div class="sidebar-mask"></div> <aside class="sidebar"><div data-v-79c95b4d><div style="text-align:center;margin-top:20px;" data-v-79c95b4d><div class="side-nav-item" style="margin-left:0;" data-v-79c95b4d><a href="/overview/" class="nav-link" data-v-79c95b4d>简介</a></div> <div class="side-nav-item" style="border-bottom:2px solid #0b85ff;" data-v-79c95b4d><a href="/install/" class="nav-link router-link-exact-active router-link-active" data-v-79c95b4d>安装</a></div> <div class="side-nav-item" data-v-79c95b4d><a href="/guide/" class="nav-link" data-v-79c95b4d>使用</a></div> <div class="side-nav-item" data-v-79c95b4d><a href="/support/" class="nav-link" data-v-79c95b4d>支持</a></div></div></div> <ul class="sidebar-links"><li><section class="sidebar-group depth-0"><p class="sidebar-heading"><span>概述</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/install/" class="sidebar-link">概述</a></li></ul></section></li><li><section class="sidebar-group depth-0"><p class="sidebar-heading"><span>安装 Kubernetes</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/install/install-k8s.html" class="sidebar-link">安装 Kubernetes 用于测试</a></li><li><a href="/install/install-kubernetes.html" class="sidebar-link">安装 Kubernetes</a></li></ul></section></li><li><section class="sidebar-group depth-0"><p class="sidebar-heading open"><span>安装 Kuboard</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/install/install-dashboard.html" class="active sidebar-link">安装 kuboard</a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/install/install-dashboard.html#前提" class="sidebar-link">前提</a></li><li class="sidebar-sub-header"><a href="/install/install-dashboard.html#兼容性" class="sidebar-link">兼容性</a></li><li class="sidebar-sub-header"><a href="/install/install-dashboard.html#安装" class="sidebar-link">安装</a></li><li class="sidebar-sub-header"><a href="/install/install-dashboard.html#获取-token" class="sidebar-link">获取 token</a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/install/install-dashboard.html#获取管理员用户-token" class="sidebar-link">获取管理员用户 token</a></li><li class="sidebar-sub-header"><a href="/install/install-dashboard.html#获取只读用户的token" class="sidebar-link">获取只读用户的Token</a></li></ul></li><li class="sidebar-sub-header"><a href="/install/install-dashboard.html#访问-kuboard" class="sidebar-link">访问 Kuboard</a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/install/install-dashboard.html#通过域名访问" class="sidebar-link">通过域名访问</a></li><li class="sidebar-sub-header"><a href="/install/install-dashboard.html#通过-nodeport-访问" class="sidebar-link">通过 NodePort 访问</a></li></ul></li></ul></li></ul></section></li></ul> <div style="text-align: center;"><strong>在线体验</strong> <div><a target="_blank" href="http://demo.eip.work/#/login?isReadOnly=true&token=eyJhbGciOiJSUzI1NiIsImtpZCI6IiJ9.eyJpc3MiOiJrdWJlcm5ldGVzL3NlcnZpY2VhY2NvdW50Iiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9uYW1lc3BhY2UiOiJrdWJlLXN5c3RlbSIsImt1YmVybmV0ZXMuaW8vc2VydmljZWFjY291bnQvc2VjcmV0Lm5hbWUiOiJrdWJvYXJkLXZpZXdlci10b2tlbi02djZiZiIsImt1YmVybmV0ZXMuaW8vc2VydmljZWFjY291bnQvc2VydmljZS1hY2NvdW50Lm5hbWUiOiJrdWJvYXJkLXZpZXdlciIsImt1YmVybmV0ZXMuaW8vc2VydmljZWFjY291bnQvc2VydmljZS1hY2NvdW50LnVpZCI6IjhiYTU3YmI1LWFiMTctNDM1NS1hNTM0LTQ0Njk4NGY0NzFlZiIsInN1YiI6InN5c3RlbTpzZXJ2aWNlYWNjb3VudDprdWJlLXN5c3RlbTprdWJvYXJkLXZpZXdlciJ9.DcXNIp0RKha1zkV4ga_QlGfcvMLGx2LOyzX-0VeboC3FojKFhxnfBeoda-zTeh6ugJlSM4kQYrRcof1Kx8Mg3-UgofNmgRySbDEVKtJZyMUoHqLmySKUIn8sbX8q83RNcqwcvY-fM8-w8HSuzU7Td7WWNuZrlCL4q_LQDYIBet1nlQ83YsENKNE8rsZQFDw8YM0MH6BEZLdwyhaboy_jjYbsU7kv8gks3aIX4lh1Fs9ZFQpC_6B0_MZvb7rEeG2M8QWXoUkDoL5JCKu6Wot5GlWf0kDMxIsViggP0NmSDTKh6kIvCkT2FZ2I4guEcjE_EjBpdOS6Abta22tzLlPKhg"><p><img src="/assets/img/image-20190723104717575.db9f16c5.png"></p></a></div> <strong>在线提问</strong> <p><img src="/assets/img/kuboard_qq.45e78dbf.png"></p></div></aside> <main class="page"> <div class="theme-default-content content__default"><h1 id="安装-kuboard"><a href="#安装-kuboard" aria-hidden="true" class="header-anchor">#</a> 安装 kuboard</h1> <h2 id="前提"><a href="#前提" aria-hidden="true" class="header-anchor">#</a> 前提</h2> <p>安装 kuboard 时,假设您已经:</p> <ul><li>已经有一个 kubernetes 集群</li> <li>拥有对该 kubernetes 集群执行 kubectl 命令时的所有权限</li></ul> <p>如果没有 kubernetes 集群,可以有如下选项:</p> <ul><li>通过 阿里云 创建 kubernetes 容器服务,并获得和配置 kubectl 的访问参数</li> <li>参考 <a href="install-k8s">安装 kubernetes 用于测试</a></li> <li>或参考 <a href="install-kubernetes">安装 kubernetes 高可用</a></li></ul> <p><a href="https://promotion.aliyun.com/ntms/yunparter/invite.html?userCode=obezo3pg" target="_blank" rel="noopener noreferrer">领取阿里云最高2000元红包<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></a></p> <h2 id="兼容性"><a href="#兼容性" aria-hidden="true" class="header-anchor">#</a> 兼容性</h2> <table><thead><tr><th>Kubernetes 版本</th> <th>Kuboard 版本</th> <th>兼容性</th> <th>说明</th></tr></thead> <tbody><tr><td>v1.15</td> <td>v1.0.0-beta.10</td> <td><span style="font-size:24px;">😄</span></td> <td>已验证</td></tr> <tr><td>v1.14</td> <td>v1.0.0-beta.10</td> <td><span style="font-size:24px;">😄</span></td> <td>已验证</td></tr> <tr><td>v1.13</td> <td>v1.0.0-beta.10</td> <td><span style="font-size:24px;">😄</span></td> <td>已验证</td></tr> <tr><td>v1.12</td> <td>v1.0.0-beta.10</td> <td><span style="font-size:24px;">😐</span></td> <td>Kubernetes Api 尚不支持 dryRun<br>忽略Kuboard在执行命令式的参数校验错误可正常工作</td></tr> <tr><td>v1.11</td> <td>v1.0.0-beta.10</td> <td><span style="font-size:24px;">😐</span></td> <td>同上</td></tr></tbody></table> <div class="warning custom-block"><p><strong>Kubernetes 安装方式</strong></p> <ul><li>部分用户使用二进制包的形式安装 KubernetesKuboard 现在的版本不能在这类 Kubernetes 集群中正常工作,作者正在解决此问题。</li> <li>如果您是使用 kubeadm 安装的 Kubernetes 集群Kubernetes 官方推荐的安装方式),请放心使用 Kuboard。</li> <li>Kubeadm 相关资料请参考 https://kubernetes.io/docs/reference/setup-tools/kubeadm/kubeadm/</li></ul></div> <h2 id="安装"><a href="#安装" aria-hidden="true" class="header-anchor">#</a> 安装</h2> <p><strong>获取并修改yaml文件</strong></p> <div class="language-bash extra-class"><pre class="language-bash"><code><span class="token function">wget</span> https://raw.githubusercontent.com/eip-work/eip-monitor-repository/master/dashboard/kuboard.yaml
</code></pre></div><p>修改文件 kuboard.yaml 中 Ingress 的 host 为 kuboard.yourclustername.yourdomain.com</p> <p><strong>执行安装</strong></p> <div class="language-bash extra-class"><pre class="language-bash"><code>kubectl apply -f kuboard.yaml
</code></pre></div><h2 id="获取-token"><a href="#获取-token" aria-hidden="true" class="header-anchor">#</a> 获取 token</h2> <h3 id="获取管理员用户-token"><a href="#获取管理员用户-token" aria-hidden="true" class="header-anchor">#</a> 获取管理员用户 token</h3> <p><strong>拥有的权限</strong></p> <p>此Token拥有 ClusterAdmin 的权限,可以执行所有操作</p> <div class="language-bash extra-class"><pre class="language-bash"><code>kubectl -n kube-system describe secret <span class="token variable"><span class="token variable">$(</span>kubectl -n kube-system get secret <span class="token operator">|</span> <span class="token function">grep</span> kuboard-user <span class="token operator">|</span> <span class="token function">awk</span> <span class="token string">'{print <span class="token variable">$1</span>}'</span><span class="token variable">)</span></span>
</code></pre></div><p>执行完该命令后,可获得类似如下的输出:</p> <div class="language- extra-class"><pre class="language-text"><code>Name: admin-user-token-g8hxb
Namespace: kube-system
Labels: &lt;none&gt;
Annotations: [kubernetes.io/service-account.name](http://kubernetes.io/service-account.name): kuboard-user
[kubernetes.io/service-account.uid](http://kubernetes.io/service-account.uid): 948bb5e6-8cdc-11e9-b67e-fa163e5f7a0f
Type: [kubernetes.io/service-account-token](http://kubernetes.io/service-account-token)
Data
====
ca.crt: 1025 bytes
namespace: 11 bytes
token: eyJhbGciOiJSUzI1NiIsImtpZCI6IiJ9.eyJpc3MiOiJrdWJlcm5ldGVzL3NlcnZpY2VhY2NvdW50Iiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9uYW1lc3BhY2UiOiJrdWJlLXN5c3RlbSIsImt1YmVybmV0ZXMuaW8vc2VydmljZWFjY291bnQvc2VjcmV0Lm5hbWUiOiJhZG1pbi11c2VyLXRva2VuLWc4aHhiIiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9zZXJ2aWNlLWFjY291bnQubmFtZSI6ImFkbWluLXVzZXIiLCJrdWJlcm5ldGVzLmlvL3NlcnZpY2VhY2NvdW50L3NlcnZpY2UtYWNjb3VudC51aWQiOiI5NDhiYjVlNi04Y2RjLTExZTktYjY3ZS1mYTE2M2U1ZjdhMGYiLCJzdWIiOiJzeXN0ZW06c2VydmljZWFjY291bnQ6a3ViZS1zeXN0ZW06YWRtaW4tdXNlciJ9.DZ6dMTr8GExo5IH_vCWdB_MDfQaNognjfZKl0E5VW8vUFMVvALwo0BS-6Qsqpfxrlz87oE9yGVCpBYV0D00811bLhHIg-IR_MiBneadcqdQ_TGm_a0Pz0RbIzqJlRPiyMSxk1eXhmayfPn01upPdVCQj6D3vAY77dpcGplu3p5wE6vsNWAvrQ2d_V1KhR03IB1jJZkYwrI8FHCq_5YuzkPfHsgZ9MBQgH-jqqNXs6r8aoUZIbLsYcMHkin2vzRsMy_tjMCI9yXGiOqI-E5efTb-_KbDVwV5cbdqEIegdtYZ2J3mlrFQlmPGYTwFI8Ba9LleSYbCi4o0k74568KcN_w
</code></pre></div><h3 id="获取只读用户的token"><a href="#获取只读用户的token" aria-hidden="true" class="header-anchor">#</a> 获取只读用户的Token</h3> <p><strong>拥有的权限</strong></p> <ul><li>view 可查看名称空间的内容</li> <li>system:node 可查看节点信息</li> <li>system:persistent-volume-provisioner 可查看存储类和存储卷声明的信息</li></ul> <p><strong>适用场景</strong></p> <p>只读用户不能对集群的配置执行修改操作,非常适用于将开发环境中的 kuboard 只读权限分发给开发者,以便开发者可以便捷地诊断问题</p> <p>执行如下命令可以获得 <span style="color:#F56C6C;font-weight:500;">只读用户</span> 的 Token</p> <div class="language-bash extra-class"><pre class="language-bash"><code>kubectl -n kube-system describe secret <span class="token variable"><span class="token variable">$(</span>kubectl -n kube-system get secret <span class="token operator">|</span> <span class="token function">grep</span> kuboard-viewer <span class="token operator">|</span> <span class="token function">awk</span> <span class="token string">'{print <span class="token variable">$1</span>}'</span><span class="token variable">)</span></span>
</code></pre></div><h2 id="访问-kuboard"><a href="#访问-kuboard" aria-hidden="true" class="header-anchor">#</a> 访问 Kuboard</h2> <h3 id="通过域名访问"><a href="#通过域名访问" aria-hidden="true" class="header-anchor">#</a> 通过域名访问</h3> <p>在浏览器打开链接 http://kuboard.yourclustername.yourdomain.com (使用前面已修改的域名)</p> <p>输入前一步骤中获得的 token可进入控制台界面</p> <h3 id="通过-nodeport-访问"><a href="#通过-nodeport-访问" aria-hidden="true" class="header-anchor">#</a> 通过 NodePort 访问</h3> <p>kuboard Service 使用了 NodePort 的方式暴露服务NodePort 为 32567您可以按如下方式访问 kuboard</p> <div class="language- extra-class"><pre class="language-text"><code>http://any-of-your-node-ip:32567/
</code></pre></div><blockquote><p>您也可以修改 kuboard.yaml 文件,使用自己定义的 NodePort 端口号</p></blockquote></div> <footer class="page-edit"><!----> <div class="last-updated"><span class="prefix">更新时间: </span> <span class="time">2019-07-25 14:09:59</span></div></footer> <div class="page-nav"><p class="inner"><span class="prev">
<a href="/install/install-kubernetes.html" class="prev">
安装 Kubernetes
</a></span> <!----></p></div> <div class="bottom-description" data-v-79c95b4d>Copyright © 2019-present HuanQing Shao</div></main></div><div class="global-ui"><!----></div></div>
<script src="/assets/js/app.1aea5246.js" defer></script><script src="/assets/js/11.ece05c2e.js" defer></script><script src="/assets/js/2.7beee842.js" defer></script><script src="/assets/js/37.9c3a8113.js" defer></script>
</body>
</html>