安装分布式限流服务

安装说明

北极星分布式限流服务端包含以下1个组件：

  • polaris-limiter：北极星的分布式限流服务端，主要用于全局token的缓存及分配。

北极星分布式限流服务端默认占用以下端口：

  • polaris-limiter：8100(http/tcp, 分布式限流服务端HTTP协议端口)、8101(grpc/tcp，分布式限流服务端gRPC协议端口)

安装服务端

环境准备

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

  • Linux（64位）
  • Windows（64位）
  • Mac（64位）
  • 容器化

软件包

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

分布式限流服务端

下载地址

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

虚拟机安装

这里已 Linux 为例

下载安装包并解压

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

  1. unzip polaris-limiter-release_$version.linux.$arch.zip
  3. cd polaris-limiter-release_$version.linux.$arch

修改 polaris-limiter.yaml

进入到目录 polaris-limiter-release_$version.linux.$arch

  1. registry:
  2.   enable: true
  3.   polaris-server-address: { 北极星服务端 grpc 协议地址 }
  4.   name: polaris.limiter
  5.   namespace: Polaris
  6.   health-check-enable: true
  7. api-servers:
  8.   - name: http
  9.     option:
  10.       ip: 0.0.0.0
  11.       port: 8100
  12.   - name: grpc
  13.     option:
  14.       ip: 0.0.0.0
  15.       port: 8101
  16. limit:
  17.   myid: { 服务端节点唯一标识信息，int 类型}

注意事项

  • 如果是部署单节点的 polaris-limiter，myid 设置为 1 即可
  • 如果是部署多节点的 polaris-limiter，每个节点的 myid 必须保证唯一

启动服务端

  1. cd polaris-limiter-release_$version.linux.$arch
  3. bash ./tool/start.sh

注意事项

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

Kubernetes 安装

下载安装包并解压

下载 kubernetes 软件包（polaris-limiter-release_$version.kubernetes.$arch.zip）：

  1. unzip polaris-limiter-release_$version.kubernetes.$arch.zip
  3. cd polaris-limiter-release_$version.kubernetes.$arch

修改 ConfigMap

进入到目录 polaris-limiter-release_$version.linux.$arch，修改 0-polaris-limiter-configmap.yaml

  1. apiVersion: v1
  2. kind: ConfigMap
  3. metadata:
  4.   name: polaris-limiter-config
  5.   namespace: polaris-system
  6. data:
  7.   polaris-limiter.yaml: |-
  8.     registry:
  9.       enable: true
  10.       polaris-server-address: { 北极星服务端 grpc 协议地址 }
  11.       name: polaris.limiter
  12.       namespace: Polaris
  13.       health-check-enable: true

安装

  1. cd polaris-limiter-release_$version.kubernetes.$arch
  3. kubectl apply -f ./

安装验证

执行以下命令，查看 polaris.limiter 服务下的实例信息

  1. curl --location --request POST '127.0.0.1:8090/v1/Discover' \
  2. --header 'Content-Type: application/json' \
  3. --data-raw '{
  4.     "type": 1,
  5.     "service": {
  6.         "name": "polaris.limiter",
  7.         "namespace": "Polaris"
  8.     }
  9. }'