快速开始使用AppServer并部署至函数计算-视频点播-阿里云-视频点播(VOD)-阿里云帮助中心

本文介绍如何快速使用AppServer，完成从安装到首次API调用。

重要

调用视频点播实体类和播单类接口需提交工单加白后方可使用。

快速体验

克隆项目。

git clone https://github.com/MediaBox-Demos/VodAppServer.git
cd VodAppServer

配置密钥和地域。

在application.yml文件中进行如下配置：

aliyun:
  vod:
    ak: YOUR_ACCESS_KEY_ID      # 阿里云 AccessKey ID
    sk: YOUR_ACCESS_KEY_SECRET  # 阿里云 AccessKey Secret
    region: cn-shanghai         # 地域标识（必须与 VOD 控制台开通区域一致）

说明

AccessKey的获取请参见创建AccessKey。
region地域需与点播控制台开通区域一致。

启动服务。

mvn spring-boot:run

启动成功日志如下，Region需与第2步中配置区域保持一致。

VOD 客户端初始化成功，Region: cn-shanghai
Started Application in 5.234 seconds

测试接口。

# 获取播单列表
curl -X POST http://localhost:9000/appServer/getPlaylists \
  -H "Content-Type: application/json" \
  -d '{"pageNo":"1","pageSize":"10"}'

测试成功完成快速体验流程。

部署到阿里云函数计算

阿里云函数计算(FC)支持Serverless部署，无需运维，按量计费。

构建项目。

# 进入项目目录
cd VodAppServer

# Maven 打包
mvn clean package

# 打包成功后，生成 target/VodAppServer-1.0-SNAPSHOT.jar

准备部署包。

# 创建部署目录结构
mkdir -p deploy/VodAppServer/target

# 复制 JAR 文件
cp target/VodAppServer-1.0-SNAPSHOT.jar deploy/VodAppServer/target/

# 进入部署目录
cd deploy

# 压缩成 ZIP 文件
zip -r VodAppServer.zip VodAppServer/

目录结构如下；

VodAppServer.zip
└── VodAppServer/
    └── target/
        └── VodAppServer-1.0-SNAPSHOT.jar

创建函数。
1. 进入函数计算（FC）控制台函数页面，点击创建函数。
2. 选择Web函数，单击创建Web函数。其中：
  - 内存：建议选择1024MB。
  - 运行环境：建议选择自定义运行时 > Java > Java8。
  - 代码上传方式：建议选择通过ZIP包上传代码。
  - 代码包：上传第2步创建的VodAppServer部署包。
  - 启动命令：java -jar /code/VodAppServer/target/VodAppServer-1.0-SNAPSHOT.jar。
  - 环境变量：在高级配置 > 更多配置 中添加ACCESS_KEY_ID、ACCESS_KEY_SECRET和ALIYUN_VOD_REGION，分别对应AccessKey ID、AccessKey Secret和所属地域。
  - 其他参数保持默认或根据您的实际需求进行更改。
3. 确认配置无误后，点击创建。
创建触发器。
1. 在函数详情页，点击触发器标签。
2. 点击创建触发器，进入编辑页，选择HTTP触发器。其中，认证方式建议选择无需认证，其他参数保持默认或根据您的实际需求进行更改。
3. 确认配置无误后，点击确定。

测试部署。

使用生成的公网地址测试：

# 替换为您的实际地址
curl -X POST https://vod-app-function-xxx.cn-shanghai.fcapp.run/appServer/getPlaylists \
  -H "Content-Type: application/json" \
  -d '{"pageNo":"1","pageSize":"10"}'

常见问题

函数启动失败如何处理

可以通过以下步骤排查：

请确认VodAppServer.zip包目录结构正确。
请确认创建函数时配置的启动命令正确。
请确认构建项目时打包JAR文件的完整性。

环境变量未生效如何处理

请确认环境变量名称正确，保存后重启函数，并在项目中通过System.getenv() 获取。

如何更新部署代码

需要重新打包生成VodAppServer.zip包上传，函数将自动重启。