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

本章节将以使用容器镜像方式创建HTTP类型函数为例，介绍容器镜像函数的创建及测试过程。此过程中用户需要在镜像中实现一个http server，并监听8000（下文示例中提及的8000端口请不要变动）端口接收请求。备注：HTTP函数只支持APIG触发器。

1. 创建一个空文件夹

   mkdir custom_container_http_example && cd custom_container_http_example

2. 以Nodejs语言为例，实现一个Http Server，其他语言请参考创建HTTP函数。

   创建一个main.js文件，引入express框架，接收POST请求，打印请求Body到标准输出并返回Hello FunctionGraph, method POST给客户端。

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

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

   {
     "name": "custom-container-http-example",
     "version": "1.0.0",
     "description": "An example of a custom container http 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 main.js命令启动容器，请勿修改。
   

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

5. 构建镜像

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

   docker build -t custom_container_http_example:latest .

步骤六：查看执行结果

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

图1 执行结果

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

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