Serverless 实战 —— 移植 spring-petclinic 到函数计算

简介: 前言 首先介绍下在本文出现的几个比较重要的概念: 函数计算(Function Compute):函数计算是一个事件驱动的服务,通过函数计算,用户无需管理服务器等运行情况,只需编写代码并上传。函数计算准备计算资源,并以弹性伸缩的方式运行用户代码,而用户只需根据实际代码运行所消耗的资源进行付费。

前言

首先介绍下在本文出现的几个比较重要的概念:

函数计算(Function Compute):函数计算是一个事件驱动的服务,通过函数计算,用户无需管理服务器等运行情况,只需编写代码并上传。函数计算准备计算资源,并以弹性伸缩的方式运行用户代码,而用户只需根据实际代码运行所消耗的资源进行付费。函数计算更多信息参考
Funcraft:Funcraft 是一个用于支持 Serverless 应用部署的工具,能帮助您便捷地管理函数计算、API 网关、日志服务等资源。它通过一个资源配置文件(template.yml),协助您进行开发、构建、部署操作。Fun 的更多文档参考
spring-petclinicPetclinic 是一个 Spring Boot 、Spring MVC 和 Spring Data 结合使用的示例项目,是学习 Spring Boot 经典案例。

备注: 本文介绍的技巧需要 Funcraft 版本大于等于 3.1.0 。

环境准备

该教程依赖如下工具:

  • Funcraft
  • Git
  • Maven

Funcraft 的安装文档里介绍的方法将 Funcraft 安装到本机。安装完成后,可以执行 fun --version 检查 Fun 是否安装成功。

初始化项目

首先在本地运行 Petclinic 项目,Petclinic 是一个使用 Maven 构建的 Spring Boot 应用。您可以使用命令行构建出 Jar 文件并在本地运行。

git clone https://github.com/spring-projects/spring-petclinic.git
cd spring-petclinic
./mvnw package
java -jar target/*.jar

然后您可以访问本地地址:http://localhost:8080/

移植到函数计算

本示例中,我们打算使用函数计算的 Custom Runtime 来移植 Petclinic 项目。顾名思义, Custom Runtime 就是自定义的执行环境, 用户基于 Custom Runtime 可以完成以下目标:

  • 可以随心所欲持定制个性化语言执行环境(例如 Golang、Lua、Ruby)以及各种语言的小版本(例如Python3.7、Nodejs12 )等,打造属于自己的自定义 Runtime
  • 现有的 Web 应用或基于传统开发 Web 项目基本不用做任何改造,即可将项目一键迁移到函数计算平台

在阅读 Custom Runtime 的技术文档后,我们要将 Petclinic 移植到函数计算,需要解决如下两个问题:

  1. 通过创建函数并启动服务
  2. 将 Petclinic 启动在 9000 端口

于是在 spring-petclinic 项目根目录新增如下三个文件:

  • template.yml 用于声明函数和 HTTP Trigger
  • bootstrap 用于启动服务
  • .funignore 用于忽略运行时无关的文件,减小部署文件的尺寸。

template.yml

template.yml 文件内容如下:

ROSTemplateFormatVersion: '2015-09-01'
Transform: 'Aliyun::Serverless-2018-04-03'
Resources:
  springboot: # service name
    Type: 'Aliyun::Serverless::Service'
    Properties:
      Description: This is a FC service for springboot
    petclinic: # function name
      Type: 'Aliyun::Serverless::Function'
      Properties:
        Handler: com.example.demo.DemoApplication::main
        Runtime: custom
        CodeUri: ./
        MemorySize: 1024
        Timeout: 15
      Events:
        httpTrigger:
          Type: HTTP
          Properties:
            AuthType: ANONYMOUS
            Methods: ['HEAD', 'GET', 'POST', 'PUT', 'DELETE']
  petclinic.codelife.me: # domain name
    Type: 'Aliyun::Serverless::CustomDomain'
    Properties:
      Protocol: HTTP
      RouteConfig:
        routes:
          '/*':
            ServiceName: springboot
            FunctionName: petclinic            

其中 Runtime 指定为 custom。Handler 对于 custom 类型的运行时是多余的,任意写一个符合语法的就 OK 了。这里还注册了一个 HTTP 类型的触发器,开启了匿名验证,支持 5 种常见的 HTTP 方法。

bootstrap

bootstrap 文件是 custom 运行时约定的引导文件可以是二进制也可以是脚本,打包上传的时要保证该文件具备可执行权限。bootstrap 文件内容如下:

#!/usr/bin/env bash
java  -Dserver.port=9000 \
        -jar target/spring-petclinic-2.1.0.BUILD-SNAPSHOT.jar

其中

  • -Dserver.port=9000 将 Spring Boot 的启动端口改为 9000
  • -jar target/spring-petclinic-2.1.0.BUILD-SNAPSHOT.jar 指定要启动的 jar 包,这个 jar 是 spring-petclinic 项目通过 maven 构建的结果文件。

.funignore

.funignore 文件的作用是 fun deploy 的时候会忽略掉运行时不相关的文件(比如构建时依赖,某些编译过程产物,源码文件等)以减少打包文件的体积。

.idea/
.mvn/
.vscode/
push-to-pws/
src/
*.yml
mvnw*
*.xml
*.md
target/*
!target/*.jar

本地预览

$ fun local start petclinic.codelife.me
using template: template.yml
CustomDomain petclinic.codelife.me of springboot/petclinic was registered
        url: http://localhost:8000/*
        methods: [ 'HEAD', 'GET', 'POST', 'PUT', 'DELETE' ]
        authType: ANONYMOUS

function compute app listening on port 8000!

这里 fun local start + domain_name,会在本地端口启动该 domain 的路径映射关系,免去直接调试函数时长长的 contextPath ( /2016-08-15/proxy/springboot/petclinic/ ) ,注意该功能依赖 3.1.0 以上版本的 funcraft。

然后浏览器打开 http://localhost:8000/ 即可本地预览 petclinic 应用。

打包并部署

$ mvn package -Dmaven.test.skip=true && fun deploy

....
[INFO] Replacing main artifact with repackaged archive
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  30.612 s
[INFO] Finished at: 2019-11-01T11:23:40+08:00
[INFO] ------------------------------------------------------------------------
using template: template.yml
using region: cn-hongkong
using accountId: ***********4733
using accessKeyId: ***********EUz3
using timeout: 600

Waiting for service springboot to be deployed...
        Waiting for function petclinic to be deployed...
                Waiting for packaging function petclinic code...
                The function petclinic has been packaged. A total of 12 files files were compressed and the final size was 39.91 MB
                Waiting for HTTP trigger httpTrigger to be deployed...
                triggerName: httpTrigger
                methods: HEAD,GET,POST,PUT,DELETE
                url: https://1751705494334733.cn-hongkong.fc.aliyuncs.com/2016-08-15/proxy/springboot/petclinic/
                function httpTrigger deploy success
        function petclinic deploy success
service springboot deploy success

Waiting for custom domain petclinic.codelife.me to be deployed...
custom domain petclinic.codelife.me deploy success

这里选择了 cn-hongkong region,这是因为要想正常的显示 http 服务,需要绑定域名,否则 html 文件会默认下载而不是显示。而海外的 region 可以免去域名备份的繁琐事宜。

其中域名 petclinic.codelife.me 请换成您自己的,并将 DNS 的 cname 记录指向 <accountID>.<region>.fc.aliyuncs.com

浏览器打开 http://petclinic.codelife.me

b7c0d5149e7d78e5c97c80a8a96aa976

FAQ

  1. 如何使用 MySQL 数据库

spring-petclinic 默认使用的是内存数据 hsqldb,而函数之间内存不共享,所以在多次请求可能出现访问到不同的函数实例,出现数据不一致的情况。对于真实的系统可以通过给函数配置 VPC,然后创建一个阿里云的 RDS 服务,所有的函数都访问同一个 RDS 服务。

参考

  1. Funcraft
  2. Aliyun Serverless VSCode Extension
  3. Custom Runtime 用户手册
  4. 项目源码
相关实践学习
【玩转ComfyUI】基于函数计算一键部署AI生图平台ComfyUI
本次实验将带大家通过使用阿里云产品函数计算FC,快速使用ComfyUI实现更高质量的图像生成。
从 0 入门函数计算
在函数计算的架构中,开发者只需要编写业务代码,并监控业务运行情况就可以了。这将开发者从繁重的运维工作中解放出来,将精力投入到更有意义的开发任务上。
目录
相关文章
|
6月前
|
负载均衡 监控 Java
Spring Cloud Gateway 全解析:路由配置、断言规则与过滤器实战指南
本文详细介绍了 Spring Cloud Gateway 的核心功能与实践配置。首先讲解了网关模块的创建流程,包括依赖引入(gateway、nacos 服务发现、负载均衡)、端口与服务发现配置,以及路由规则的设置(需注意路径前缀重复与优先级 order)。接着深入解析路由断言,涵盖 After、Before、Path 等 12 种内置断言的参数、作用及配置示例,并说明了自定义断言的实现方法。随后重点阐述过滤器机制,区分路由过滤器(如 AddRequestHeader、RewritePath、RequestRateLimiter 等)与全局过滤器的作用范围与配置方式,提
Spring Cloud Gateway 全解析:路由配置、断言规则与过滤器实战指南
|
7月前
|
监控 Java API
Spring Boot 3.2 结合 Spring Cloud 微服务架构实操指南 现代分布式应用系统构建实战教程
Spring Boot 3.2 + Spring Cloud 2023.0 微服务架构实践摘要 本文基于Spring Boot 3.2.5和Spring Cloud 2023.0.1最新稳定版本,演示现代微服务架构的构建过程。主要内容包括: 技术栈选择:采用Spring Cloud Netflix Eureka 4.1.0作为服务注册中心,Resilience4j 2.1.0替代Hystrix实现熔断机制,配合OpenFeign和Gateway等组件。 核心实操步骤: 搭建Eureka注册中心服务 构建商品
1185 3
|
11月前
|
人工智能 开发框架 安全
Serverless MCP 运行时业界首发,函数计算让 AI 应用最后一公里提速
作为云上托管 MCP 服务的最佳运行时,函数计算 FC 为阿里云百炼 MCP 提供弹性调用能力,用户只需提交 npx 命令即可“零改造”将开源 MCP Server 部署到云上,函数计算 FC 会准备好计算资源,并以弹性、可靠的方式运行 MCP 服务,按实际调用时长和次数计费,欢迎你在阿里云百炼和函数计算 FC 上体验 MCP 服务。
909 30
|
9月前
|
存储 编解码 Serverless
Serverless架构下的OSS应用:函数计算FC自动处理图片/视频转码(演示水印添加+缩略图生成流水线)
本文介绍基于阿里云函数计算(FC)和对象存储(OSS)构建Serverless媒体处理流水线,解决传统方案资源利用率低、运维复杂、成本高等问题。通过事件驱动机制实现图片水印添加、多规格缩略图生成及视频转码优化,支持毫秒级弹性伸缩与精确计费,提升处理效率并降低成本,适用于高并发媒体处理场景。
887 0
|
5月前
|
监控 Cloud Native Java
Spring Boot 3.x 微服务架构实战指南
🌟蒋星熠Jaxonic,技术宇宙中的星际旅人。深耕Spring Boot 3.x与微服务架构,探索云原生、性能优化与高可用系统设计。以代码为笔,在二进制星河中谱写极客诗篇。关注我,共赴技术星辰大海!(238字)
1067 2
Spring Boot 3.x 微服务架构实战指南
|
5月前
|
XML Java 测试技术
《深入理解Spring》:IoC容器核心原理与实战
Spring IoC通过控制反转与依赖注入实现对象间的解耦,由容器统一管理Bean的生命周期与依赖关系。支持XML、注解和Java配置三种方式,结合作用域、条件化配置与循环依赖处理等机制,提升应用的可维护性与可测试性,是现代Java开发的核心基石。
|
10月前
|
人工智能 Java API
Spring AI 实战|Spring AI入门之DeepSeek调用
本文介绍了Spring AI框架如何帮助Java开发者轻松集成和使用大模型API。文章从Spring AI的初探开始,探讨了其核心能力及应用场景,包括手动与自动发起请求、流式响应实现打字机效果,以及兼容不同AI服务(如DeepSeek、通义千问)的方法。同时,还详细讲解了如何在生产环境中添加监控以优化性能和成本管理。通过Spring AI,开发者可以简化大模型调用流程,降低复杂度,为企业智能应用开发提供强大支持。最后,文章展望了Spring AI在未来AI时代的重要作用,鼓励开发者积极拥抱这一技术变革。
3620 71
Spring AI 实战|Spring AI入门之DeepSeek调用
|
7月前
|
人工智能 监控 安全
如何快速上手【Spring AOP】?核心应用实战(上篇)
哈喽大家好吖~欢迎来到Spring AOP系列教程的上篇 - 应用篇。在本篇,我们将专注于Spring AOP的实际应用,通过具体的代码示例和场景分析,帮助大家掌握AOP的使用方法和技巧。而在后续的下篇中,我们将深入探讨Spring AOP的实现原理和底层机制。 AOP(Aspect-Oriented Programming,面向切面编程)是Spring框架中的核心特性之一,它能够帮助我们解决横切关注点(如日志记录、性能统计、安全控制、事务管理等)的问题,提高代码的模块化程度和复用性。

相关产品

  • 函数计算