单机版安装

北极星单机版仅供体验或者开发测试环境使用。生产环境请安装集群版


安装说明

北极星单机版包含以下4个组件:

  • polaris-console:可视化控制台,提供服务治理管控页面
  • polaris-server:控制面,提供数据面组件及控制台所需的后台接口
  • prometheus:服务治理监控所需的指标汇聚统计组件
  • pushgateway:prometheus推送网关,支持数据面通过推送方式上报监控数据到prometheus

北极星单机版默认占用以下端口:

  • polaris-console:8080(http/tcp)
  • polaris-server:8090(http/tcp,注册中心端口)、8091(grpc/tcp,注册中心端口)、8093(grpc/tcp,配置中心端口)
  • prometheus:9090(tcp)
  • pushgateway:9091(tcp)

单机版组网

单机版北极星,所有的组件都安装在用户机器上,作为多个独立进程提供服务。

控制台

安装服务端

环境准备

北极星单机版支持以下4种运行环境:

  • Linux(64位)
  • Windows(64位)
  • Mac(64位)
  • 容器化

单机版软件包

单机版的安装需要依赖单机版软件包,单机版软件包的命名格式为polaris-standalone-release_*.zip

单机版

下载地址

执行所有安装之前,需要下载软件包,可以从以下2个地址下载单机版软件包,请选择最新的release版本:

如果有需要自定义单机版相关组件的监听端口,在解压对应的单机版本压缩包后,修改压缩包内的port.properties文件后,执行安装脚本即可

port.properties 文件概览

  1. polaris_eureka_port=8761
  2. polaris_open_api_port=8090
  3. polaris_service_grpc_port=8091
  4. polaris_config_grpc_port=8093
  5. polaris_prometheus_sd_port=9000
  6. polaris_xdsv3_port=15010
  7. polaris_console_port=8080
  8. prometheus_port=9090

Linux

下载Linux单机版软件包(polaris-standalone-release_$version.linux.$arch.zip),执行安装命令:

  1. unzip polaris-standalone-release_$version.linux.$arch.zip
  2. cd polaris-standalone-release_$version.linux.$arch
  3. bash install.sh

Windows

注意事项:

  • 依赖powershell 5.0及以上版本(Windows 10及以上版本默认安装)
  • 需要以管理员身份运行安装脚本,执行powershell需要进行授权操作
  • 安装脚本可能遭到系统安全软件的误杀,请在安全软件中执行信任操作

下载Windows单机版软件包(polaris-standalone-release_$version.windows.$arch.zip),执行安装命令:

  1. 执行解压:polaris-standalone-release_$version.windows.$arch.zip
  2. 进入目录:polaris-standalone-release_$version.windows.$arch
  3. 执行脚本:install.bat

Mac

注意事项:

  • 请在【关于本机】设置中查看Mac机器的芯片类型(Intel/Apple)
  • Intel芯片请使用amd64的软件包,Apple芯片请使用arm64的软件包

下载Mac单机版软件包(polaris-standalone-release_$version.darwin.$arch.zip),执行安装命令:

  1. unzip polaris-standalone-release_$version.darwin.$arch.zip
  2. cd polaris-standalone-release_$version.darwin.$arch
  3. bash install.sh

Docker 安装

执行一下命令即可

  1. # Publish all exposed ports to random ports
  2. docker run -d --publish-all polarismesh/polaris-server-standalone:latest
  3. # Publish a container's port(s) to the host
  4. docker run -d -p 15010:15010 -p 8080:8080 -p 8090:8090 -p 8091:8091 -p 8093:8093 -p 8761:8761 -p 9000:9000 -p 9090:9090 polarismesh/polaris-server-standalone:latest

docker 暴露的端口列表

  1. EXPOSE 15010 8080 8090 8091 8093 8761 9000 9090

Kubernetes 安装

注意事项:

  • 部署配置使用的是LoadBalancer类型的Service。如果您需要从k8s集群外访问北极星,且您的k8s集群不支持LoadBalancer,可以修改installk8s/02-polaris-server.yamlinstallk8s/polaris-prometheus.yaml中Service的类型,调整为NodePort。如果您的集群支持Ingress,也可以通过Ingress从集群外访问。

下载k8s部署文件(polaris-standalone-release_$version.kubernetes.zip),将文件拷贝到配置了kubectl的机器上,执行安装命令:

  1. unzip polaris-standalone-release_$version.kubernetes.zip
  2. kubectl create -f polaris-standalone-release_$version.kubernetes/

部署配置介绍:

  • 00-polaris-console-config.yaml:创建名为polaris-console-config的Configmap,polaris-console组件的配置文件。
  • 01-polaris-server-config.yaml:创建名为polaris-server-config的Configmap,polaris-server组件的配置文件。
  • 02-polaris-server.yaml:创建名为polaris的StatefulSet ,其中包含了两个容器,分别是polaris-server的容器和polaris-console的容器。也创建了名为polaris的Service,暴露了8080 、8090和8091端口,其中8080为控制台提供web服务,8090提供北极星控制面的http服务,8091提供北极星控制面的grpc服务。
  • 03-prometheus.yaml:创建名为polaris-prometheus的Deployment,其中包含了两个容器,分别是prometheus和pushgateway。也创建了名为polaris-prometheus的Service,暴露了9090和9091端口,其中9090为prometheus请求端口,9091为pushgateway的请求端口。

安装验证

打开控制台

在浏览器里输入北极星控制台地址(127.0.0.1:8080),非容器化场景127.0.0.1可替换成安装北极星的机器host。

  • 登录控制台的默认登录账户信息
  1. 用户:polaris
  2. 密码:polaris

容器化场景,您需要通过北极星创建的名为polaris的Service来访问控制台,根据您采用的网络方案,有以下几种情况:

  • 如果您的k8s集群支持LoadBalancer的Service,并且您直接使用北极星提供的yaml部署,您需要使用polaris Service的EXTERNAL-IP:8080来访问。
  • 如果您修改了北极星提供的yaml,使用的是NodePort的Service,您需要使用集群Node的host和polaris Service中8080对应的NodePort来访问。
  • 如果您的k8s集群支持Ingress,您需要配置Ingress的backend的serviceName为polaris,并选择servicePort为8080。配置正常后,您可以通过您设置的域名访问。

控制台

新建服务

进入服务列表页面,点击【新建】按钮,确认是否可以新建服务。新建服务成功表示安装成功

新建服务