Custom Runtime简介

背景信息

当您打算使用某种语言打造Custom Runtime，但是该语言不是Custom Runtime的内置语言，您需要将该语言的解析器或运行时和代码文件一起打包部署到函数计算，来实现您的预期目标。例如当运行环境是Node.js 16时，您需要先下载Node.js 16所需的解释器到代码中，然后再将打包后的代码部署到函数计算。

关于Custom Runtime的内置软件，请参见详细信息。

容器环境

基本原理

Custom Runtime本质上是自定义运行时，您只需创建一个启动目标服务（默认端口为9000的HTTP Server）的可执行文件bootstrap，然后将该文件和您的代码文件一起打成ZIP包，最后以该ZIP包作为代码包创建一个Custom Runtime的函数。该运行时可包含在函数的部署程序包内。

例如函数的程序包名称为function.zip，该运行时各个语言程序包内的文件形式和相应bootstrap文件内容如下：

.
├── bootstrap
├── demo.jar

#!/usr/bin/env bash
java -jar demo.jar	

.
├── bootstrap
├── server.py

#!/bin/bash
python server.py

.
├── bootstrap
├── server.js

#!/bin/bash
node server.js

.
├── bootstrap
├── server.php

#!/bin/bash
php server.php

函数计算冷启动Custom Runtime时，会默认调用bootstrap文件启动您自定义的HTTP Server。然后这个HTTP Server接管了函数计算系统的所有请求，包括来自您的事件函数调用及HTTP函数调用。

您在开发函数具体的逻辑之前，一般会确认开发的函数是事件函数还是HTTP函数，原理如下所示：

• 事件函数
• HTTP函数

HTTP Server配置要求

创建HTTP Server时您需要满足以下要求：

• Custom Runtime启动的服务一定要监听0.0.0.0:CAPort或*:CAPort端口。如果您使用127.0.0.1:CAPort端口，会导致请求超时，出现以下错误：

  {
    "ErrorCode":"FunctionNotStarted",
    "ErrorMessage":"The CA's http server cannot be started:ContainerStartDuration:25000000000. Ping CA failed due to: dial tcp 21.0.5.7:9000: getsockopt: connection refused Logs : 2019-11-29T09:53:30.859837462Z Listening on port 9000"
  }

  Custom Runtime的监听端口（CAPort） 默认是9000。如果Custom Runtime使用默认的监听端口，那么您实现的Custom Runtime的HTTP Server监听的端口也必须是9000。 如果Custom Runtime使用的监听端口是8080，那么您实现的Custom Runtime的HTTP Server监听的端口也必须是8080。

• Custom Runtime的bootstrap文件，如果是Shell脚本一定要添加#!/bin/bash，否则会出现以下错误：

  {
    "ErrorCode":"CAExited",
      "ErrorMessage":"The CA process either cannot be started or exited:ContainerStartDuration:25037266905. CA process cannot be started or exited already: rpc error: code = 106 desc = ContainerStartDuration:25000000000. Ping CA failed due to: dial tcp 21.0.7.2:9000: i/o timeout Logs : 2019-11-29T07:27:50.759658265Z panic: standard_init_linux.go:178: exec user process caused \"exec format error\"     
  }                

  如果是二进制可执行文件，例如Go、C++直接编译出来的目标二进制文件，则不需要添加#!/bin/bash。

• Custom Runtime的bootstrap文件，一定要具备可执行权限，否则会出现以下错误：

  {
    "ErrorCode":"CAFilePermission",
      "ErrorMessage":"The CA process cannot be started due to bootstrap file don't have execute permissions
  }  

  您可以通过以下方式解决该问题：

  • 在打包文件前执行chmod +x bootstrap或chmod 755 bootstrap命令。
  • 如果您使用的是Windows操作系统，您需要将bootstrap文件格式修改为UNIX格式。
• Connection需要设置为Keep-Alive，Server端请求超时时间需设置在15分钟及以上。示例如下：

  //例如Node.js使用express时。  
  
  var server = app.listen(PORT, HOST);
  server.timeout = 0; // never timeout
  server.keepAliveTimeout = 0; // keepalive, never timeout

• HTTP Server需要在120秒内启动完毕。

函数计算公共请求头

Custom Runtime从函数计算系统中接收到的公共请求头如下表所示。如果您需要访问阿里云其他服务，您可能需要用到临时AccessKey的Headers。如果您需要迁移已有的应用，可忽略下文的内容。

函数日志格式

推荐您在创建服务时使用日志服务SLS，Custom Runtime中所有打印到标准输出（Stdout）的日志会被自动收集到您指定的日志服务中。具体步骤，请参见配置日志。

函数计算系统在其他运行环境（除Custom Runtime及Custom Container外）中调用函数时，请求头中包含x-fc-log-type" = "Tail"，那么返回的响应头包含x-fc-log-result的内容就是函数执行时打印的日志，日志大小最大为4 KB。您可以在函数计算控制台函数执行结果中查看该日志。如果您希望在控制台的执行结果中看到Custom Runtime的运行日志，您需要在代码中记录请求开始和结束日志。

更多信息

Custom Runtime的限制信息，请参见资源使用限制。