手把手教你用Ruby玩转阿里云函数计算：从零开始的实战指南

嘿，朋友！你是不是也听说过“无服务器”这个词，但总觉得它离自己很远？或者你是个Ruby开发者，平时写惯了Rails、Sinatra，突然听说要在云端跑一个没有服务器的函数，心里直打鼓？别慌，今天我就带你一步步用Ruby在阿里云函数计算（Function Compute）上搞点真东西。这不是那种官方文档式冷冰冰的教程，而是像朋友聊天一样，带你从零开始，把代码跑起来，还能省下真金白银。

什么是阿里云函数计算？简单说就是“按需运行的代码”

先别急着敲代码，咱得先把概念捋顺。想象一下，你有个小工具，比如每天早上8点自动给你发天气提醒。传统做法是租一台服务器，24小时开机，哪怕99%的时间它都在“睡觉”。这多浪费钱啊！

而阿里云函数计算呢，就像是个“随叫随到”的服务员。你的代码就放在云端，只有当你触发它的时候——比如定时任务到了、用户上传了文件、API被调用了——它才启动执行，执行完立马“下班”。你只为你真正使用的计算时间付费，不用为闲置资源买单。这就是“Serverless”（无服务器）的核心思想。

Ruby也能玩函数计算？当然可以！

很多人以为函数计算只支持Node.js、Python这些语言，其实阿里云早就支持Ruby了！虽然生态不如前两者热闹，但对我们Rubyist来说，能在熟悉的语言环境下做无服务器开发，简直不要太爽。

你可以用它来做很多事：处理文件上传后的图片压缩、定时抓取数据、构建轻量级API接口、甚至做个微信机器人后端……关键是，它部署快、成本低、运维几乎为零。

准备阶段：注册账号 + 领优惠券 = 省钱第一步

在动手之前，咱们得先有阿里云账号。如果你还没有，赶紧去注册一个。已经有的话，直接登录控制台就行。

重点来了——别忘了领优惠券！阿里云经常有新用户或老用户福利，尤其是函数计算这种按量计费的服务，用优惠券能帮你省下不少试错成本。我这边刚好有个专属链接，点击就能领取：阿里云优惠券。建议你现在就去领一张，后面部署测试的时候直接抵扣费用，白嫖的感觉谁不爱呢？

本地环境搭建：工欲善其事，必先利其器

接下来，我们要在本地准备好开发环境。别担心，步骤很简单。

1. 安装阿里云CLI和Fun工具

阿里云提供了一个叫 fun 的命令行工具，专门用来本地调试和部署函数计算项目。打开你的终端，运行下面这行命令：

npm install @alicloud/fun -g

没错，虽然是Ruby项目，但fun是基于Node.js的，所以需要Node环境。如果你还没装Node，先去官网下一个。

安装完成后，运行fun config，按照提示填入你的阿里云AccessKey ID和Secret。这个密钥可以在阿里云控制台的“访问控制RAM”里找到。注意别把密钥泄露出去哦！

2. 创建项目目录

新建一个文件夹，比如叫my-ruby-fc，然后进入这个目录：

mkdir my-ruby-fc
cd my-ruby-fc

在这个目录下，我们需要两个关键文件：template.yml 和你的Ruby代码文件。

编写第一个Ruby函数：Hello, Serverless!

让我们来写一个最简单的函数——返回“Hello, World!”。

创建Ruby脚本：index.rb

在项目根目录下创建一个index.rb文件，内容如下：

def handler(event, context)
  {
    statusCode: 200,
    headers: { "Content-Type" => "text/plain" },
    body: "Hello from Ruby on Alibaba Cloud Function Compute!"
  }
end

看到没？就这么几行。函数名叫handler，这是阿里云规定的入口方法。它接收两个参数：event（触发事件）和context（运行时上下文）。我们这里没用到它们，直接返回一个标准的HTTP响应结构。

配置部署模板：template.yml

接下来是template.yml，它告诉阿里云这个函数该怎么部署：

ROSTemplateFormatVersion: '2015-09-01'
Transform: 'Aliyun::Serverless-2018-04-03'
Resources:
  MyRubyService:
    Type: 'Aliyun::Serverless::Service'
    Properties:
      Description: 'A simple Ruby function demo'
    MyRubyFunction:
      Type: 'Aliyun::Serverless::Function'
      Properties:
        Handler: index.handler
        Runtime: ruby2.7
        CodeUri: './'
        MemorySize: 128
        Timeout: 60
      Events:
        HttpTrigger:
          Type: HTTP
          Properties:
            AuthType: ANONYMOUS
            Methods: ['GET', 'POST']

解释一下几个关键点：

• Handler: index.handler —— 表示入口是index.rb文件中的handler方法。
• Runtime: ruby2.7 —— 当前阿里云支持Ruby 2.7版本，未来可能会升级。
• CodeUri: './' —— 代码就在当前目录。
• Events 下定义了一个HTTP触发器，意味着你可以通过URL直接访问这个函数。

本地调试与云端部署

一切就绪，现在我们可以先本地试试看。

1. 本地模拟运行

在终端运行：

fun local start

如果一切正常，你会看到类似这样的输出：

Http Trigger: URL for HttpTrigger is http://localhost:8000

打开浏览器访问这个地址，应该就能看到我们的“Hello”信息了！本地调试成功，说明代码没问题。

2. 一键部署到云端

确认没问题后，执行部署命令：

fun deploy

第一次部署会比较慢，因为要创建服务、上传代码、生成触发器。等几分钟后，你会看到类似这样的提示：

url: https://xxx.cn-hangzhou.fc.aliyuncs.com/2016-08-15/proxy/MyRubyService/MyRubyFunction/

复制这个URL，用浏览器打开，Boom！你的Ruby函数已经在阿里云上跑起来了！是不是特别有成就感？

进阶玩法：让函数更实用

光打印“Hello”当然不够酷。我们可以让它做点更有意思的事。

处理GET参数

比如，我们想让函数根据传入的名字打招呼。修改index.rb：

require 'json'
def handler(event, context)
  # 解析HTTP请求体
  request = JSON.parse(event) rescue {}
  query_params = request.dig('queryStringParameters') || {}
  name = query_params['name'] || 'World'
  {
    statusCode: 200,
    headers: { "Content-Type" => "text/plain" },
    body: "Hello, #{name}! Welcome to Serverless Ruby."
  }
end

重新部署后，访问：https://your-url?name=张三，就会返回“Hello, 张三！”了。

使用Gem包（比如JSON处理）

虽然函数计算内置了一些常用库，但如果你想用第三方Gem，比如httparty，怎么办？

你需要在项目中添加Gemfile，然后使用fun install来打包依赖。不过要注意，不是所有Gem都适合无服务器环境，尽量选择轻量、无复杂依赖的库。

常见问题与避坑指南

最后分享几个我踩过的坑，帮你少走弯路：

• 冷启动延迟：函数长时间不调用，第一次触发会有几百毫秒的延迟。对延迟敏感的场景，可以考虑预留实例。
• 文件系统限制：/tmp 以外的目录是只读的，临时文件记得存到/tmp。
• 超时设置：最长执行时间默认是60秒，复杂任务要考虑拆分。
• 日志查看：所有puts输出都会记录在日志服务里，控制台可以直接查看。

Ruby + 函数计算 = 快速交付的新选择

看到这儿，你应该已经掌握了用Ruby在阿里云函数计算上开发的基本流程。从创建项目、编写代码、本地调试到云端部署，整个过程其实非常流畅。尤其适合做小型工具、自动化任务、微服务接口这类场景。

最重要的是，它真的省钱。配合前面提到的阿里云优惠券，你完全可以零成本试玩一整个月，甚至更久。别再让“不知道怎么开始”成为你探索新技术的障碍。

还等什么？赶紧打开终端，敲下第一行代码吧。说不定下一个惊艳的创意，就诞生在你的第一个Ruby函数里。记住，技术的魅力不在于多复杂，而在于它能不能帮你解决问题、创造价值。