使用Web函数快速创建一个Web应用

1. 开发及测试Web应用

1. 请在本地打开一个新的命令行窗口，执行以下命令，将应用所需的Flask和tabulate依赖库安装到本地环境：

   pip install Flask tabulate

2. 创建一个名为code的文件夹，并在其中新建一个名为app.py的文件。将以下示例代码粘贴到该文件中。这段代码实现了一个简单的日历服务并封装成API接口，用户输入年月信息（如2025年1月），API将返回对应的日历表格。

   import calendar
   from flask import Flask, request
   from tabulate import tabulate
   import logging
   import json
   
   logger = logging.getLogger()
   app = Flask(__name__)
   
   
   @app.route("/", methods=["POST"])
   def get_month_calendar():
       # 获取请求ID并打印日志
       requestId = request.headers.get('x-fc-request-id', '')
       logger.info("FC Invoke Start RequestId: " + requestId)
       # 获取请求内容并检查请求格式
       data = json.loads(request.stream.read().decode('utf-8'))
       if not ('year' in data and 'month' in data):
           message = "Request must be in format like {'year': '1999', 'month': '12'}"
           return message
   
       # 获取日历表格
       result = print_calendar(year=int(data['year']), month=int(data['month']))
       # 返回前打印函数执行完成的日志
       logger.info("FC Invoke End RequestId: " + requestId)
       return result
   
   
   def print_calendar(year, month):
       # 获取指定年份和月份的日历矩阵
       cal = calendar.monthcalendar(year, month)
       # 将不属于该月的日期从0转为空字符
       cal = list(map(lambda sublist: list(map(lambda x: '' if x == 0 else x, sublist)), cal))
       # 创建表头
       headers = ["Mo", "Tu", "We", "Th", "Fr", "Sa", "Su"]
   
       # 使用tabulate打印日历表格
       return tabulate(cal, headers=headers, tablefmt="grid", stralign='center', numalign='center')
   
   
   if __name__ == "__main__":
       app.run(host='0.0.0.0', port=9000)
   

3. 执行python3 app.py命令以运行您创建的Flask应用。当输出为Running on http://127.0.0.1:9000，表示您的Flask应用成功启动，接下来可以使用cURL命令来测试应用。

   python3 app.py 
    * Serving Flask app 'app'
    * Debug mode: off
   WARNING: This is a development server. Do not use it in a production deployment. Use a production WSGI server instead.
    * Running on http://127.0.0.1:9000
    * Running on http://47.100.XX.XX:9000
   Press CTRL+C to quit

4. 打开一个新的终端窗口，使用cURL发送示例请求。如果执行成功，您将得到一个日历表格。

   curl -X POST http://127.0.0.1:9000 -d '{"year": "2000", "month": "1"}'

   

至此本地项目创建和测试完成。

2. 生成代码包

您将在本地构建一个适用于函数计算的代码包，代码包中需要包含以下内容：

• Web应用所需的项目文件。

• 如果应用所需的依赖库不在Web函数的运行环境中，则代码包也需要包含这些依赖库。关于Web函数运行环境的内置依赖库，请参见内置依赖项。

1. 安装依赖：在Web应用的项目根目录，请您运行以下命令，将应用所需的依赖库（示例中为tabulate）安装到该目录。完成后，项目根目录下将包含项目文件以及依赖库。

   说明

   Python Web函数的运行环境已经包含了Flask库，所以安装tabulate就可以满足示例应用的需求。

   pip install -t . tabulate

2. 打包项目根目录下的所有文件。

   Linux或macOS系统

   Windows系统

   在项目根目录，执行zip code.zip -r ./*。通过此步骤，您将打包项目文件及依赖库至一个ZIP文件，完成代码包的构建。

   说明

   请确保您具有该目录的读写权限。

   进入项目目录，选中所有文件，单击鼠标右键，选择打包为ZIP包。通过此步骤，您将打包项目文件及依赖库至一个ZIP文件，完成代码包的构建。

3. 创建Web函数并部署代码包

1. 选择函数类型：打开函数计算 3.0控制台。请在页面左上方地域列表，选择您需要创建函数的地域，建议选择距离您较近的地域（如华东1-杭州）。然后在函数页面单击创建函数。在创建函数页面选择Web函数。

2. 选择运行环境：请根据图示选择自定义运行时 > Python > Python 3.10，该运行时内置了Flask框架所需的依赖库。

   说明

   • 对于Web函数推荐您搭配自定义运行时作为函数运行环境，这是因为自定义运行时可以自定义启动命令和监听端口，并且支持单实例多并发。而内置运行时则不具备这些特性，该环境更适合用于处理云产品产生的事件。

   • 如果您倾向于容器化部署，也可以使用自定义镜像创建Web函数，该环境同样支持单实例多并发，但您需要自行管理依赖。

   • 关于各种运行环境的详细对比，请参见函数运行环境选型。

3. 部署代码包：请根据图示操作，上传您在上一步中得到的ZIP格式的代码包，并配置启动命令为python3 app.py，监听端口为9000。如果您是迁移现有的Flask应用，请根据实际的启动命令和端口修改配置（例如Flask的默认端口配置为5000）。

   完成后单击创建，等待函数创建完成。

4. 测试函数

1. 获取函数URL：在新创建函数的详情页面，单击配置页签，然后在左侧导航栏，选择触发器。在HTTP触发器的配置信息中单击公网访问地址，以复制地址。

   

2. 测试函数：您可以使用cURL、Postman或任何HTTP客户端调用函数，验证Flask应用的功能。以cURL为例，请在命令行中执行以下示例命令（将地址替换为上一步复制的地址）。

   curl https://******.cn-hangzhou.fcapp.run -d '{"year": "2025", "month": "1"}' 

   Web接口将打印2025年1月的日历信息，示例输出如下。

   

   说明

   此步骤的示例命令和输出仅适用于示例代码。如果您是迁移现有应用，请根据实际的接口名称和参数调用您的服务，详情请参见使用cURL测试函数。

3. （可选）通过浏览器访问函数：HTTP触发器提供的公网访问地址无法用浏览器打开（强制下载），并且只能用于测试环境。推荐您将函数绑定自定义域名，以支持浏览器访问及生产环境使用。详情请参见配置自定义域名。

5. （可选）清理资源

• 推荐您参考以下实践教程，更深入地了解Web函数：

  • 使用函数计算部署通义千问大模型实现AI对话

  • 使用函数计算快速搭建可视化NAS浏览器应用

  • 0代码，2种方式，一键部署DeepSeek系列模型

• 关于各语言添加依赖包的步骤，请参见以下文档：

  Python

  Node.js

  Java

  Go

  C#

  PHP

  Python 部署代码包

  Node.js 部署代码包

  Java 编译部署代码包

  Go 编译部署代码包

  C# 编译部署代码包

  PHP 部署代码包