跳到主要内容

更换前端证书

介绍如何使用自定义证书替换系统前端默认的证书。

提示

本文只适用于使用 ocboot 部署的环境。

如果是使用 Helm 部署的环境，请在自己的 kubernetes 集群里面更换证书。

另外 docker compose 部署的环境一般只用于测试，还不支持更换证书。

默认部署完成后，访问前端界面，浏览器会提示不安全的 SSL 连接，原因是前端默认使用的是自签发的证书。本文介绍如何使用自定义证书替换掉前端默认的证书。

更换前端证书操作步骤​

假设已经准备好的证书文件为：cert.pem 和 cert.key，域名为 foo.bar.com 。

1. 将证书导入 kubernetes 集群​

kubernetes 使用 secret 这种资源保存证书内容，然后前端服务使用 ingress 引用对应的证书，提供 HTTPS 连接。为了使用自定证书，需要先把证书保存到集群。

# 创建证书
$ kubectl create secret tls yunion-io-web-secret --key cert.key --cert cert.pem -n onecloud

2. 编辑 ingress 规则​

编辑 default-web ingress 规则，引用刚才创建的 yunion-io-web-secret 证书。

$ kubectl edit ingress -n onecloud default-web
...
  tls:
  # 修改这个 secretName 为 yunion-io-web-secret
  - secretName: yunion-io-web-secret
...

3. 重启 ingress controller​

设置完 default-web ingress 规则后，可以重启下 ingress controller 服务，让证书生效。

$ kubectl get pods -n kube-system | grep traefik | awk '{print $1}' | xargs kubectl delete pods -n kube-system

4. 修改服务 api_server 入口配置​

因为使用域名 foo.bar.com 访问，需要修改云平台的默认 api_server 配置，这个配置会影响前端 VNC 连接的地址。将旧的 https://ip 访问地址改为 https://foo.bar.com，操作如下：

$ climc service-config-edit common
default:
  api_server: https://foo.bar.com
  ...

然后重启 webconsole 服务，操作如下：

$ kubectl delete pods -n onecloud $(kubectl get pods -n onecloud | egrep 'webconsole|apigateway' | awk '{print $1}')

配置完成后，等待 webconsole 和 apigateway pod 重启后，就可以通过 https://foo.bar.com 访问前端了。

更改前端HTTPS 443端口为其它端口的方法步骤​

假设平台登陆地址为https://10.127.90.221，更改443端口为8443

# 编辑 traefik-ingress-lb 的configmap，找到address = ":443"，把443改为8443
$ kubectl edit cm -n kube-system traefik-ingress-lb
# Please edit the object below. Lines beginning with a '#' will be ignored,
# and an empty file will abort the edit. If an error occurs while saving this file will be
# reopened with the relevant failures.
#
apiVersion: v1
data:
  traefik.toml: |
    logLevel = "info"
    insecureSkipVerify = true
    defaultEntryPoints = ["http", "https"]

    [api]
      entryPoint = "traefik"
      dashboard = false

    [kubernetes]

    [entryPoints]
      [entryPoints.traefik]
        address=":8091"
      [entryPoints.http]
        address = ":80"
        [entryPoints.http.redirect]
        entryPoint = "https"
      [entryPoints.https]
        address = ":8443"

# 重启traefik-ingress-controller的pods
$ kubectl get pods -n kube-system |grep traefik-ingress | awk '{print $1}' |xargs kubectl delete pods -n kube-system

# 等新的traefik-ingress-controller pods状态为Running，修改8443端成功
$ kubectl get pods  -n kube-system  | grep  traefik-ingress  
traefik-ingress-controller-49fmk             1/1     Running   0          42s

# 浏览器输入https://10.127.90.221:8443访问控制台，ip为原控制台的地址