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.7.0

示例

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 直接发布到远端。
Serverless 解惑——函数计算如何安装字体

4. 预览线上效果

fun deploy 部署过程中，会为此函数生成有时效性的临时域名：
Serverless 解惑——函数计算如何安装字体
打开浏览器，输入临时域名并回车：

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

可以看到字体 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 进行反馈。