阿里云函数计算全面教程：常用 API 串联与实战指南
大家好，我是jobleap.cn的小九。
在 Serverless 开发中，代码编写只是第一步。如何管理复杂的依赖、配置触发器以及实现一键部署，才是生产环境的核心。本教程将带你通过Python 3.12 + uv + Serverless Devs (s.yaml)走通全流程。
一、 核心组件介绍
- uv: 下一代 Python 包管理器，速度比 pip 快 10-100 倍，完美支持
pyproject.toml。 - Serverless Devs (s.yaml): 阿里云官方推荐的资源编排工具，通过一个 YAML 文件定义函数、触发器、网络及存储。
- FC 3.0: 阿里云最新的函数计算架构，支持原生 Python 3.12 运行时。
二、 实战案例：构建一个“图片元数据提取器”
我们将创建一个函数：用户通过 HTTP 上传图片，函数使用Pillow库解析图片信息并返回。
1. 初始化项目结构
使用uv初始化环境：
mkdirfc-image-metadata&&cdfc-image-metadata uv init uvaddPillow2. 编写业务代码 (index.py)
阿里云 FC 的 HTTP 触发器采用WSGI标准：
importjsonfromPILimportImageimportiodefhandler(environ,start_response):try:# 1. 获取请求体（图片二进制）request_body_size=int(environ.get('CONTENT_LENGTH',0))input_data=environ['wsgi.input'].read(request_body_size)# 2. 业务处理：提取图片信息withImage.open(io.BytesIO(input_data))asimg:info={"format":img.format,"size":img.size,"mode":img.mode}# 3. 构造响应status='200 OK'response_headers=[('Content-type','application/json')]start_response(status,response_headers)return[json.dumps({"success":True,"data":info}).encode('utf-8')]exceptExceptionase:start_response('500 Internal Server Error',[('Content-type','text/plain')])return[str(e).encode('utf-8')]三、 详解s.yaml配置文件
在根目录创建s.yaml。它是连接本地代码与云端资源的桥梁。
edition:3.0.0# 必填，Serverless Devs 规范版本name:image-process-app# 项目名称vars:# 定义全局变量region:"cn-hangzhou"functionName:"metadata-extractor"resources:metadata_function:# 资源 IDcomponent:fc3# 使用 FC 3.0 组件props:region:${vars.region}functionName:${vars.functionName}runtime:"python3.12"handler:"index.handler"memorySize:512# 适当增加内存以处理图片timeout:30code:./# 指定当前目录为代码包# 常用配置项：环境变量environmentVariables:PYTHONUSERBASE:"/code/.s/python"# 指定依赖查找路径# 常用配置项：HTTP 触发器triggers:-triggerName:http-triggertriggerType:httptriggerConfig:authType:anonymous# 匿名访问methods:-POST# 仅允许 POST 上传图片四、 常用 API 串联：从开发到部署
第一步：依赖预处理
由于阿里云 FC 环境直接运行uv环境可能存在兼容性，我们先导出requirements.txt：
uvexport--format requirements.txt>requirements.txt第二步：安装依赖到本地目录
为了让云端能识别uv下载的包，我们需要将依赖安装到项目目录：
# 使用 s 工具模拟 FC 环境安装（推荐）s build --use-docker这一步会根据requirements.txt将依赖下载到.s隐藏目录下。
第三步：部署到云端
s deploy -y部署成功后，控制台会输出一个url，例如：https://metadata-extractor.cn-hangzhou.fcapp.run。
五、 常用命令速查表
| 命令 | 说明 |
|---|---|
s deploy | 部署全部资源，若云端已存在则更新 |
s info | 查看已部署资源的详情（含访问链接） |
s logs -f | 实时查看云端函数的运行日志（排障神器） |
s local invoke | 本地模拟运行函数 |
s remove | 删除s.yaml中定义的全部云端资源 |
六、 进阶：如何串联更多阿里云 API？
在s.yaml中，你不仅可以定义函数，还可以通过修改props串联以下服务：
- OSS (存储): 通过
ossConfig配置触发器，实现“图片上传到 OSS 后自动触发本函数”。 - SLS (日志): 通过
logConfig指定日志库，实现日志永久存储与检索。 - VPC (网络): 配置
vpcConfig访问云数据库 RDS 或 Redis。