kubernetes系列(十七) - 通过helm安装dashboard详细教程

2024-01-23 20:37:30

1. 前提条件
2. 配置https证书为secret
3. dashboard安装
4. 查看token并使用token登陆
5. 给dashboard的serviceaccont授权

这篇博文介绍的是安装Dashboard V2.0.3, 并将其映射到具体的域名上。先上一个成果图，如果安装过程中有遇到什么问题，可以评论联系我

1. 前提条件

本次安装基于Helm的chart包安装的，且向外暴露服务的方式为Ingress，所以有以下前提：

已安装好Helm

如未安装helm，可以参照：kubernetes系列(十六) - Helm安装和入门

集群已经以DaemonSet方式安装好了Ingress-nginx

如未安装，安装教程可以参照下篇文章的第四小节部分：kubernetes系列(十) - 通过Ingress实现七层代理

一个已经备案过的域名，和具体的域名配套的https证书

因为使用的是ingress，所以必须要域名，且dashboard需要https才能外网访问，证书可以在阿里云之类的购买一年期的免费赠书

2. 配置https证书为secret

上传域名的nginx证书到服务器上

# 具体上传过程不赘述
# 这里假设证书aaa.key和bbb.crt已经上传至路径/usr/local/cert

cd /usr/local/cert

# 创建secret到kube-system命名空间下
# 之后我们的dashboard也会创建在这个命名空间下，需要依赖这个，所以提前创建
kubectl creat secret tls dashboard-tls --key aaa.key --cert bbb.crt -n kube-system

3. dashboard安装

3.1 helm拉取dashboard的chart

# 添加helmhub上的dashboard官方repo仓库
helm repo add kubernetes-dashboard https://kubernetes.github.io/dashboard/

# 查看添加完成后的仓库
helm repo list

# 查询dashboard的chart
helm search repo  kubernetes-dashboard

# 新建文件夹用于保存chart
mkdir dashboard-chart && cd dashboard-chart

# 拉取chart
helm pull kubernetes-dashboard/kubernetes-dashboard

# 此时会有一个压缩包，解压它
tar -zxvf kubernetes-dashboard-2.3.0.tgz

# 进入到解压后的文件夹
cd kubernetes-dashboard

3.2 配置dashboard的chart包配置

注意：以下创建的new-values.yaml是基于values.yaml修改的，即意味着如果需要跟自定义的配置，可以自己参照values.yaml修改配置文件

新建一个new-values.yaml，内容如下

注意：以下的host需要换成自己的域名，且secretname需要跟刚刚创建的secret对应起来

image:
  repository: kubernetesui/dashboard
  tag: v2.0.3
  pullPolicy: IfNotPresent
  pullSecrets: []
replicaCount: 1
annotations: {}
labels: {}
extraEnv: []
podAnnotations:
  seccomp.security.alpha.kubernetes.io/pod: 'runtime/default'
nodeSelector: {}
tolerations: []
affinity: {}

resources:
  requests:
    cpu: 100m
    memory: 200Mi
  limits:
    cpu: 2
    memory: 200Mi
protocolHttp: false

service:
  type: ClusterIP
  externalPort: 443
  annotations: {}
  labels: {}

ingress:
  enabled: true
  annotations:
    nginx.ingress.kubernetes.io/secure-backends: "true"
    nginx.ingress.kubernetes.io/backend-protocol: "HTTPS"
  paths:
    - /
  customPaths: []
  hosts:
    - xxx.xxx.com # 你的域名
  tls:
    # 注意这个名字要跟前面新建的secret对上
    - secretName: dashboard-tls
      hosts:
        - xxx.xxx.com # 你的域名

metricsScraper:
  enabled: false
  image:
    repository: kubernetesui/metrics-scraper
    tag: v1.0.4
  resources: {}
  containerSecurityContext:
    allowPrivilegeEscalation: false
    readOnlyRootFilesystem: true
    runAsUser: 1001
    runAsGroup: 2001

metrics-server:
  enabled: false

rbac:
  create: true
  clusterRoleMetrics: true
  clusterReadOnlyRole: false

serviceAccount:
  create: true
  name:

livenessProbe:
  initialDelaySeconds: 30
  timeoutSeconds: 30

podDisruptionBudget:
  enabled: false
  minAvailable:
  maxUnavailable:

containerSecurityContext:
  allowPrivilegeEscalation: false
  readOnlyRootFilesystem: true
  runAsUser: 1001
  runAsGroup: 2001

networkPolicy:
  enabled: false

3.3 helm执行创建dashboard的release

# 执行路径在new-values.yaml目录
helm install -f new-values.yaml --namespace kube-system kubernetes-dashboard .

3.4 通过域名访问dashboard

注意：云服务商的域名解析处，需要将域名通过A记录解析到某个node节点上

然后访问刚刚配置文件配置的域名应该能够访问到如下界面

4. 查看token并使用token登陆

这里我们需要查看token

查看内容含有token的secret


[root@k8s-master kubernetes-dashboard]# kubectl get secret -n kube-system | grep kubernetes-dashboard-token
kubernetes-dashboard-token-vgp9w                 kubernetes.io/service-account-token   3      22h

describe一下获取token值

kubectl describe secret kubernetes-dashboard-token-vgp9w -n kube-system

复制这一串token

根据如下的登陆
登陆成功

5. 给dashboard的serviceaccont授权

此时我们刚进去界面，发现什么资源都显示不了，是因为dashboard默认的serviceaccount并没有权限，所以我们需要给予它授权。

注意：我这里直接赋予的是admin权限，如果需要更加细颗粒度的授权，请参照官方的说明

https://github.com/kubernetes/dashboard/blob/master/docs/user/access-control/README.md

创建dashboard-admin.yaml,内容为以下

apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  name: kubernetes-dashboard
  namespace: kube-system
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: cluster-admin
subjects:
  - kind: ServiceAccount
    name: kubernetes-dashboard
    namespace: kube-system

应用资源文件dashboard-admin.yaml

kubectl apply -f dashboard-admin.yaml

授权成功，可以通过dashboard查看到资源

码农公寓