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

说明

北极星单机版包含以下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版本：

​​Github下载​​​ ​​Gitee下载​​

Linux

下载Linux单机版软件包（​​polaris-standalone-release_$version.linux.$arch.zip​​），执行安装命令：

unzip polaris-standalone-release_$version.linux.$arch.zip

cd polaris-standalone-release_$version.linux.$arch

bash install.sh

Windows

注意事项：

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

下载Windows单机版软件包（polaris-standalone-release_$version.windows.$arch.zip），执行安装命令：

执行解压：polaris-standalone-release_$version.windows.$arch.zip

进入目录：polaris-standalone-release_$version.windows.$arch

执行脚本：install.bat

Mac

注意事项：

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

下载Mac单机版软件包（​​polaris-standalone-release_$version.darwin.$arch.zip​​），执行安装命令：

unzip polaris-standalone-release_$version.darwin.$arch.zip

cd polaris-standalone-release_$version.darwin.$arch

bash install.sh

容器化

注意事项：

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

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

unzip polaris-standalone-release_$version.kubernetes.zip

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。

• 登录控制台的默认登录账户信息

用户：polaris
密码：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​​。配置正常后，您可以通过您设置的域名访问。

新建服务

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