无需修改代码,用 fcapp.run 运行你的 REST 应用

本文涉及的产品
性能测试 PTS,5000VUM额度
应用实时监控服务-应用监控,每月50GB免费额度
Serverless 应用引擎免费试用套餐包,4320000 CU,有效期3个月
简介: 作为 Serverless 技术的标志性产品之一,函数计算长久以来专注于提升产品适用的场景。fcapp.run 域名以及相关产品特性的引入,标志着函数计算在 REST 场景以及 Web 场景的很大一步。客户从此可以将 REST 应用零改造地部署在函数计算上,研发测试的体验以及正式上线的方案都做到了优秀。非常欢迎同学们使用函数计算,并提出宝贵的意见。

作者:落语|阿里云 Serverless 技术研发


背景


阿里云函数计算产品[1]在较早的时候支持了 HTTP 触发器[2]能力,支持用户使用 HTTP 协议进行函数调用。函数计算后端通过一个共享的 APIServer 组件对所有客户提供响应 HTTP 触发器调用的服务,需要依赖 URL 中的 Path 将客户流量路由到客户的函数容器内部。容器内收到的 HTTP 请求 Path 会带有函数计算的路由标识,如果客户在函数计算部署 REST 风格的应用,那么就会遇见 404 问题。


1.png


在一开始,函数计算并不是为客户运行中小型规模应用而设计的。函数计算提供了原生的 REST 架构,将每个函数视为一个独立的资源,通常一个函数只负责一小块功能,也就是一个 API。如果一个函数只对应一个 API,那么在函数代码中也不必去实现一套路由逻辑去响应不同 URL Path 路径的请求了。


2.png


函数计算在近两年引入了 Custom Runtime/Custom Container Runtime[3]类型的函数,客户可以直接在函数计算上运行自己存量的应用,而不必按照函数计算推荐的架构去拆分自己的应用。客户以及社区内比较成熟的项目的开发习惯是采用 MVC 等架构,在一个程序中开发大量的 REST API,在进程内按照报文中的 HTTP Path 进行路由,将不同路径的请求“转发”至不同的方法或函数进行处理。


3.png


在这样的背景下,客户可以在函数计算运行存量的 REST 应用,但应用无法正常对外提供服务。客户花费大量的精力对存量的应用进行改造,而且这个改造仅仅在函数计算是必须的,是一种典型的平台携裹用户的产品设计。


使用 fcapp.run 调用函数


为了解决上述的问题,并兼容存量的函数以及客户习惯,函数计算为每个新创建的 HTTP 触发器分配了一个独立的域名,例如`{random-string}.cn-shanghai.fcapp.run`。使用该域名访问函数计算,函数计算会按照域名进行路由,将流量转发至函数容器内,避免对客户代码造成侵入性。


4.png

使用 fcapp-test.run 进行本地网页测试


由于中国大陆政策的影响,函数计算主域名无法在互联网为客户提供网站类型的业务,所有的函数请求结果将被转为下载行为[4]。对于纯 API 类型的函数,我们认为将请求结果转为下载是没有影响的。但对于网站属性的函数,返回的 HTML 文本以及 JavaScript 代码强依赖浏览器的解释器才能正常展示。我们判断让开发者能够实时看到函数返回的页面是一个强诉求。

在生产场景,我们推荐客户为函数绑定已备案的域名来解决这个问题,而在测试环境有更加简洁的方案。在测试阶段可以临时通过测试域名 fcapp-test.run 以及添加本地的 host 解析绕过这个问题,请求结果将不会被转为下载行为,可以正常进行网页调试。


# 1. 从页面获取fcapp.run的域名
FC_DOMAIN='wordpress-xxxxx-serverlordpress-ydziwvakfn.cn-shenzhen.fcapp.run'
FC_TEST_DOMAIN=`echo ${FC_DOMAIN} | sed 's/fcapp.run/fcapp-test.run/g'`
echo "FC域名: ${FC_DOMAIN}"
echo "FC测试域名: ${FC_TEST_DOMAIN}"
# 2. 查询域名解析的IP
FC_IP=`ping ${FC_DOMAIN} -c 1 | HEAD -1 | awk '{print $3}' | sed 's/[():]//g'`
echo "FC IP: ${FC_IP}"
# 3. 修改host文件,将测试域名的本地解析指向fcapp.run的解析
#    如果没有权限需要手动加
sudo -- sh -c  "printf '\n${FC_IP} ${FC_TEST_DOMAIN}\n' >> /etc/hosts"
cat /etc/hosts
# 4. 使用测试域名在浏览器访问函数
curl -v "${FC_TEST_DOMAIN}"


了解 TCP 协议以及 HTTP 协议的同学可以很容易地理解背后的技术细节。客户端在发起 HTTP 请求时,首先会通过域名解析查询到域名对应的 IP 地址,并发起 TCP 连接。接下来会通过建立的 TCP 连接,将 HTTP Request 报文发送至 Server 端。如果客户端直接向函数计算的 Server 发起 TCP 连接,并将可以与函数关联的域名发送至函数计算,那么函数计算就可以返回客户期望的内容。

函数计算在后端进行了处理,兼容了 fcapp-test.run 域名的访问,但并不提供权威 DNS 解析。客户只需要在本地进行 Host 配置或者使用自建的 DNS 服务器,将 fcapp-test.run 的域名解析至函数计算 Server,就能够正常测试函数。该方案既满足了中国大陆法律法规的要求,又以极低的成本满足了客户调试页面的需求,极大地优化了客户在函数计算的研发体验。


使用函数计算运行 wordpress 官方镜像


通过以上的方案,函数计算支持客户在不修改任何业务代码的前提下迁移自己的 REST 应用。下面使用 wordpress 官方镜像进行说明。


前置条件


  1. 开通函数计算账号。

  2. 将 wordpress 镜像转存到阿里云容器镜像服务中。

  3. 创建或使用已有的 mysql 实例,并为 wordpress 服务初始化相应的账号以及数据库。如果使用阿里云 RDS 实例,请确保函数服务的 VPC 配置与 RDS 实例的 VPC 配置一致,且白名单配置正确。


创建相应的函数以及服务


使用 wordpress 官方镜像创建函数,并设置容器内监听端口为 80。


5.png


注入数据库配置


修改函数配置,将 mysql 的数据库配置以环境变量的方式注入函数容器内。


6.png


无需备案,测试 wordpress 函数功能


查看创建的触发器分配的域名[5],按照上述文档配置,使用 fcapp-test.run 域名进行测试。


7.png8.png


上线你的函数


对外提供网站类型服务只能通过已备案域名来实现。函数计算用户可以通过配置自定义域名[6]的功能,将域名与函数进行绑定,使用自己的域名对外提供服务。同时也可以使用任意标准的网关类型的云产品或者开源产品,使用 fcapp.run 的内网域名上线你的函数。


小结


作为 Serverless 技术的标志性产品之一,函数计算长久以来专注于提升产品适用的场景。fcapp.run 域名以及相关产品特性的引入,标志着函数计算在 REST  场景以及 Web 场景的很大一步。客户从此可以将 REST 应用零改造地部署在函数计算上,研发测试的体验以及正式上线的方案都做到了优秀。非常欢迎同学们使用函数计算,并提出宝贵的意见。


相关链接


[1] 函数计算产品

https://fcnext.console.aliyun.com/overview


[2] HTTP 触发器

https://help.aliyun.com/document_detail/71229.html


[3] Custom Runtime/Custom Container Runtime

https://help.aliyun.com/document_detail/132044.html


[4] 下载行为

https://help.aliyun.com/document_detail/71229.html


[5] 分配的域名

https://help.aliyun.com/document_detail/74769.html#h3-url-2


[6] 自定义域名

https://help.aliyun.com/document_detail/90763.html


点击此处,前往函数计算官网查看更多!

相关文章
|
7月前
|
JSON JavaScript API
如何使用Newman 命令行的方式去运行API脚本?
如何使用Newman 命令行的方式去运行API脚本?
如何使用Newman 命令行的方式去运行API脚本?
|
7月前
|
资源调度 JavaScript Windows
'vue-cli-service' 不是内部或外部命令,也不是可运行的程序问题解决
【5月更文挑战第7天】'vue-cli-service' 不是内部或外部命令,也不是可运行的程序问题解决
6718 3
|
7月前
|
前端开发 Serverless Shell
Serverless 应用引擎操作报错合集之在阿里云函数计算中,laravel zip包使用示例的start.sh脚本启动时出现错误代码如何解决
Serverless 应用引擎(SAE)是阿里云提供的Serverless PaaS平台,支持Spring Cloud、Dubbo、HSF等主流微服务框架,简化应用的部署、运维和弹性伸缩。在使用SAE过程中,可能会遇到各种操作报错。以下是一些常见的报错情况及其可能的原因和解决方法。
|
设计模式 算法 Go
Go的模板方式模式
模板方法模式是一种行为设计模式,它在一个抽象类中定义了一个算法的骨架,允许子类为算法的某些步骤提供具体实现。它促进了代码的重用,并为一组相关算法定义了一个通用的结构。
56 0
|
7月前
|
Go
Go 定时任务方法封装
Go 定时任务方法封装
56 0
|
运维 5G Go
Go或者C中调用Lua业务脚本,实现终端应用的热更新方案
Go或者C中调用Lua业务脚本,实现终端应用的热更新方案
多model项目下,某个项目引用了公共lib下的service, 其他模块想不受影响的启动解决办法
多model项目下,某个项目引用了公共lib下的service, 其他模块想不受影响的启动解决办法
76 0
|
域名解析 网络协议 关系型数据库
无需修改代码,用 fcapp.run 运行你的 REST 应用
解锁客户不修改代码部署存量REST、网页应用场景,解决客户函数调用返回404问题,支持标准的网关产品与开源组件集成函数计算。
无需修改代码,用 fcapp.run 运行你的 REST 应用
|
数据库
代码修改后运行结果同修改之前结果一样
今天在做机房收费系统过程中,因为命名规范有些问题,需要将一些数据库表名重新命名,出现了这个问题: 问题描述(环境:VisualStudio2013 ;框架:.Net Framework4.5 ;语言:VB.NET):修改代码之前,数据库查询语句cmdText中的表名为“T_UserInfo”,修改之后,把表名修改为“T_User”(当然数据库中的表名同样修改为“T_User”),运行出错。用Try……Catch获取异常,异常提示“对象名T_UserInfo”无效。
代码修改后运行结果同修改之前结果一样
|
前端开发 Java 应用服务中间件