在CentOS7上按官方文档安装apisix-docker碰到一些问题，为了针对其FAQ中的常见问题针对HDGET做一些修复，特Clone了一个分支并详细描述安装步骤如下：

1. 先移除旧版本docker并安装新版本docker（否则会下载不了docker image)

   yum remove docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine
   yum install -y yum-utils
   yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
   yum install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

2. 安装

   git clone https://github.com/hdget/hd-apisix
   cd hd-apisix

3. 观测数据配置

   • apisix中的metric数据expose到9091端口，这里ip必须设置为0.0.0.0, 因为prometheus需要从apisix服务的9091端口中获取metrics数据

     plugin_attr:
     prometheus:
     export_addr:
       ip: 0.0.0.0
       port: 9091

   • 开启apisix的Service中的prometheus插件, 设置"prefer_name"为"true", 这样在指标数据中会使用Route/Service的名字而不是ID

4. 蓝绿发布，开启traffic_split, 替换[VAR]为myvar, [COMPARE_VALUE]为myvalue， 注意事项：

   • 注意这里MARKDOWN_HASHb63119da730344b345cdc8f62a4711e9MARKDOWNHASH中的变量如果以"http"作为前缀，那么就会引用http请求头里面的变量，实际请求中在请求头里面用VAR值就好，e,g:

     curl /path/to/url -i -H "myvar: myvalue"

   • 注意这里vars中的变量如果以arg_作为前缀，那么就参考URL请求参数里面的变量；如果用http_作为前缀，则使用http header里面的VAR值，e,g:

     curl /path/to/url?myvar=myvalue -i

   • 如果upstream_id很大的话，要用双引号包括起来

   • 只能指定上游(upstream，不能指定服务(service)

   • 在服务中开启该插件不起作用，需要在路由中开启

     {
         "traffic-split":{
             "rules":[
                 {
                     "match":[
                         {
                             "vars":[
                                 [
                                     "http_【VAR】",
                                     "==",
                                     "【COMPARE_VALUE】"
                                 ]
                             ]
                         }
                     ],
                     "weighted_upstreams":[
                         {
                             "upstream_id":"【UPSTREAM_ID】"
                         }
                     ]
                 }
             ]
         }
     }

5. 访问dashboard

   • 需要建立ssh隧道做local port forwarding, 将本地的9000端口(apisix-dashboard)转发到ssh登录服务器的9000端口
   • 需要建立ssh隧道做local port forwarding, 将本地的3000端口（grafana)转发到ssh登录服务器的3000端口