Merge pull request #1 from chuntaojun/main

first commit and init polaris-lua

Author: andrewshan

.gitignore

@@ -0,0 +1,6 @@
+*.tar.gz
+a.out
+*.o
+*.so
+third_party/polaris_cpp_sdk/slib/*.a
+third_party/polaris_cpp_sdk/dlib/*.so

Makefile

@@ -0,0 +1,20 @@
+CC=gcc
+
+INC= -I./third_party/polaris_cpp_sdk/include \
+	-I./third_party/lua/include
+LIB=-L./third_party/polaris_cpp_sdk/slib -lpolaris_api -lprotobuf -lm -lstdc++ -L./third_party/lua/lib/ -llua
+
+CFLAGS= -g -Wall -fPIC
+TARGET=./polariswrapper.so
+
+OBJ+=./polaris_sdk_lua_wrapper.o
+
+$(TARGET):$(OBJ)
+	$(CC) $(CFLAGS) -o $@ $^ $(LIB) -shared -pthread -lz -lrt
+
+%.o: %.c
+	$(CC) $(CFLAGS) $(INC) -c -o $@ $<
+
+clean:
+	rm -f $(OBJ)
+	rm -f $(TARGET)

README-zh.md

@@ -0,0 +1,46 @@
+# Polaris Lua
+
+[English Document](./README.md)
+
+## 1. 项目介绍
+
+本项目在北极星已有的C++ sdk [polaris-cpp](https://github.com/polarismesh/polaris-cpp) 项目的基础上，实现了北极星服务发现的lua层封装，可集成到OpenResty等使用Lua脚本的系统中使用。
+
+## 2. 快速上手
+
+### 2.1 目录结构
+```
+.
+├── lua                                     // lua的 C 静态库，头文件
+│   ├── include
+│   └── lib
+│
+`-- third_party
+    `-- polaris_cpp_sdk                         // 编译生成的 polaris-cpp 静态库 & 动态库，头文件，需要自行编译
+│
+├── polaris_sdk_lua_wrapper.c               // 供 lua 使用的 C API 封装以及入口函数
+├── polaris.lua                             // lua 层的北极星服务发现模块封装
+├── test                                    // 测试用例
+│   └── test_polaris_sdk_lua_wrapper.lua
+│
+├── pre_build.sh                            // 编译前执行，识别当前系统环境，链接合适的北极星sdk库
+├── Makefile                                // Makefile 文件
+└── README.md                               // 说明文档
+```
+
+### 2.2 使用方法
+
+1. 拉取北极星c++ sdk的最新代码，`git clone https://github.com/polarismesh/polaris-cpp`
+2. 编译`polaris-cpp`及打包
+    ```
+    # 编译
+    make
+    # 测试
+    make test
+    # 打包，可添加参数package_name指定打包名，默认polaris_cpp_sdk
+    make package # package_name=polaris_cpp_sdk
+    ```
+3. 将`polaris-cpp`编译出来的产物`polaris_cpp_sdk`拷贝到本项目下的`third_party/polaris_cpp_sdk`
+4. 执行 `bash pre_build.sh`
+5. 执行 `make` 生成 `polariswrapper.so`
+6. 将`polariswrapper.so`，`polaris.lua` 文件上传到 OpenResty 项目的合适路径，编写自己的业务 lua 文件使用，业务lua的编写示例可参考测试用例 `test_polaris_sdk_lua_wrapper.lua`

README.md

@@ -1,2 +1,40 @@
-# polaris-lua
-polaris sdk for lua language
+# Polaris Lua
+
+[中文文档](./README-zh.md)
+
+## 1. Project Introduction 
+
+Based on the existing C++ sdk [polaris-cpp](https://github.com/polarismesh/polaris-cpp)  project of Polaris, this project implements the Lua layer encapsulation of Polaris service discovery, which can be integrated into OpenResty and other systems that use Lua scripts. 
+## 2. Get started quickly 
+### 2.1 Directory Structure 
+```
+.
+├── lua                                     // Lua C static library, header file 
+│   ├── include
+│   └── lib
+│
+`-- third_party
+    `-- polaris_cpp_sdk                         // Compile the generated polaris-cpp static library & dynamic library, header file, you need to compile it yourself 
+│
+├── polaris_sdk_lua_wrapper.c               // C API wrapper and entry function for lua 
+├── polaris.lua                             // Polaris service discovery module package at the lua layer 
+├── test                                    // Test case 
+│   └── test_polaris_sdk_lua_wrapper.lua
+│
+├── pre_build.sh                            // Execute before compiling, identify the current system environment, link the appropriate Polaris SDK library 
+```
+
+### 2.2 Instructions
+
+1. Pull the latest code of Polaris c++ sdk, `git clone https://github.com/polarismesh/polaris-cpp`
+2. Compile `polaris-cpp` and package 
+    ```
+    make
+    make test
+    make package # package_name=polaris_cpp_sdk
+    ```
+3. Copy the product `polaris_cpp_sdk` compiled by `polaris-cpp` to `third_party/polaris_cpp_sdk` under this project 
+4. Execute `bash pre_build.sh` 
+5. Execute `make` to generate `polariswrapper.so` 
+6. 将`polariswrapper.so`，`polaris.lua` 文件上传到 OpenResty 项目的合适路径，编写自己的业务 lua 文件使用，业务lua的编写示例可参考测试用例 `test_polaris_sdk_lua_wrapper.lua`
+

polaris.lua

@@ -0,0 +1,55 @@
+--[[
+    Author: andymatthu#tencent.com
+    Create date: 2020/06/11
+    Update date: 2020/11/04
+    Desc: 北极星sdk lua层封装
+]]
+
+local _M = {}
+
+local polariswrapper = require "polariswrapper"
+
+-- 显式初始化polaris_api(单进程只会初始化一次)
+-- 注：需要指定polaris.yaml时需调用，否则可以直接调用get_server_host_port，包含了隐式初始化polaris_api
+function _M.polaris_api_init(config_file)
+    local result, msg
+    if config_file ~= "" then
+        result, msg = polariswrapper.polaris_api_init(config_file)
+    else
+        result, msg = polariswrapper.polaris_api_init()
+    end
+
+    return result, msg
+end
+
+-- 设置北极星服务日志路径
+function _M.polaris_log_settings(log_dir, log_level)
+    polariswrapper.polaris_log_settings(log_dir, log_level)
+end
+
+
+-- 通过北极星获取服务ip和端口
+function _M.get_server_host_port(service_namespace, service_name)
+    -- 查询host port
+    local result, msg, host, port, instance_id, if_reuse = polariswrapper.polaris_get_one_node(service_namespace, service_name)
+    if result ~= 0 then
+        ngx.log(ngx.ERR, "polaris_get_one_node failed, result:"..result..", msg:"..msg)
+        return result, msg
+    end
+    ngx.log(ngx.INFO, "polaris_api if_reuse:"..if_reuse)
+
+    return 0, "ok", {host=host, port=port, instance_id=instance_id}
+end
+
+-- 上报北极星调用结果
+function _M.call_report(service_namespace, service_name, instance_id, result)
+    local result, msg = polariswrapper.polaris_service_call_report(service_namespace, service_name, instance_id, result)
+    if result ~= 0 then
+        ngx.log(ngx.ERR, "polaris_service_call_report failed, result:"..result..", msg:"..msg)
+        return result, msg
+    end
+
+    return 0, "ok"
+end
+
+return _M