集群版安装

集群版组件说明

组件类型功能说明
polaris最新stable版本系统组件服务治理控制面
polaris-console最新stable版本系统组件服务治理控制台
MySQL>= 5.7第三方依赖服务数据存储
Redis>=4.0第三方依赖心跳状态数据缓存
Prometheus>=2.28.0第三方依赖可观测性

最小生产组网规格

节点类型节点数量规格要求
polaris-console & polaris2CentOS 7.5，1C2G，存储10G
MySQL11C2G，存储10G
Redis11C2G
Prometheus11C1G

部署架构

核心组网

获取最新软件包

可以从以下2个地址下载北极星软件包，请选择最新的release版本：

下载软件包

安装第三方依赖

部署MySQL

北极星可以与应用程序共用一个数据库，如果有现成MySQL则可以跳过这一步。

安装开源版本MySQL的步骤可参考：MySQL安装集群版安装 - 图7 (opens new window)

初始数据导入

解压源码包并执行导入：

第一次安装北极星

  1. unzip polaris-$version.zip
  2. cd polaris-$version
  3. mysql -u $db_user -p $db_pwd -h $db_host < store/sqldb/scripts/polaris_server.sql

已有在运行的北极星，执行升级store/sqldb/scripts/delta中的升级脚本

  1. unzip polaris-$version.zip
  2. cd polaris-$version
  3. mysql -u $db_user -p $db_pwd -h $db_host < store/sqldb/scripts/delta/v160-v170.sql

部署Redis

北极星可以与应用程序共用一个Redis，如果有现成Redis则可跳过这一步。

安装开源版本Redis的步骤可参考：Redis安装集群版安装 - 图8 (opens new window)

安装后，需要设置Redis允许远程主机访问。可以修改redis.conf配置文件：

  1. bind 0.0.0.0
  2. protected-mode no

修改后重启Redis生效。

安装系统组件

部署在kubernetes

修改配置

  • 下载软件包：下载polaris-standalone-release_$version.kubernetes.zip，解压后进入polaris-standalone-release_$version.kubernetes目录。

  • 配置数据库参数：修改02-polaris-server-config.yaml里面的store配置，去掉boltdbStore相关配置，并放开defaultStore相关配置。

  1. # 存储配置
  2. store:
  3. # 数据库存储插件
  4.   name: defaultStore
  5.   option:
  6.     master:
  7.       dbType: mysql
  8.       dbName: polaris_server
  9.       dbAddr: ##数据库地址，格式为ip:port##
  10.       dbUser: ##数据库用户名##
  11.       dbPwd: ##数据库密码##
  • 开启自动注册：修改02-polaris-server-config.yaml里面的服务自注册配置，将enable_register改成true，并填入probe_address：
  1. bootstrap:
  2.   polaris_service:
  3.     # 设置为true代表启用自动注册
  4.     enable_register: true
  5.     # 填入数据库地址，用于获取当前节点ip信息
  6.     probe_address: ##数据库地址##
  • 配置Redis参数：修改02-polaris-server-config.yaml里面的healthcheck配置，去掉heartbeatMemory相关配置，并放开heartbeatRedis相关配置。
  1. healthcheck:
  2.   checkers:
  3.   - name: heartbeatRedis
  4.     option:
  5.       #填入redis的IP以及端口
  6.       kvAddr: ##REDIS_ADDR##
  7.       #填入redis的密码
  8.       kvPasswd: ##REDIS_PWD##
  9.       maxIdle: 200
  10.       idleTimeout: 120s
  11.       connectTimeout: 200ms
  12.       msgTimeout: 200ms
  13.       concurrency: 200

执行部署

  1. kubectl create -f 00-polaris-namespace-config.yaml 
  2. kubectl create -f 01-polaris-console-config.yaml  
  3. kubectl create -f 02-polaris-server-config.yaml  
  4. kubectl create -f 03-polaris-server.yaml
  5. kubectl create -f 04-prometheus.yaml

部署后验证

  • 登录控制台的默认登录账户信息
  1. 用户：polaris
  2. 密码：polaris
  • 访问http://{控制台IP}:8080，可以看到登录页面，登录后可以成功看到北极星服务治理控制台内容。

部署在Linux虚拟机

安装polaris

  • 下载软件包：下载polaris-server-release_$version.linux.$arch.zip，解压后进入polaris-server-release_$version.linux.$arch目录

  • 配置数据库参数：修改polaris-server.yaml里面的store配置，去掉boltdbStore相关配置，并放开defaultStore相关配置。

  1. # 存储配置
  2. store:
  3. # 数据库存储插件
  4.   name: defaultStore
  5.   option:
  6.     master:
  7.       dbType: mysql
  8.       dbName: polaris_server
  9.       dbAddr: ##数据库地址，格式为ip:port##
  10.       dbUser: ##数据库用户名##
  11.       dbPwd: ##数据库密码##
  • 开启自动注册：修改polaris-server.yaml里面的服务自注册配置，将enable_register改成true，并填入probe_address：
  1. bootstrap:
  2.   polaris_service:
  3.     # 设置为true代表启用自动注册
  4.     enable_register: true
  5.     # 填入数据库地址，用于获取当前节点ip信息
  6.     probe_address: ##数据库地址##
  • 配置Redis参数：修改polaris-server.yaml里面的healthcheck配置，去掉heartbeatMemory相关配置，并放开heartbeatRedis相关配置。
  1. healthcheck:
  2.   checkers:
  3.   - name: heartbeatRedis
  4.     option:
  5.       #填入redis的IP以及端口
  6.       kvAddr: ##REDIS_ADDR##
  7.       #填入redis的密码
  8.       kvPasswd: ##REDIS_PWD##
  9.       maxIdle: 200
  10.       idleTimeout: 120s
  11.       connectTimeout: 200ms
  12.       msgTimeout: 200ms
  13.       concurrency: 200
  • 启动polaris-discover：
  1. bash ./tool/start.sh
  2. bash ./tool/p.sh
  3. 输出信息：./polaris-server start

安装prometheus

  • 下载软件包：点击下载链接集群版安装 - 图9 (opens new window)，下载prometheus版本，解压后进入prometheus-2.28.0.linux-amd64目录中。

  • 修改配置：打开 prometheus.yml文件，修改prometheus的job配置，增加http_sd_configs，其作用是告知prometheus需要从北极星获取应用的监控上报的地址。

  1.   - job_name: 'prometheus'
  2.     static_configs:
  3.     - targets: ['localhost:9090']
  5.     http_sd_configs:
  6.       - url: http://${polaris部署IP地址}:9000/prometheus/v1/clients
  8.     honor_labels: true
  • 启动prometheus：
  1. nohup ./prometheus --web.enable-lifecycle --web.enable-admin-api >> prometheus.out 2>&1 &

安装polaris-console

  • 下载软件包：下载polaris-console-release_$version.linux.$arch.zip，解压后进入polaris-console-release_$version.linux.$arch目录

  • 修改配置：打开polaris-console.yaml文件，修改monitorServer的地址，将原来的127.0.0.1:9090替换成prometheus的监听地址

  1. monitorServer:
  2.   address: "${prometheus部署IP地址}:9090"
  • 启动polaris-console：
  1. bash ./tool/start.sh
  2. bash ./tool/p.sh
  3. 输出信息：./polaris-console start

部署后验证

  • 登录控制台的默认登录账户信息
  1. 用户：polaris
  2. 密码：polaris
  • 访问http://{控制台IP}:8080，可以看到登录页面，登录后可以成功看到北极星服务治理控制台内容。

安装问题

MySQL 版本支持

  • 开源MySQL版本支持：当前仅支持 >= 5.7，低版本暂未支持。
  • 云厂商MySQL支持
    • 腾讯云：支持 Tencent MySQL版，暂不支持 TDSQL-C MySQL兼容
    • 阿里云：支持云数据库RDS MySQL 版