Python运行环境 - 函数计算

打印日志

函数stdout打印的内容会被收集到创建服务时指定的Logstore中，在这里有两种打印日志的方法：

• 使用logging模块打印日志。该方法打印的每条日志中都包含时间、RequestId、日志级别等信息。

  import logging
  
  def my_handler(event, context):     
      logger = logging.getLogger()     
      logger.info('hello world')     
      return 'done'

  执行上面的代码输出的日志内容如下所示。

  message:2017-07-05T05:13:35.920Z a72df088-f738-cee3-e0fe-323ad****e5 [INFO]   hello world

  说明 在这里推荐使用logging模块打印日志。因为该方法打印的日志自动包含RequestId信息，方便在出错的时候定位问题日志。
• 直接使用print打印，把内容原样地输出到日志中。

  def my_handler(event, context):      
      print 'hello world'      
      return 'done'

  执行上面的代码输出的日志内容如下所示。

  message:hello world

错误处理

函数在执行过程如果抛出异常，那么函数计算会把异常捕获并将异常信息返回，示例如下所示。

def my_handler(event, context):   
    raise Exception('something is wrong')

调用函数时收到的响应如下所示。

{    
    "errorMessage": "something is wrong",    
    "errorType": "Exception",    
    "stackTrace": [       
        [            
            "File \"/code/index.py\"",           
            "line 2",            
            "in my_handler",            
            "raise Exception('something is wrong')"        
        ]    
    ]
}

发生异常时，函数调用的响应的HTTP header中会包含X-Fc-Error-Type: UnhandledInvocationError。函数计算的错误类型的更多信息，请参见错误处理。

内置模块

除了Python的标准模块，函数计算的Python运行环境中还包含了一些常用模块，您可以直接引用，目前包含的模块如下所示。

访问OSS的示例代码如下所示。

import json
import oss2
def my_handler(event, context):
    evt = json.loads(event)
    creds = context.credentials
    # do not forget security_token
    auth = oss2.StsAuth(creds.access_key_id, creds.access_key_secret, creds.security_token)
    bucket = oss2.Bucket(auth, evt['endpoint'], evt['bucket'])
    bucket.put_object(evt['objectName'], evt['message'])
    return 'success'

自定义模块

如果您需要使用自定义的模块，则需要将自定义模块与代码一起打包上传。您可以通过pip包管理器进行依赖管理，如果您使用Funcraft部署应用，可以使用fun install命令来安装依赖。

• 使用pip包管理器进行依赖管理

  通过pip install -t .命令安装依赖库至函数根目录下。上传代码库时将依赖库一同打包上传。下文以安装PyMySQL库为例进行详细介绍。

  1. 建立一个目录，用于存放代码和依赖模块。

     mkdir /tmp/code

  2. 在/tmp/code目录下安装依赖。

     cd /tmp/code
     pip install -t . PyMySQL

  3. 新建代码文件，例如/tmp/code/index.py，在代码中使用PyMySQL。

     import pymysql.cursors
     # Connect to the database
     connection = pymysql.connect(host='localhost',
                                  user='user',
                                  password='passwd',
                                  db='db',
                                  charset='utf8mb4',
                                  cursorclass=pymysql.cursors.DictCursor)
     def handler(event, context):
      with connection.cursor() as cursor:
          # Read a single record
          sql = "SELECT count(*) FROM `users`"
          cursor.execute(sql)
          result = cursor.fetchone()
          print(result)
          return result

  4. 打包上传。

     打包时，需要针对文件进行打包，而不是针对代码整体目录进行打包。打包完成后，入口函数文件需要位于包内的根目录。

     • 在Windows下打包时，可以进入函数代码目录，全选所有文件以后，单击鼠标右键，选择压缩为zip包，生成代码包。
     • 在Linux下打包时，通过调用zip命令时，将源文件指定为代码目录下的所有文件，实现生成部署代码包，例如zip code.zip /home/code/*。

     打包后，您通过函数计算控制台代码执行页面，您可以选择OSS上传或代码包上传方式上传代码包。

• 使用fun install安装依赖。

  如果您使用Funcraft部署应用，可以使用fun install命令来安装依赖。关于使用Funcraft的部署应用请参见功能概览，关于fun install的详细信息请参见使用fun install安装第三方依赖。

  下文以安装PyMySQL库为例进行详细介绍。

  1. 在函数根目录下初始化Funfile文件。

     fun install init
     ? Select a runtime   
       nodejs8   
       nodejs10   
       python2.7 
     ? python3   
       java8   
       php7.2   
       dotnetcore2.1 
      (Move up and down to reveal more choices)

  2. 选择python3后，会在当前目录生成一个名为Funfile的文件，编辑文件内容。

     RUNTIME python3
     RUN fun-install pip install PyMySQL

  3. 新建template.yml文件，例如/tmp/code/template.yml，详情请参见template.yml，内容如下。

     ROSTemplateFormatVersion: '2015-09-01'
     Transform: 'Aliyun::Serverless-2018-04-03'
     Resources:
     FunDemo:  
      Type: 'Aliyun::Serverless::Service' 
      pythondemo:    
        Type: 'Aliyun::Serverless::Function'   
        Properties:     
          Handler: index.handler     
          Runtime: python3     
          CodeUri: './'

     这个template.yml的含义如下：声明名为FunDemo的服务，在这个服务下，声明一个名为pythondemo的函数，配置函数入口为index.handler，函数的runtime为python3，并指定CodeUri为当前目录。在部署时，Fun会将CodeUri指定的目录打包上传。

     详情请参见：

     • 函数计算服务属性
     • 函数计算函数属性
     • CodeUri说明
     • 更多的配置规则
  4. 在函数根目录下执行fun install命令安装依赖。

     fun install

     返回结果如下。

     using template: template.yml
     start installing function dependencies without docker
     
     building FunDemo/pythondemoFunfile exist, 
     Fun will use container to build forcely
     Step 1/2 : FROM registry.cn-beijing.aliyuncs.com/aliyunfc/runtime-python3.6:build-1.9.4
     ---> 702c91653452
     Step 2/2 : RUN fun-install pip install PyMySQL
     ---> Using cache
     ---> 8f59062f15bb
     sha256:8f59062f15bb7a86bd59b85e3b61bd0e4ed711c536fe0cd10fdefebc78eae152
     Successfully built 8f59062f15bb
     Successfully tagged fun-cache-a6f4221c-33c8-4050-93b8-015e42396475:latest
     copying function artifact to /Users/txd123/Desktop/express
     
     Install Success
     
     
     Tips for next step
     ======================
     * Invoke Event Function: fun local invoke
     * Invoke Http Function: fun local start
     * Build Http Function: fun build
     * Deploy Resources: fun deploy

  5. 执行以下命令部署应用。

     fun deploy -y

     返回结果如下。

     using template: template.yml
     using region: cn-hangzhou
     using accountId: ***********3743using accessKeyId: ***********Ptgk
     using timeout: 60
     
     Collecting your services information, in order to caculate devlopment changes...
     
     Resources Changes(Beta version! Only FC resources changes will be displayed):
     
     ┌────────────┬──────────────────────────────┬────────┬──────────┐
     │ Resource   │ ResourceType                 │ Action │ Property │
     ├────────────┼──────────────────────────────┼────────┼──────────┤
     │            │                              │        │ Handler  │
     │            │                              │        ├──────────┤
     │ pythondemo │ Aliyun::Serverless::Function │ Add    │ Runtime  │
     │            │                              │        ├──────────┤
     │            │                              │        │ CodeUri  │
     └────────────┴──────────────────────────────┴────────┴──────────┘
     
     Waiting for service FunDemo to be deployed...      
           Waiting for function pythondemo to be deployed...              
                   Waiting for packaging function pythondemo code...              
                   The function pythondemo has been packaged. A total of 51 files were compressed and the final size was 114.35 KB
           function pythondemo deploy success
     service FunDemo deploy success

  登录函数计算控制台，即可看到相关的服务、函数被创建成功，且触发执行可以返回正确的结果。

调用外部命令

您的函数可能会用到一些工具，而这些工具并不是用Python写的（例如Shell、C++ 、Go编译出来的可执行文件）。您仍然可以将这些工具与代码一起打包，然后在函数中通过运行外部命令的方法来使用这些工具。

您可以使用Funcraft工具安装依赖，具体内容请参见使用fun install安装第三方依赖。下文以运行环境为python2.7，安装mysql-python（含有.so文件）为例。

可以直接在代码目录执行fun install --runtime python2.7 --package-type pip mysql-python命令 ，即可安装好依赖。

下面的代码演示了如何运行一个Shell脚本。

import os
import subprocess

def my_handler(event, context):    
    script_path = os.environ.get('FC_FUNC_CODE_PATH') + '/script.sh'    
    ret = subprocess.check_output(['bash', script_path])    
    return ret