第一次Python创建grpc微服务

自己动手，丰衣足食。摸了两天终于把一个简单的grpc服务，封装为一个docker镜像，在容器中运行，并且可以被外部调用。

这篇文章主要用来记录流程，参考的相关文章在文后一起贴出来。

首先，我之前写了一个hashids_en_de.py的脚本，工作中总会用它转来转去，代码也不多，于是就是他了。话不多说，上代码。

    # !/usr/bin/env python
    # -*- coding=utf-8 -*-
    __author__ = 'Lrish'

   from hashids import Hashids
   from exceptions import IOError

   def hash_ids(_id, func='encode'):
        hashids = Hashids(salt='123456', min_length=5)
        if func is 'encode':
            return hashids.encrypt(_id)
        elif func is 'decode':
            decode_str, = hashids.decrypt(_id)
            return decode_str
        else:
            raise IOError('1001', 'you need input a valid value!')

     print type(hash_ids('MNZYjm', func='decode'))

     print hash_ids(2458)

然后，配置安装grpc和grpcio-tools，这里不详表。
根据上面的脚本定义proto文件两个入参，三个出参

    syntax = "proto3";
    package proto;
    service HashIdsService{
       rpc Hash(HashIdsRequest) returns(HashIdsResponse);

    }
    message HashIdsRequest{
        string id=1;
        string func=2;
    }
    message HashIdsResponse{
        int32 code=1;
        string error_msg=2;
        string hash_ids=3;
    }


    //python -m grpc_tools.protoc -I../proto/ --python_out=. --grpc_python_out=. ../proto/hash_ids.proto

执行proto中最后一行在当前路径生成hash_ids_pb2.py和hash_ids_pb2_grpc.py

接下来是grpc服务端代码hash_ids_server.py

    # !/usr/bin/env python
    # -*- coding=utf-8 -*-
    __author__ = 'Lrish'
    
    
    from concurrent import futures
    import time
    from hashids import Hashids
    from exceptions import IOError
    
    import grpc
    
    import hash_ids_pb2
    import hash_ids_pb2_grpc
    
    _ONE_DAY_IN_SECONDS = 60 * 60 * 24
    
    
    class HashIds(hash_ids_pb2_grpc.HashIdsServiceServicer):
    
        def Hash(self, request, context):
    
            return hash_ids_pb2.HashIdsResponse(code=0, hash_ids=hash_ids(request.id, request.func), error_msg='')
    
    
    def hash_ids(_id, _func='encode'):
        hashids = Hashids(salt='123456', min_length=5)
        # _id = _id.encode("utf-8")
        if _func == 'encode':
            print hashids.encrypt(int(_id))
            return hashids.encrypt(int(_id))
        elif _func == 'decode':
            decode_str, = hashids.decrypt(_id)
            return unicode(decode_str)
        else:
            error_msg = IOError('1001', 'you need input a valid value!')
            return error_msg
    
    
    def serve():
        server = grpc.server(futures.ThreadPoolExecutor(max_workers=10))
        hash_ids_pb2_grpc.add_HashIdsServiceServicer_to_server(HashIds(), server)
        server.add_insecure_port('0.0.0.0:50051')
        server.start()
        try:
            while True:
                time.sleep(_ONE_DAY_IN_SECONDS)
        except KeyboardInterrupt:
            server.stop(0)
    
    if __name__ == '__main__':
        serve()

然后是grpc的客户端代码hash_ids_client.py

    # !/usr/bin/env python
    # -*- coding=utf-8 -*-
    __author__ = 'Lrish'
    
    import grpc
    import hash_ids_pb2_grpc
    import hash_ids_pb2
    
    
    # 建立grpc桩
    def grpc_host(host, port):
        url = host + ":" + port
        channel = grpc.insecure_channel(url)
        stub = hash_ids_pb2_grpc.HashIdsServiceStub(channel)
        return stub
    
    
    # 调用搜索提示服务
    def _hash(stub, _id, _func=None):
        response = stub.Hash(hash_ids_pb2.HashIdsRequest(id=_id, func=_func))
        print "Code: %s" % unicode(response.code)
        print response
    
    
    s = grpc_host('192.168.0.1', '50051')
    _hash(s, "2458", "encode")

代码搞定，接下来就是打docker images
后面会分享一波配置Dockerfile文章的链接，接下来贴出Dockerfile

    FROM       docker.io/alpine:latest
    MAINTAINER tools_hash_ids
    
    ENV TZ "Asia/Shanghai"
    
    RUN echo "https://mirrors.aliyun.com/alpine/v3.6/main" > /etc/apk/repositories
    
    RUN apk add --update \
        bash \
        python \
        python-dev \
        py-pip \
        build-base \
      && pip install grpcio \
      && pip install hashids \
      && rm -rf /var/cache/apk/*
    
    EXPOSE 50051
    
    WORKDIR /root
    
    COPY ./grpc_hash_ids /root/tools_hash_ids
    
    CMD ["python", "/root/tools_hash_ids/hash_ids_server.py"]

    # docker build . -t tools_hash_ids:20171219

    # docker run --name hash -d -p 50051:50051 tools_hash_ids:20171219

docker build 创建镜像，docker run 启动容器，成功启动容器以后就可以用client来调用咯。
贴出参考文章如下：

gRPC 官方文档中文版

grpc python quickstart

使用Dockerfile创建docker镜像

使用alpinelinux 构建python http 项目

这篇文章后续发展应该会增加grpc转换为http协议……
to be continue