使用容器镜像创建并执行事件函数

本章节将以使用容器镜像方式创建事件函数为例，介绍容器镜像函数的创建及测试过程。用户需要在镜像中实现一个http server，并监听8000端口接收请求。其中，请求路径/init 默认为函数初始化入口，请根据需要实现该接口。请求路径/invoke为函数执行入口，触发器事件转到该接口处理，请求参数请参见函数支持的事件源。

1. 创建一个空文件夹

   mkdir custom_container_event_example && cd custom_container_event_example

2. 以Nodejs语言为例，实现一个Http Server，处理函数初始化init请求和函数调用invoke请求并响应。

   创建一个main.js文件，引入express框架，实现Method为POST和Path为/invoke的函数执行入口，实现Method为POST和Path为/init的函数初始化入口。

   const express = require('express'); 
    
   const PORT = 8000; 
    
   const app = express(); 
   app.use(express.json());
    
   app.post('/init', (req, res) => { 
     console.log('receive', req.body);
     res.send('Hello init\n'); 
   }); 
    
   app.post('/invoke', (req, res) => { 
     console.log('receive', req.body);
     res.send('Hello invoke\n'); 
   }); 
    
   app.listen(PORT, () => { 
     console.log(`Listening on http://localhost:${PORT}`); 
   });

3. 创建一个package.json文件，此文件用于向npm提供信息，使其能够识别项目以及处理项目的依赖关系。

   {
     "name": "custom-container-event-example",
     "version": "1.0.0",
     "description": "An example of a custom container event function",
     "main": "main.js",
     "scripts": {},
     "keywords": [],
     "author": "",
     "license": "ISC",
     "dependencies": {
         "express": "^4.17.1"
     }
   }

   • name：值为项目名。
   • version：值为项目版本。
   • main：列举文件为程序的入口文件。
   • dependencies：列出npm上可用的项目的所有依赖项。
4. 创建Dockerfile文件

   FROM node:12.10.0
   
   ENV HOME=/home/custom_container
   ENV GROUP_ID=1003
   ENV GROUP_NAME=custom_container
   ENV USER_ID=1003
   ENV USER_NAME=custom_container
   
   RUN mkdir -m 550 ${HOME} && groupadd -g ${GROUP_ID} ${GROUP_NAME} && useradd -u ${USER_ID} -g ${GROUP_ID} ${USER_NAME}
   
   COPY --chown=${USER_ID}:${GROUP_ID} main.js ${HOME}
   COPY --chown=${USER_ID}:${GROUP_ID} package.json ${HOME}
   
   RUN cd ${HOME} && npm install
   
   RUN chown -R ${USER_ID}:${GROUP_ID} ${HOME}
   
   RUN find ${HOME} -type d | xargs chmod 500
   RUN find ${HOME} -type f | xargs chmod 500
   
   USER ${USER_NAME}
   WORKDIR /${HOME}
   
   EXPOSE 8000
   ENTRYPOINT ["node", "main.js"]

   • FROM：指定基础镜像为node:12.10.0，基础镜像必须设置，值可修改。
   • ENV：设置环境变量，设置HOME环境变量为/home/custom_container，设置GROUP_NAME和USER_NAME为custom_container，USER_ID和GROUP_ID为1003，这些环境变量必须设置，值可修改。
   • RUN：格式为RUN <命令>，例如RUN mkdir -m 550 ${HOME}表示构建容器时创建${USER_NAME}用户的home目录。
   • USER：切换${USER_NAME}用户。
   • WORKDIR：切换工作目录到${USER_NAME}用户的“/${HOME}”目录下。
   • COPY：将main.js和package.json拷贝到容器的${USER_NAME}用户的home目录下。
   • EXPOSE：暴露容器的8000端口，请勿修改。
   • ENTRYPOINT：使用node /home/tester/main.js命令启动容器。
   

   1. 可以使用任意基础镜像。
   2. 在云上环境会默认使用uid 1003，gid 1003 启动容器。uid、gid可以在函数页面的“设置 > 常规设置 >容器镜像覆盖”板块中修改，但不可以是root或其他保留id。
   3. 如果使用Alpine版的基础镜像，请使用“addgroup”和“adduser”命令。

5. 构建镜像

   指定镜像的名称为custom_container_event_example，版本为latest，“.”指定Dockerfile所在目录，镜像构建命令将该路径下所有的内容打包给容器引擎帮助构建镜像。

   docker build -t custom_container_event_example:latest .

步骤六：查看执行结果

单击helloworld事件的“测试”，执行后，在右侧查看执行结果，执行结果如下图。

图1 执行结果

• “函数返回”显示函数的返回结果。
• “日志”部分显示函数执行过程中生成的日志。
• “执行摘要”部分显示“日志”中的关键信息。
  

  此页面最多显示2K日志，了解函数更多日志信息，请参考查询日志。