ngxtpl

ngxtpl

golang nginx template.

1. build: make install
2. create a demo config file ngxtpl --demo.
3. for http get/post mocking go get github.com/bingoohuang/httplive/..., httplive -d testdata/httplive.db

启动时，向 nacos 注册自己

1. 在配置文件 ngxtpl.hcl 中添加 nacos 配置，参考 demo

   nacos {
     configFile = "/some/path/nacos.yaml"
   }
   

2. 创建 nacos 配置文件 /some/path/nacos.yaml，示例 demo

支持 redis-cluster

redis {
  addr = "localhost:6379" # 多个地址以逗号分隔
  password = ""
  cluster = true # 支持 redis-cluster 的开关
  db = 0
  # servicesKey = "services"
  servicesKey = "__gateway_redis__ upstreams"
  # 如果是hash的，servicesKey = "hashKey field"
  resultKey = "__gateway_redis__ upstreams_result"
}

redis

1. edit the created demo.hcl config file, see demo redis confi, demo redis config for set_real_ip_from
2. put some data into redis.
   • redis-cli -x hset __gateway_redis__ upstreams < testdata/upstreams.json
   • redis-cli -x set upstreams < testdata/upstreams.json
   • redis-cli -x set realIps < testdata/set_real_ip_from.json
3. run ngxtpl -c demo.hcl, or ngxtpl -c demo.hcl -c demo_realIps.hcl

mysql

1. start MySQL docker run -d --name mysql -e MYSQL_USER=user -e MYSQL_DATABASE=mydb -e MYSQL_PASSWORD=pass -e MYSQL_ROOT_PASSWORD=root -p 33306:3306 mysql:5.7
2. prepare tables MYSQL_PWD=root mysql -h hostname -P 33306 -u user mydb < testdata/mysql.sql
3. prepare config file, see demo mysql config

nacos

详见

reference

1. slides HCL: A human-friendly language for developers and operators

docker-compose testing env

redis install

1. docker pull redis:6.0.10-alpine3.13
2. https://phoenixnap.com/kb/docker-redis https://hub.docker.com/_/redis
3. docker run --name redis -p 6379:6379 -d redis:6.0.10-alpine3.13 docker exec -it redis redis-cli
4. Another Redis DeskTop Manager

openresty install

1. https://hub.docker.com/r/openresty/openresty
2. docker pull openresty/openresty:1.19.3.1-2-alpine
3. docker run --name openresty -v $PWD/testdata/nginx:/etc/nginx/conf.d -p 8080:8080 -p 8081:8081 -p 8082:8082 -p 8083:8083 -d openresty/openresty:1.19.3.1-2-alpine

$ docker-compose exec openresty sh
/ # ps -ef|grep nginx
    1 root      0:00 {openresty} nginx: master process /usr/local/openresty/bin/openresty -g daemon off;
    7 nobody    0:00 {openresty} nginx: worker process
   15 root      0:00 grep nginx
/ # /usr/local/openresty/bin/openresty -t
nginx: the configuration file /usr/local/openresty/nginx/conf/nginx.conf syntax is ok
nginx: configuration file /usr/local/openresty/nginx/conf/nginx.conf test is successful
/ # /usr/local/openresty/bin/openresty -s reload
2021/02/07 09:47:47 [notice] 17#17: signal process started
/ # echo $?
0
/ # 

ngxtpl install

1. docker build -f Dockerfile -t openresty/ngxtpl .

docker compose

1. docker-compose up
2. set tpl (demo) and services(demo) in redis by docker.hcl config.
3. change services data in redis and run curl to check results:

🕙[ 00:13:06 ] ❯ for n in {1..8}; do curl 127.0.0.1:8090/service1/abc;print; done
8081 welcome you!
{"status":"success","result":"8082 nginx json"}
8083 welcome you!
8084 welcome you!
8081 welcome you!
{"status":"success","result":"8082 nginx json"}
8083 welcome you!
8084 welcome you!

daemon service on linux

/app/ngxtpl install -c /etc/app/docker.hcl; /app/ngxtpl start