背景
最近在处理线上工单的时候,遇到一个用户使用 nodejs runtime 时因为函数计算运行环境的 gcc 版本过低导致无法运行的问题,觉得非常有意思,所以深入的帮用户寻找了解决方案。觉得这个场景应该具有一定的通用性,所以在这篇文章里面重点的介绍一下如何使用函数计算的周边工具 fun 解决因为 runtime 中系统版本导致的各种兼容性问题。
场景介绍
用户问题
简要描述一下用户当时遇到的问题:
用户使用函数计算的 nodejs8 runtime,在本地自己的开发环境使用 npm install couchbase
安装了 couchbase 这个第三方库。couchbase 封装了 C 库,依赖系统底层动态链接库 libstdc++.so.6。因为用户自己的开发环境的操作系统内核比较新,所以本地安装、编译和调试都比较顺利。所以,最后按照函数计算的打包方式成功创建了 Function,但是执行 InvokeFunction 时,遇到了这样的错误:
"errorMessage": "/usr/lib/x86_64-linux-gnu/libstdc++.so.6: version `CXXABI_1.3.9' not found (required by /code/node_modules/couchbase/build/Release/couchbase_impl.node)",
"errorType": "Error",
"stackTrace": [
"Error: /usr/lib/x86_64-linux-gnu/libstdc++.so.6: version `CXXABI_1.3.9' not found (required by /code/node_modules/couchbase/build/Release/couchbase_impl.node)",
...
错误发生的原因如堆栈描述,即没有 CXXABI_1.3.9 这个版本,可以看到函数计算 nodejs 环境中的支持情况:
root@1fe79eb58dbd:/code# strings /usr/lib/x86_64-linux-gnu/libstdc++.so.6 |grep CXXABI_
CXXABI_1.3
CXXABI_1.3.1
CXXABI_1.3.2
CXXABI_1.3.3
CXXABI_1.3.4
CXXABI_1.3.5
CXXABI_1.3.6
CXXABI_1.3.7
CXXABI_1.3.8
CXXABI_TM_1
升级底层系统版本的代价比较大,需要长时间的稳定性、兼容性测试和观察,所以,为了支持这类使用场景,我们希望能够有比较简单的方式绕行。
场景复现和问题解决
从前面的分析已经可以看出来,是因为 libstdc++.so.6 这个动态链接库的版本过低导致 couchbase 无法正常运行。所以,如果不升级 gcc 的情况下,需要提高 libstdc++.so.6 的版本支持,在没有其他版本依赖的前提下,快速替换掉 libstdc++.so.6 是最好的办法。直接替换掉 /usr/lib/x86_64-linux-gnu/ 下面的动态链接库可能会造成对系统底层基本库运行的影响,而且用户函数逻辑不能越权操作系统底层文件。所以,我们可以将更高版本的动态链接库下载到指定目录,然后改变动态链接库路径LD_LIBRARY_PATH,使用户自定义的路径优先级大于系统路径即可。
fun install 功能能够将第三方库安装到本地的模拟函数计算的运行"沙箱"中,而且自动设置 LD_LIBRARY_PATH 路径,调用 fun local invoke
就能够在本地真实模拟函数计算在线运行情况。执行 fun deploy
命令,能够自动打包第三方库以及解决 LD_LIBRARY_PATH 等环境变量设置问题,自动将本地的代码项目整个都部署到函数计算线上环境。
下面我们就详细介绍一下利用 fun 工具替换低版本 libstdc++.so.6 的步骤。
代码项目搭建
前提:先按照 fun 的安装步骤安装 fun工具,并进行 fun config 配置。
在本地很快搭建了一个项目目录:
- test_code/
- index.js
- template.yml
其中 index.js 和 template.yml 的 内容分别为
# index.js
const couchbase = require('couchbase').Mock;
module.exports.handler = function(event, context, callback) {
var cluster = new couchbase.Cluster();
var bucket = cluster.openBucket();
bucket.upsert('testdoc', {name:'Frank'}, function(err, result) {
if (err) throw err;
bucket.get('testdoc', function(err, result) {
if (err) throw err;
console.log(result.value);
// {name: Frank}
});
});
callback(null, {
hello: 'world'
})
}
# template.yml
ROSTemplateFormatVersion: '2015-09-01'
Transform: 'Aliyun::Serverless-2018-04-03'
Resources:
fc: # service name
Type: 'Aliyun::Serverless::Service'
Properties:
Description: 'fc test'
helloworld: # function name
Type: 'Aliyun::Serverless::Function'
Properties:
Handler: index.handler
Runtime: nodejs8
CodeUri: './'
Timeout: 60
为了能够在本地模拟函数计算的真实环境进行依赖包安装和调试,这里生成一个 fun.yml 文件用于 fun install 安装使用,内容如下:
runtime: nodejs8
tasks:
- shell: |-
if [ ! -f /code/.fun/root/usr/lib/x86_64-linux-gnu/libstdc++.so.6 ]; then
mkdir -p /code/.fun/tmp/archives/
curl http://mirrors.ustc.edu.cn/debian/pool/main/g/gcc-6/libstdc++6_6.3.0-18+deb9u1_amd64.deb -o /code/.fun/tmp/archives/libstdc++6_6.3.0-18+deb9u1_amd64.deb
bash -c 'for f in $(ls /code/.fun/tmp/archives/*.deb); do dpkg -x $f /code/.fun/root; done;'
rm -rf /code/.fun/tmp/archives
fi
- name: install couchbase
shell: npm install couchbase
fun.yml中参数说明:
- 前面的分析已经了解到函数计算 nodejs8 runtime 的 libstdc++.so.6 的版本偏低,所以,我们找到一个更新的版本来支持,见新版本的 libstdc++.so.6 的 CXXABI_ 参数:
$strings .fun/root/usr/lib/x86_64-linux-gnu/libstdc++.so.6|grep CXXABI_
CXXABI_1.3
CXXABI_1.3.1
CXXABI_1.3.2
CXXABI_1.3.3
CXXABI_1.3.4
CXXABI_1.3.5
CXXABI_1.3.6
CXXABI_1.3.7
CXXABI_1.3.8
CXXABI_1.3.9
CXXABI_1.3.10
CXXABI_TM_1
CXXABI_FLOAT128
- 上面的 shell 命令的功能是将 libstdc++ 的相关 lib 下载到目录 /code/.fun/root 下面。
执行 fun install 命令
安装各种第三方依赖,显示如下:
本地执行情况
执行 fun local invoke helloworld
,可以看到执行成功的效果:
$fun local invoke helloworld
begin pullling image aliyunfc/runtime-nodejs8:1.4.0...............................................................
pull image finished
pull image finished
FC Invoke Start RequestId: 78e20963-b314-4d69-843a-35a3f465796c
load code for handler:index.handler
FC Invoke End RequestId: 78e20963-b314-4d69-843a-35a3f465796c
{"hello":"world"}2019-02-19T08:16:45.073Z 78e20963-b314-4d69-843a-35a3f465796c [verbose] { name: 'Frank' }
在本地,我们可以看到,生成了一个 .fun/ 文件目录,动态链接库文件的位置如下:
[~/work/test_code/.fun/root/usr/lib/x86_64-linux-gnu]
$ls
libstdc++.so.6 libstdc++.so.6.0.22
[~/work/test_code/.fun/root/usr/lib/x86_64-linux-gnu]
$pwd
~/work/test_code/.fun/root/usr/lib/x86_64-linux-gnu
[~/work/test_code/.fun/root/usr/lib/x86_64-linux-gnu]
$ll libstdc++.so.6
lrwxrwxrwx@ 1 tingbao staff 19 2 15 2018 libstdc++.so.6 -> libstdc++.so.6.0.22
发布上线
使用 fun deploy
发布上线,然后到控制台执行一下线上实际的运行效果:
总结
fun install 功能能够将代码和依赖文件分离开,独立安装系统依赖文件,而且 fun local 和 fun deply 都能够自动帮你设置第三方库的依赖引用路径,让您无需关心环境变量问题。
本文的解法只是提供了一个对于系统版本偏低无法满足用户一些高级库使用需求时的简单绕行方案,仅供参考,对于一些复杂的环境依赖问题,可能还需要具体情况具体分析。
更多参考:
99dXnVk4I)