django web项目部署到阿里云函数计算平台

阿里云函数计算平台

  阿里云函数计算(FC),旨在帮助用户采用弹性伸缩、动态分配资源的方式,来执行业务逻辑.让用户无需购买部署服务器,无需考虑业务负载,就能快速搭建可处理高并发的后台服务.

  基于WSGI标准的项目能够很方便的迁移至函数计算平台. 本文介绍如何将一个通用的django web项目,通过FC提供的fun命令行工具快速部署到FC平台。

1. django web项目预览
  示例项目是一个简单的值班oncall系统,按照人员列表已一周为周期排班,并支持钉钉群发消息推送.
django项目目录结构:
  django web项目部署到阿里云函数计算平台


2. 部署到函数计算平台

  • 2.1 在项目目录安装依赖库(很重要)
      FC平台上函数的运行环境对不同语言都有部分默认支持的三方库可直接使用,请参考:函数计算python运行环境文档

  对于其他的依赖库,用户需自行安装在项目目录,发布时fun工具会将这些库以及用户代码一并打包上传到FC平台. 示例中需要安装django以及数据库工具pymsql

  • 安装django

    pip install -t . django
  • 安装pymysql

    pip install -t . pymysql

    django中python2.7使用pymysql, 必须先修改下安装为MySQLdb:
    django web项目部署到阿里云函数计算平台
    安装完成后项目目录结构:
    django web项目部署到阿里云函数计算平台


  • 2.2 设置静态资源路径
    为了让系统在FC上运行时,能找到对应的静态资源文件(js/css),必须先修改配置下静态资源路径
  • 修改settings.py
    django web项目部署到阿里云函数计算平台

      STATIC_URL = '/static/'
      # STATICFILES_DIRS = [
      #     os.path.join(BASE_DIR, "static"),
      # ]
    
      STATIC_FC_URL = STATIC_URL
      STATIC_ROOT = os.path.join(BASE_DIR, 'static')
  • 修改urls.py
    为上面配置的资源路径,设置url映射.

    from django.conf.urls import url
    from django.conf import settings
    from django.conf.urls.static import static
    
    urlpatterns += static(settings.STATIC_FC_URL, document_root=settings.STATIC_ROOT)
  • 修改静态页面中引用方式:
    django web项目部署到阿里云函数计算平台
    django web项目部署到阿里云函数计算平台


  • 2.3 创建入口文件main.py

      # coding=utf-8
      import sys
      import os
    
      # load local django
      sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
      sys.path.append(os.path.join(os.path.dirname(os.path.abspath(__file__)), "OnCallSys(改成你的工程目录)"))
      import django
    
      from django.conf import settings
      print (django.__version__)
    
      import urlparse
      from OnCallSys.wsgi import application
    
      base_path = None
    
      def handler(environ, start_response):
          request_uri = environ['fc.request_uri']
          parsed_tuple = urlparse.urlparse(request_uri)
          li = parsed_tuple.path.split('/')
          global base_path
          if not base_path:
              base_path = "/".join(li[0:5])
              settings.STATIC_URL = base_path + settings.STATIC_FC_URL
    
          context = environ['fc.context']
          environ['HTTP_HOST'] = '{}.{}.fc.aliyuncs.com'.format(context.account_id, context.region)
          environ['SCRIPT_NAME'] = base_path + '/'
    
          return application(environ, start_response)


  • 2.4 创建文件tick.py定时调用Oncall系统的/tick接口(非必要,只是OnCall系统的示例所需)

    # -*- coding: utf-8 -*-
    import logging
    import os
    import hashlib
    
    from OnCallSys.views.Util import Util
    
    def handler(event, context):
        print 'tick ...'
        url = os.environ['TICK_URL']
        name = os.environ['ADMIN_NAME']
        pwd = os.environ['ADMIN_PWD']
        pwd_md5 = hashlib.md5(pwd).hexdigest()
        url += '?username=' + name + '&pwd=' + pwd_md5
        print Util.http_get(url)


  • 2.5 编写FC fun工具的部署配置文件(保存到工程根目录)
  • .env文件

    DEFAULT_REGION=cn-hangzhou
    ACCOUNT_ID=
    ENDPOINT=
    ACCESS_KEY_ID=
    ACCESS_KEY_SECRET=
  • templates.yml

    ROSTemplateFormatVersion: '2015-09-01'       # 无需修改 
    Transform: 'Aliyun::Serverless-2018-04-03'   # 无需修改
    
    Resources:
    
      oncall-log:    # 创建logproject和logstore(需事先在阿里云平台开通日志服务)
        Type: 'Aliyun::Serverless::Log'
        Properties:
          Description: 'oncall system log'
    
        oncall-logstore:
          Type: 'Aliyun::Serverless::Log::Logstore'
          Properties:
              TTL: 362
              ShardCount: 1
    
      oncall-service:  # 1. 创建service, 名字随意取(可以理解为存放代码的包)
        Type: 'Aliyun::Serverless::Service'
        Properties:
          Description: 'oncall system'
          Policies:    # 设置权限
            - AliyunOSSFullAccess  # OSS[对象存储服务]权限(需事先在阿里云平台开通)
            - AliyunLogFullAccess  # log权限
    
          LogConfig:  # 配置项目的输出日志
            Project: oncall-log        # 上面创建的logproject
            Logstore: oncall-logstore  # 上面创建的logstore
    
          InternetAccess: true  # 设置项目代码是否能访问公网
    
        oncall:    # 2. 创建function, oncall函数对应本地的main.py文件
          Type: 'Aliyun::Serverless::Function'
          Properties:
            Handler: main.handler  # 入口函数main.py的handler函数
            CodeUri: './'
            Description: 'oncall system function'
            Runtime: python2.7
            Timeout: 60
            MemorySize: 512
            EnvironmentVariables:  # 函数oncall的环境变量, 可在本函数中读取, 并能够在控制台修改
              'CUSTOM_DB_NAME': ''
              'CUSTOM_DB_USER': 
              'CUSTOM_DB_PWD': 
              'CUSTOM_DB_HOST':
              'CUSTOM_DB_PORT': '3306'
              'WEB_HOOK_URL':
              'ONCALL_SYS_URL':
              'ADMIN_NAME':
              'ADMIN_PWD': 
              'TOKEN_EXPIRE':
    
          Events:           # 函数oncall的事件触发器, 这里web服务用的是http触发器
            http-trigger:   # trigger name
              Type: HTTP    # trigger type
              Properties:
                AuthType: ANONYMOUS   # 匿名访问
                Methods: ['GET', 'POST']
    
        tick:    # 创建function,tick函数(类似上面的oncall函数, 不需要可以不创建,只是示例所需)
          Type: 'Aliyun::Serverless::Function'
          Properties:
            Handler: tick.handler
            CodeUri: './'
            Description: 'oncall system tick function'
            Runtime: python2.7
            Timeout: 60
            MemorySize: 512
            EnvironmentVariables:
              'TICK_URL':           
              'ADMIN_NAME': 
              'ADMIN_PWD': 
    
          Events:
            tick-trigger:   # trigger name
              Type: Timer   # 定时触发器, 会根据以下cron表达式的规则定时触发当前函数
              Properties:
                  CronExpression: '0 0 1 ? * MON-FRI' # utc+8, 9:00 am, 周一到周五
                  Enable: true

    PS: yml文件对indent有严格要求,请注意各行代码的indent


  •  2.6 部署到FC函数计算
  • 在django工程根目录下执行

    fun deploy

    django web项目部署到阿里云函数计算平台
    部署成功!


  • 在阿里云FC控制台查看
    django web项目部署到阿里云函数计算平台

  django web项目部署到阿里云函数计算平台


  • 使用测试
    django web项目部署到阿里云函数计算平台

在浏览器中输入复制的链接地址即可访问django项目中对应的web资源(页面或API)
django web项目部署到阿里云函数计算平台

到此,恭喜迁移成功!


问题解答
Q: 代码中怎么使用template.yml中配置的环境变量
A: 通过os.environ字典读取
django web项目部署到阿里云函数计算平台

Q: 本地测试时怎么设置环境变量
A: 可在settings.py中添加测试代码(部署时注释掉)
django web项目部署到阿里云函数计算平台



相关链接:

  1. 阿里云函数计算使用文档
  2. FC fun工具安装
  3. FC fun工具使用部署文档

如果您有任何反馈或疑问,欢迎通过 阿里云聆听官方论坛云栖社区 联系我们。您也可以加入钉钉用户群(钉钉群号:11721331)与函数计算工程师即时沟通。
django web项目部署到阿里云函数计算平台

上一篇:GitHub排名前20的Pandas, NumPy 和SciPy函数


下一篇:MySQL:级联删除操作