ngx_http_service_module

Nginx 서비스 처리 모듈

전제 조건

• 리눅스 플랫폼
• NGINX 버전은 1.9.11 보다 낮지 않습니다
• NGINX 컴파일을위한 설치 도구

모듈 기능

• 서비스 요청/응답 메시지는 모두 json 형식입니다. cJSON 라이브러리는 기본적으로 컴파일됩니다. 비즈니스 개발자는 패킷을 구문 분석하는 데 사용할 수 있으며 물론 다른 json 구문 분석 라이브러리를 사용할 수도 있습니다 ( example/third_test 섹션 참조).
• 특정 인터페이스를 구현하여 서비스를 동적 라이브러리로 컴파일하고 Nginx에로드하십시오.

이점

• Nginx의 다중 프로세스 모델을 사용하여 비즈니스를 처리하고 비즈니스 개발자는 특정 시나리오에 따라 구현 된 인터페이스에서 멀티 스레딩을 사용하여 성능을 향상시키고로드 밸런싱을 통해 수평으로 확장 할 수 있습니다.
• 서비스가 중단 되면 Nginx는 작업 프로세스를 다시 시작하여 비즈니스가 처리를 중단하지 않도록합니다.
• 서비스 원활한 재시작/업그레이드 서비스 . Nginx의 Smooth Restart/업그레이드 기능을 통해 서비스 재시작/업그레이드는 우아하게 다시 시작/업그레이드 할 수 있습니다.

짓다

1. Nginx 소스 코드를 다운로드하십시오

 # 这里以 nginx-1.24.0 为例, 也可以根据自己情况下载其他版本的 nginx 源码
wget http://nginx.org/download/nginx-1.24.0.tar.gz

2. Nginx 소스 코드 디렉토리를 제거하고 입력하십시오

tar -zxvf nginx-1.24.0.tar.gz
cd nginx-1.24.0

3.이 프로젝트의 코드를 당기십시오

 # 这里拉取到 nginx 源码的目录下, 也可以根据情况拉取到其他目录
git clone https://github.com/xukeawsl/ngx_http_service_module.git

4. 모듈을 nginx에 추가하고 설치하십시오

 # 如果你将项目代码放在其他路径, 则需要修改这里的模块路径
./configure --add-module=ngx_http_service_module
make
make install

구성 명령

1. Module_Path (HTTP 블록에서만 구성 할 수 있음)

• 이 명령은 동적 라이브러리가 속한 경로를 구성합니다. 구성되지 않은 경우 기본 검색 경로 검색을 설치하십시오.
• 첫 번째 매개 변수는 경로이고 동적 라이브러리 파일 이름 (전체 이름)입니다.

 module_path {
    / path/to /dir1    module1.so;
    / path/to /dir2    module2.so  module3.so;
}

2. module_dependency (HTTP 블록에서만 구성 할 수 있음)

• 이 구성은 동적 라이브러리 간의 종속성을 설정합니다
• 첫 번째 매개 변수는 종속적 인 동적 라이브러리이며 동적 라이브러리가

 module_dependency {
    module1. so     module2.so;
    module3. so     module2.so  libjsoncpp.so;
}

3. 서비스 (HTTP 블록에서만 구성 할 수 있음)

• 이 구성 설정 모듈에서 제공하는 서비스
• 첫 번째 매개 변수는 동적 라이브러리 파일 이름이며, 동적 라이브러리에 제공된 서비스 이름 (Case Sensitive)
• 서비스 이름은 전 세계적으로 독특해야합니다

 service {
    module1. so    srv_echo  srv_datetime;
    module2. so    srv_sayHello;
    module3. so    srv_getSum;
}

4. service_mode (http, 서버, 위치 블록은 모두 구성 할 수 있습니다)

• 모듈 기능을 활성화하는 데 사용되면 지원되지 않은 부품은 서비스를 위해 처리되지 않습니다.
• 기본적으로 활성화되지 않으면 다음 예제가 지정된 서버에서 전역으로 활성화되지만, 라우팅 요청 /test 처리되지 않습니다.

 http {

    server {
        sevice_mode on;

        location /test {
            service_mode off;
        }
    }
}

서비스 인터페이스 개발

• 사용자는 프로젝트에 ngx_http_service_interface.h 인터페이스 파일을 포함해야합니다.

 // 接口形如下面的函数

#include "ngx_http_service_interface.h"
#include "cJSON.h"

void srv_sayHello ( const ngx_request_t * rqst , ngx_request_t * resp )
{
    // do something...
}

• 요청/응답 구조

 // 请求结构只包含一个 const char * 指针指向 json 请求字符串
struct ngx_json_request_s {
    const char * data ;
};

// 响应结构包含一个 char * 指针指向 json 响应字符串和一个回调函数用于释放响应字符串的内存
// 因为对于 c++ 实现的服务可能使用 new 来分配内存, 那就需要指定正确的内存释放方式
struct ngx_json_response_s {
    char * data ;
    void ( * release )( void * );
};

서비스 호출 규칙

• 요청 메소드에는 POST 필요합니다
• HTTP 헤더 Service-Name 으로 호출 할 서비스를 지정하십시오.
• Content-Type 유형 json 이어야합니다
• 다음과 같이 srv_sayHello 서비스에 전화하십시오

curl -X POST " http://localhost/service_test " 
-H ' Content-Type: application/json ' 
-H ' Service-Name: srv_sayHello ' 
-d ' {"data": "xxxx"} '