C++ runtime sample

函数计算已经发布了custom runtime, 支持用户进行各种自定义的高阶操作：

• 可以随心所欲持定制个性化语言执行环境（例如 C++、golang、lua、ruby）以及各种语言的小版本（例如python3.7、Nodejs12)等，打造属于自己的自定义runtime。
• 您现有的 web 应用或基于传统开发 web 项目基本不用做任何改造，即可将项目一键迁移到函数计算来。
• 自定义环境定制步骤简单，更有官方工程师协助您定制完美环境。

本文演示如何利用函数计算的自定义Runtime功能来运行C++代码。

fc-cpp-runtime example github

快速演示: 创建C++的FC函数

1) cd /path/for/cpp_runtime  (这里/path/for/cpp_runtime是指您想要保存cpp runtime代码的目录)
2) git clone https://github.com/awesome-fc/fc-cpp-runtime.git
3) 打开fc fun中包含的自定Runtime的Image，并指定--entrypoint sh -v:/path/for/cpp_runtime:/code

#get-apt install cmake
#cd /code
#./build.sh
#exit

注意，这里必须要用fc fun中包含的Image编译，这样才能保证和线上的环境完全一致。
4) cd bin
5) zip -r code.zip *
至此我们制作了一个基于C++的代码包, 然后可以用fcli来创建该代码包的函数:

./fcli function create --code-file code.zip -f cpp_demo -s  -t custom -h "does not matter in this case"。

6) 去控制台访问该函数，如截图所示。

编写Handler

上面的演示中我们直接用了Sample中的EchoHandler，下面简单说明它是如何工作的。
在register_handler.cpp中，有下面这段代码:

void SetInvokeAndInitHander()
{
    CustomRuntimeHandler::normalHandler = new EchoHandler();
    CustomRuntimeHandler::httpHandler = new EchoHttpHandler();
}

这里它把EchoHandler()注册为normal invoke的handler，而把EchoHttpHander()注册为http handler，正因为上述代码硬绑定了要运行的Handler，因此在创建FC 函数时的handler是任意填写的，事实上它在这里不起任何作用。 

另外值得注意的是register_handler.cpp中还包括了entrypoint.h 该文件包含了C++的main函数，并且在启动时调用了SetInvokeAndInitHandler().

要添加自己的Handler，只需要添加如下代码，并实现OnInvoke以及OnInitialize。

class MyHandler : public FcBaseHandler
{
public:
   void OnInvoke(const std::string& payload, const FcContext& context, std::string& response) override; 
   void OnInitialize(const FcContext& context) override;
};

然后修改register_handler.cpp即可。

void SetInvokeAndInitHander()
{
    CustomRuntimeHandler::normalHandler = new MyHandler();
}

编写http invoke handler

添加自己的HttpHandler， 只需要添加如下代码，并实现OnInvoke以及OnInitialize。fc-cpp-runtime依赖Pistache（https://github.com/oktal/pistache）实现REST API.

class MyHttpHandler : public FcHttpBaseHandler
{
public:
   void OnInvoke(const FcContext& context, const Pistache::Http::Request& req,
            Pistache::Http::ResponseWriter& response) override; 
   void OnInitialize(const FcContext& context) override;
};

同样需要修改SetInvokeAndInitHander().
CustomRuntimeHandler::httpHandler = new MyHttpHandler();

小结

以上展示了如何利用函数计算的Custom Runtime创建和运行一个C++的函数以及如何基于fc-cpp-runtime的示例创建自己的Handler。