本文介绍如何通过fun build将源码构建成交付产物。

背景信息

源码并不等于交付产物,例如Java型编译语言,您写好Java型代码后,不能直接上传代码,您还需要进行编译及打包,编译及打包的结果属于交付产物。由于函数计算只能接受一个ZIP包或JAR包,所以您需要将代码交付产物及其依赖一同打包到一个JAR包中,然后交付。

使用fun build的构建过程可以理解为,Funcraft工具在函数代码目录中查找特定的manifest文件(清单文件)并根据manifest文件进行构造、下载依赖及编译。

目前Funcraft工具针对不同的语言分别支持一些主流的包管理器manifest文件。
  • Funcraft定义的不限语言的Funfile文件。更多信息,请参见使用fun install安装第三方依赖
  • Java maven包管理器的pom.xml文件。
  • Node.js npm包管理器的package.json文件。
  • Python pip包管理器的requirements.txt文件。
  • PHP composer包管理器的composer.json文件。

fun build功能介绍

执行以下命令获取fun build的相关功能介绍。
fun build -h
预期输出:
Usage: fun build [options] [[service/]function]

Build the dependencies.

Options:
  -d, --use-docker           Use docker container to build functions
  -t, --template [template]  The path of fun template file.
  -h, --help                 display help for command

操作步骤

本文以Java8为例,介绍如何构建交付产物。

  1. 在函数根目录下新建一个template.yml文件,例如/tmp/code/template.yml,具体信息,请参见template.yml,文件内容修改如下。
    ROSTemplateFormatVersion: '2015-09-01'
    Resources:
      Services:
        Type: 'Aliyun::Serverless::Service'
        Properties:
          Policies:
            - AliyunOSSFullAccess
        Function:
          Type: 'Aliyun::Serverless::Function'
          Properties:
            Handler: main.main_handler
            Runtime: java8
            CodeUri: './'

    template.yml的含义如下:声明一个名为Services的服务,在这个服务下,声明一个名为Function的函数,配置函数入口为main.main_handler,函数的Runtime为java8,并指定CodeUri为当前目录。在部署时,Funcraft会将CodeUri指定的目录打包上传。

  2. 您可以通过以下方式构建源代码:
    • 直接执行以下命令构建。
      fun build
    • 指定函数名称进行构建,<your functionName>需替换为您的函数的名称,例如Function
      fun build <your functionName>
    • 指定函数及服务名称进行构建,<your serviceName>/<your functionName>需替换为您的服务及函数的名称,例如Services/Function
      fun build <your serviceName>/<your functionName>
    以上三种构建方式的预期输出一致,如下所示。
    using template: template.yml
    start building function dependencies without docker
    
    building Services/Function
    
    Build Success
    
    Built artifacts: .fun\build\artifacts
    Built template: .fun\build\artifacts\template.yml
    
    Tips for next step
    ======================
    * Invoke Event Function: fun local invoke
    * Invoke Http Function: fun local start
    * Deploy Resources: fun deploy
    说明
    • 默认情况下,fun build可以直接在宿主机上构建,如果想避免因为环境差异带来部署后的不兼容问题,可以在构建时指定-u--use-docker参数,表示会在本地使用函数计算模拟环境进行编译。
    • 如果template.yml不在当前目录下,您可以通过fun build -t templatePath的方式指定。
    • fun build是将template.yml中列出的函数进行构建,如果不指定具体函数,则默认编译所有函数。

更多信息

您可以通过以下方式进行构建或其他操作:
  • 通过以下命令对template.yml文件中的所有函数进行构建。
    fun build 
  • 通过以下命令以本地模拟环境对所有函数进行构建。
    fun build --use-docker 
  • 通过以下命令进行构建及调用。
    fun build && fun local invoke
  • 通过以下命令进行构建及部署。
    fun build && fun deploy  

构建示例

以下是一个初始化、构建、运行及修改Java的示例。

build_java