函数
Functions 提供事件驱动的服务端代码执行:支持多语言运行时(含 java-17.0)、部署与变量管理、事件触发与定时执行。
核心概念
- Function:部署单元,携带名称、执行规格(CPU / 内存)、副本数、权限、变量与 timeout 配置。
- Deployment:一次代码部署;失败构建与失败 execution 在 Console 中有明确状态与日志。
- Execution:一次执行,返回 status code 与响应体,可在 Console 查看日志。
- 事件:数据库、存储、认证等事件可触发 Function(Webhooks 亦由平台提供,配置在项目 Settings 页)。
运行时
- 运行时在创建 Function 时从部署允许列表中选择(含 Node、Python、PHP、Ruby、Deno、Java
java-17.0等);已有 Function 不会因升级自动切换运行时。 - Function 项目上下文(项目变量、权限)在执行时注入。
Java 17 Function
- Console 快速开始、手动创建与 API 均可选择
java-17.0;通过 API 或 Server SDK 创建时 runtime 标识使用java-17.0。 - 构建、环境变量、权限、timeout、日志和 deployment 生命周期与其他运行时一致:完成 Function 名称、执行规格、权限和部署方式配置后,部署并创建一次 execution,确认响应、日志与状态符合预期即可。
执行面
| 执行面 | 行为 |
|---|---|
| 本地 / OpenRuntimes | 使用运行时对应镜像完成 build 与 execution |
| 云沙箱(ACS Sandbox) | 多语言、多实例、多副本云沙箱执行面,由部署配置提供 |
Function 与 Site 均以受限身份运行;用户命令不满足受限身份安全条件时直接失败,不回退为高权限执行。Function 只改变执行环境,不改变项目内各服务的使用方式。
创建 Function(三种来源)
截图未公开:原图可能包含账号或资源标识。
创建向导(create-function)提供且仅提供以下三种方式:
- Git 仓库:经 VCS 安装选择 GitHub 仓库后创建(自托管未启用 VCS 时显示提示);后续按仓库分支 / 提交构建。
- 模板:快速开始
starter模板(带运行时选择)+ 精选模板;完整模板库见 Functions → Templates。 - Manual(手动):填写 Name(可选自定义 Function ID)、Runtime(运行时下拉,来自部署允许列表)、entrypoint、install command、execute 权限、启动变量、CPU / 内存规格(runtimeSpecification)与副本数(runtimeReplicas),并上传
.tar.gz代码包(仅.tar.gz格式,受大小上限约束)。
无可用执行规格时页面提示联系管理员发布 execution profile;部分规格可能要求升级套餐后使用。
部署(Deployment)
- Function 详情内的部署入口按来源提供:手动上传 / Git / CLI 三类创建部署的模态。
- 部署构建失败与执行失败在 Console 有明确状态与日志。
- 部署操作支持:Activate(激活为当前部署)、Cancel(取消进行中的构建)、Redeploy(重建历史部署)、下载部署包。
执行(Execute)
- Function 详情 → Executions → Execute 打开执行向导。
- 字段:Path、Method(GET / POST / PUT / PATCH / DELETE / OPTIONS / HEAD)、Body、Headers、Run now 或 Scheduled at(指定未来时间执行)。
- 提交即创建一次执行(异步)并跳转执行列表。
- Executions 列表:每次执行的状态、耗时与响应码;点开单条查看日志详情(详情页可删除记录)。失败的执行保留业务日志,Console 可区分平台失败(沙箱创建 503、启动超时 504、链路异常 502)与业务失败(500,业务代码异常)。
执行路径查询(2.9.0)
按请求路径回查执行:函数详情 Executions 页可查看已产生执行记录的去重请求路径(字符串升序、分页),并按完整路径精确匹配分页查询该路径下的执行记录。对应 Server API:GET /v1/functions/{functionId}/execution-paths、GET /v1/functions/{functionId}/execution-paths/executions。
定时与变量
- Schedule:Function Settings 中的 cron 字段(带 cron 语法校验),保存后按计划自动执行。
- Function 变量:Settings → Variables 维护函数级变量(创建 / 更新 / 删除);与项目全局变量同名冲突时在页内标出——全局与函数级变量都会注入执行上下文(项目全局变量在项目 Settings 页维护)。
用量与资源监控
Function 详情的用量页展示执行次数、耗时等用量指标;云沙箱(ACS)执行的函数另提供 ACS 容器组资源监控面板(CPU / 内存 / 网络 / 磁盘),用于观察执行实例的资源水位。
Function 域名
Function 详情 Domains 页签可为函数绑定自定义域名(含添加与验证流程)。
安全边界与凭据传递
- Function 与 Site 以受限身份运行,外部 URL 访问遵循 SSRF 防护(拒绝本机 / 私网 / 云元数据地址)。
- Function API Key 不再接受 query string 传递:调用受保护的 Function 时使用受保护 header 或平台注入的运行时认证路径,避免 URL、日志和代理泄露凭据。
- 执行会真实运行代码并可能写入项目数据(数据库、存储等),Execute 前确认目标环境。
- 激活新部署立即替换线上代码版本;回滚 = 重新 Activate 历史部署。