Serverless

读者须知：

以下是使用 Fastify 在 AWS Lambda 和 Amazon API Gateway 架构上构建无服务器 web 应用/服务的示例。

注：使用 aws-lambda-fastify 仅是一种可行方案。

app.js

你可以简单地把初始化代码包裹于可选的 serverFactory 选项里。

当执行 lambda 函数时，我们不需要监听特定的端口，因此，在这个例子里我们只要导出 函数即可。 在 里，我们会用到它。

当像往常一样运行 Fastify 应用， 比如执行 node app.js 时 (可以用 require.main === module 来判断)， 你可以监听某个端口，如此便能本地运行应用了。

  1. const awsLambdaFastify = require('aws-lambda-fastify')
  2. const init = require('./app');
  4. const proxy = awsLambdaFastify(init())
  5. // 或
  6. // const proxy = awsLambdaFastify(init(), { binaryMimeTypes: ['application/octet-stream'] })
  8. exports.handler = proxy;
  9. // 或
  10. // exports.handler = (event, context, callback) => proxy(event, context, callback);
  11. // 或
  12. // exports.handler = (event, context) => proxy(event, context);
  13. // 或

示例

你可以在找到使用 claudia.js 的可部署的例子。

注意事项

  • 你没法操作 stream，因为 API Gateway 还不支持它。
  • API Gateway 的超时时间为 29 秒，请务必在此时限内回复。

与 AWS Lambda 和 Google Cloud Functions 不同，Google Cloud Run 是一个无服务器容器环境。它的首要目的是提供一个能运行任意容器的底层抽象 (infrastucture-abstracted) 的环境。因此，你能将 Fastify 部署在 Google Cloud Run 上，而且相比正常的写法，只需要改动极少的代码。

参照以下步骤部署 Google Cloud Run。如果你对 gcloud 还不熟悉，请看其。

为了让 Fastify 能正确地在容器里监听请求，请确保设置了正确的端口与地址：

  1. function build() {
  2.   const fastify = Fastify({ trustProxy: true })
  3.   return fastify
  4. }
  6. async function start() {
  7.   // Google Cloud Run 会设置这一环境变量，
  9.   const IS_GOOGLE_CLOUD_RUN = process.env.K_SERVICE !== undefined
  11.   // 监听 Cloud Run 提供的端口
  12.   const port = process.env.PORT || 3000
  14.   // 监听 Cloud Run 中所有的 IPV4 地址
  15.   const address = IS_GOOGLE_CLOUD_RUN ? "0.0.0.0" : undefined
  17.   try {
  18.     const server = build()
  19.     const address = await server.listen(port, address)
  20.     console.log(`Listening on ${address}`)
  21.   } catch (err) {
  22.     console.error(err)
  23.     process.exit(1)
  24.   }
  25. }
  27. module.exports = build
  29.   start()
  30. }

添加 Dockerfile

你可以添加任意合法的 Dockerfile，用于打包运行 Node 程序。在 中，你能找到一份基本的 Dockerfile。

添加 .dockerignore

添加一份如下的 .dockerignore，可以将仅用于构建的文件排除在容器之外 (能减小容器大小，加快构建速度)：

  1. Dockerfile
  2. README.md
  3. node_modules
  4. npm-debug.log
  1. gcloud builds submit --tag gcr.io/PROJECT-ID/APP-NAME

部署镜像

镜像构建之后，使用如下命令部署它：

如此，便能从 Google 云平台提供的链接访问你的应用了。

now 针对 Node.js 应用提供了零配置部署方案。要使用 now，只需要如下配置你的 now.json 文件：

  1. {
  2.   "version": 2,
  3.   "builds": [
  4.     {
  5.       "src": "api/serverless.js",
  6.       "use": "@now/node",
  7.       "config": {
  8.         "helpers": false
  9.       }
  10.     }
  11.   ],
  12.   "routes": [
  13.     { "src": "/.*", "dest": "/api/serverless.js"}
  14.   ]
  15. }

之后，写一个 api/serverless.js 文件：

  1. 'use strict'
  2. const build = require('./index')
  3. const app = build()
  4. module.exports = async function (req, res) {
  5.   await app.ready()
  6.   app.server.emit('request', req, res)
  7. }

以及一个 api/index.js 文件：

要注意的是，你得在 package.json 中使用 Node 10：

  1.   "engines": {