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

本文涉及的产品
容器服务 Serverless 版 ACK Serverless,317元额度 多规格
可观测可视化 Grafana 版,10个用户账号 1个月
可观测监控 Prometheus 版,每月50GB免费额度
简介: 函数计算是一个事件驱动的服务,通过函数计算,用户无需管理服务器等运行情况,只需编写代码并上传。函数计算准备计算资源,并以弹性伸缩的方式运行用户代码,而用户只需根据实际代码运行所消耗的资源进行付费。本文将为大家讲解如何移植 spring-petclinic 到函数计算。

原文作者:倚贤
原文链接:https://developer.aliyun.com/article/724662?spm=a2c6h.12873581.0.0.4d58115e6xcd1A&groupCode=cloudnative
更多云原生技术资讯可关注阿里巴巴云原生技术圈

前言

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

函数计算(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/
7.png

移植到函数计算

本示例中,我们打算使用函数计算的 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
8.png

FAQ

  1. 如何使用 MySQL 数据库

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

参考

  1. Funcraft
  2. Aliyun Serverless VSCode Extension
  3. Custom Runtime 用户手册
  4. 项目源码

阿里巴巴云原生关注微服务、Serverless、容器、Service Mesh 等技术领域、聚焦云原生流行技术趋势、云原生大规模的落地实践,做最懂云原生开发者的技术圈。”

相关实践学习
【文生图】一键部署Stable Diffusion基于函数计算
本实验教你如何在函数计算FC上从零开始部署Stable Diffusion来进行AI绘画创作,开启AIGC盲盒。函数计算提供一定的免费额度供用户使用。本实验答疑钉钉群:29290019867
建立 Serverless 思维
本课程包括: Serverless 应用引擎的概念, 为开发者带来的实际价值, 以及让您了解常见的 Serverless 架构模式
相关文章
|
3月前
|
消息中间件 运维 Serverless
函数计算产品使用问题之如何部署Stable Diffusion Serverless API
函数计算产品作为一种事件驱动的全托管计算服务,让用户能够专注于业务逻辑的编写,而无需关心底层服务器的管理与运维。你可以有效地利用函数计算产品来支撑各类应用场景,从简单的数据处理到复杂的业务逻辑,实现快速、高效、低成本的云上部署与运维。以下是一些关于使用函数计算产品的合集和要点,帮助你更好地理解和应用这一服务。
|
26天前
|
自然语言处理 Java API
Spring Boot 接入大模型实战:通义千问赋能智能应用快速构建
【10月更文挑战第23天】在人工智能(AI)技术飞速发展的今天,大模型如通义千问(阿里云推出的生成式对话引擎)等已成为推动智能应用创新的重要力量。然而,对于许多开发者而言,如何高效、便捷地接入这些大模型并构建出功能丰富的智能应用仍是一个挑战。
103 6
|
25天前
|
机器学习/深度学习 监控 Serverless
无服务器架构(Serverless)
无服务器架构(Serverless)
|
29天前
|
缓存 NoSQL Java
Spring Boot与Redis:整合与实战
【10月更文挑战第15天】本文介绍了如何在Spring Boot项目中整合Redis,通过一个电商商品推荐系统的案例,详细展示了从添加依赖、配置连接信息到创建配置类的具体步骤。实战部分演示了如何利用Redis缓存提高系统响应速度,减少数据库访问压力,从而提升用户体验。
70 2
|
1月前
|
Java 数据库连接 Spring
【2021Spring编程实战笔记】Spring开发分享~(下)
【2021Spring编程实战笔记】Spring开发分享~(下)
26 1
|
1月前
|
XML Java 数据格式
Spring IOC容器的深度解析及实战应用
【10月更文挑战第14天】在软件工程中,随着系统规模的扩大,对象间的依赖关系变得越来越复杂,这导致了系统的高耦合度,增加了开发和维护的难度。为解决这一问题,Michael Mattson在1996年提出了IOC(Inversion of Control,控制反转)理论,旨在降低对象间的耦合度,提高系统的灵活性和可维护性。Spring框架正是基于这一理论,通过IOC容器实现了对象间的依赖注入和生命周期管理。
65 0
|
2月前
|
消息中间件 弹性计算 关系型数据库
体验函数计算:高效处理多媒体文件的真实感受与实战总结
该方案在引导和文档方面做得较为详尽,仅在事件驱动机制部分略显简略。部署和代码示例实用,但需注意内存配置以避免超时。使用体验方面,函数计算表现出色,尤其在高并发场景下,显著提升了应用稳定性和成本效益。云产品如OSS、MNS等与函数计算配合流畅,ECS和RDS表现稳健。总体而言,这套方案弹性好、成本低,特别适合应对高并发或流量不确定的场景,值得推荐。
68 24
|
1月前
|
XML Java 数据库连接
【2020Spring编程实战笔记】Spring开发分享~(上)
【2020Spring编程实战笔记】Spring开发分享~
53 0
|
3月前
|
JSON Java API
解码Spring Boot与JSON的完美融合:提升你的Web开发效率,实战技巧大公开!
【8月更文挑战第29天】Spring Boot作为Java开发的轻量级框架,通过`jackson`库提供了强大的JSON处理功能,简化了Web服务和数据交互的实现。本文通过代码示例介绍如何在Spring Boot中进行JSON序列化和反序列化操作,并展示了处理复杂JSON数据及创建RESTful API的方法,帮助开发者提高效率和应用性能。
154 0
|
3月前
|
SQL Java 数据库连接
Spring Boot联手MyBatis,打造开发利器:从入门到精通,实战教程带你飞越编程高峰!
【8月更文挑战第29天】Spring Boot与MyBatis分别是Java快速开发和持久层框架的优秀代表。本文通过整合Spring Boot与MyBatis,展示了如何在项目中添加相关依赖、配置数据源及MyBatis,并通过实战示例介绍了实体类、Mapper接口及Controller的创建过程。通过本文,你将学会如何利用这两款工具提高开发效率,实现数据的增删查改等复杂操作,为实际项目开发提供有力支持。
177 0

相关产品

  • 函数计算