simpleservice

간단한 서비스

예를 들어 컨테이너 오케스트레이션 설정을 테스트하는 데 사용할 수있는 간단하고 구성 가능한 서비스 (건강 검사 엔드 포인트 포함).

다음에 사용 된 0.4.0 과 같은 simpleservice 버전은 생성 된 각 Docker 이미지에 사용 된 태그를 나타냅니다. 이 Github Repo에는 태그 나 릴리스가 없습니다.

내용물:

• HTTP API
• 실행
• 런타임 동작 변경
• 그것을 호출합니다

HTTP API

여기에 나열된 엔드 포인트 외에도 아래의 런타임 동작 섹션 변경 사항도 참조하십시오.

/env [0.5.0+]

원칙적 응답 :

 HTTP/1.1 200 OK
$HEADER_FIELDS
 {
     "env": "$DUMP_OF_ENVIRONMENT_VARS",
     "version": "$VERSION"
 }

예제 응답 :

 HTTP/1.1 200 OK                                                                                                                                                             [5/99]
Content-Length: 2471
Content-Type: application/json
Date: Mon, 24 Apr 2017 12:38:47 GMT
Etag: "5ccb76cf1545f01fd1e0df4257ff6f8da19678e9"
Server: TornadoServer/4.3

{
    "env": "{'USER': 'mhausenblas', ...}"
    "version": "0.5.0"
}    

/info [0.5.0+]

원칙적 응답 :

 HTTP/1.1 200 OK
$HEADER_FIELDS
 {
     "from": "$REMOTE_IP",
     "host": ""$HOST:$PORT"",
     "version": "$VERSION"
 }

예제 응답 :

 HTTP/1.1 200 OK
Content-Length: 67
Content-Type: application/json
Date: Mon, 24 Apr 2017 12:36:37 GMT
Etag: "9d09b0a126f68a0fddfec0f494e56fcab29eac15"
Server: TornadoServer/4.3

{
    "from": "127.0.0.1",
    "host": "localhost:9876",
    "version": "0.5.0"
}

/health [0.4.0+]

원칙적 응답 :

 HTTP/1.1 200 OK
$HEADER_FIELDS
 {
     "healthy": true
 }

예제 응답 :

 HTTP/1.1 200 OK
Content-Length: 17
Content-Type: application/json
Date: Tue, 11 Oct 2016 17:17:21 GMT
Etag: "b40026a9bea9f5096f4ef55d3d23d6730139ff5e"
Server: TornadoServer/4.3

{
    "healthy": true
}

/endpoint0 [0.3.0+]

원칙적 응답 :

 HTTP/1.1 200 OK
$HEADER_FIELDS
{
    "host": "$HOST:$PORT",
    "result": "all is well",
    "version": "$VERSION"
}

예제 응답 :

 HTTP/1.1 200 OK
Content-Length: 71
Content-Type: application/json
Date: Tue, 11 Oct 2016 16:57:33 GMT
Etag: "ce18606c019e1d8c584b796d1fe7402d9767b9b6"
Server: TornadoServer/4.3

{
    "host": "localhost:9876",
    "result": "all is well",
    "version": "0.4.0"
}

실행

로컬 실행의 경우 Python 2.7.9 필요합니다. 그런 다음 simpleservice 그렇게 실행할 수 있습니다.

 # with defaults:
$ python simpleservice.py

# overwriting certain runtime settings:
$ HEALTH_MAX=200 VERSION=1.0 python simpleservice.py

당신이 그것을 좋아한다면, 당신은 로컬 컴퓨터에서 simpleservice 의 컨테이너화 된 버전을 실행할 수 있습니다 (Docker가 설치해야 함) :

 $ docker run -P mhausenblas/simpleservice:0.5.0

컨테이너 이미지도 참조하십시오.

런타임 동작 변경

다음 환경 변수를 설정함으로써 simpleservice 의 런타임 동작을 변경할 수 있습니다.

• PORT0 ... 포트 simpleservice 제공 중입니다
• VERSION ... /endpoint0 끝점의 JSON 응답에서 반환 된 version 값
• HEALTH_MIN 및 HEALTH_MAX ... 최소. 그리고 맥스. /health 종점이 반응하는 밀리 초의 지연

그것을 호출합니다

simpleservice 가 시작되면 그렇게 호출 할 수 있습니다 (여기에 로컬 서비스 실행이 있습니다).

 $ http localhost:9876/endpoint0
HTTP/1.1 200 OK
Content-Length: 71
Content-Type: application/json
Date: Tue, 11 Oct 2016 16:57:33 GMT
Etag: "ce18606c019e1d8c584b796d1fe7402d9767b9b6"
Server: TornadoServer/4.3

{
    "host": "localhost:9876",
    "result": "all is well",
    "version": "0.4.0"
}

서비스 로그는 다음과 같은 것을 보여줍니다.

 ~$ python simpleservice.py
This is a simple service in version v0.4.0 listening on port 9876
2016-10-11T05:57:33 INFO /endpoint0 serving from localhost:9876 has been invoked from 127.0.0.1 [at line 58]
2016-10-11T05:57:33 INFO 200 GET /endpoint0 (127.0.0.1) 1.10ms [at line 1946]

사용 가능한 엔드 포인트는이 문서의 첫 번째 섹션 (일명 API)에 정의 된 simpleservice 버전에 따라 다릅니다.