Serverless 解惑——函数计算如何安装字体

前言

首先介绍下在本文出现的几个比较重要的概念：

函数计算（Function Compute）：函数计算是一个事件驱动的服务，通过函数计算，用户无需管理服务器等运行情况，只需编写代码并上传。函数计算准备计算资源，并以弹性伸缩的方式运行用户代码，而用户只需根据实际代码运行所消耗的资源进行付费。函数计算更多信息参考 Fun：Fun 是一个用于支持 Serverless 应用部署的工具，能帮助您便捷地管理函数计算、API 网关、日志服务等资源。它通过一个资源配置文件（template.yml），协助您进行开发、构建、部署操作。Fun 的更多文档参考。

备注: 本文介绍的技巧需要 Fun 版本大于等于 3.6.7。

函数计算运行环境中内置一些常用字体，但仍不满足部分用户的需求。如果应用中需要使用其它字体，需要走很多弯路。本文将介绍如何通过 Fun 工具将自定义字体部署到函数计算，并正确的在应用中被引用。

你需要做什么

在代码（CodeUri）目录新建一个 fonts 目录；
将字体复制到 fonts 目录；
使用 fun deploy 进行部署。

工具安装

建议直接从这里下载二进制可执行程序，解压后即可直接使用。下载地址

执行 fun --version 检查 Fun 是否安装成功。

$ fun --version

3.6.7

示例

demo 涉及的代码，托管在 github 上。项目目录结构如下：

$ tree -L -a 1

├── index.js

├── package.json

└── template.yml

index.js 中代码：

'use strict';



var fontList = require('font-list')



module.exports.handler = async function (request, response, context) {

 response.setStatusCode(200);

 response.setHeader('content-type', 'application/json');

 response.send(JSON.stringify(await fontList.getFonts(), null, 4));

};

index.js 中借助 node 包 font-list 列出系统上可用的字体。

template.yml：

ROSTemplateFormatVersion: '2015-09-01'

Transform: 'Aliyun::Serverless-2018-04-03'

Resources:

  fonts-service: # 服务名

    Type: 'Aliyun::Serverless::Service'

    Properties:

      Description: fonts example

    fonts-function: # 函数名

      Type: 'Aliyun::Serverless::Function'

      Properties:

        Handler: index.handler

        Runtime: nodejs8

        CodeUri: ./

        InstanceConcurrency: 10

      Events:

        http-test:

          Type: HTTP

          Properties:

            AuthType: ANONYMOUS

            Methods:

              - GET

              - POST

              - PUT

  tmp_domain: # 临时域名

    Type: 'Aliyun::Serverless::CustomDomain'

    Properties:

      DomainName: Auto

      Protocol: HTTP

      RouteConfig:

        Routes:

          /:

            ServiceName: fonts-service

            FunctionName: fonts-function

template.yml 中定义了名为 fonts-service 的服务，此服务下定义一个名为 fonts-function 的 http trigger 函数。tmp_domain 中配置自定义域名中路径（/）与函数（fonts-service/fonts-function）的映射关系。

1. 下载字体

你可以通过这里下载自定义字体 Hack，然后复制字体到 fonts 目录。

此时 demo 目录结构如下：

$ tree -L 2 -a



├── fonts（+）

│   ├── Hack-Bold.ttf

│   ├── Hack-BoldItalic.ttf

│   ├── Hack-Italic.ttf

│   └── Hack-Regular.ttf

├── index.js

├── package.json

└── template.yml

2. 安装依赖

$ npm install

3. 部署到函数计算

可以通过 fun deploy 直接发布到远端。

4. 预览线上效果

fun deploy 部署过程中，会为此函数生成有时效性的临时域名：

打开浏览器，输入临时域名并回车：

可以看到字体 Hack 已生效！！！

原理介绍：

fun deploy 时，如果检测到 CodeUri 下面有 fonts 目录，则为用户在 CodeUri 目录生成一个 .fonts.conf 配置文件。在该配置中，相比于原来的 /etc/fonts/fonts.conf 配置，添加了 /code/fonts 作为字体目录。
自动在 template.yml 中添加环境变量，FONTCONFIG_FILE = /code/.fonts.conf，这样在函数运行时就可以正确的读取到自定义字体目录。

如果依赖过大，超过函数计算的限制（50M）则：

将 fonts 目录添加到 .nas.yml；
将 fonts 对 nas 的映射目录追加到 .fonts.conf 配置。

fun deploy 对大依赖的支持可参考《开发函数计算的正确姿势——轻松解决大依赖部署》

总结

你只需要在代码（CodeUri）目录新建一个 fonts 目录，然后复制所有字体到该目录即可。Fun 会自动帮你处理配置文件（.fonts.conf），环境变量以及大依赖场景的情况。如果大家在使用 Fun 的过程中遇到了一些问题，可以在 github 上提 issue，或者加入我们的钉钉群进行反馈（钉钉搜索群号 11721331 即可进群）。