# fc-docker **Repository Path**: aliyun/fc-docker ## Basic Information - **Project Name**: fc-docker - **Description**: Dockerfiles for local building or running function of FC - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2025-05-08 - **Last Updated**: 2025-05-08 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README ## fc-docker [![Build Status](https://travis-ci.org/aliyun/fc-docker.svg?branch=master)](https://travis-ci.org/aliyun/fc-docker) [English](https://github.com/aliyun/fc-docker/blob/master/README-EN.md) fc docker 是对线上函数运行环境的完全模拟，并且能够让您在本地编译、运行函数。 ![fc docker nodejs6](./figures/fc-docker-nodejs6.png) 您能够通过 fc-docker 在本地机器开发测试您的函数，并且该函数的运行结果会与线上结果一致。 目前已经获得支持的 fc runtime | Runtime | Image | | ----------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [nodejs6](https://hub.docker.com/r/aliyunfc/runtime-nodejs6/tags) | ![](https://img.shields.io/github/workflow/status/aliyun/fc-docker/release%20fc-docker%20images) ![](https://img.shields.io/docker/image-size/aliyunfc/runtime-nodejs6) ![](https://img.shields.io/docker/pulls/aliyunfc/runtime-nodejs6.svg) | | [nodejs8](https://hub.docker.com/r/aliyunfc/runtime-nodejs8/tags) | ![](https://img.shields.io/github/workflow/status/aliyun/fc-docker/release%20fc-docker%20images) ![](https://img.shields.io/docker/image-size/aliyunfc/runtime-nodejs8) ![](https://img.shields.io/docker/pulls/aliyunfc/runtime-nodejs8.svg) | | [nodejs10](https://hub.docker.com/r/aliyunfc/runtime-nodejs10/tags) | ![](https://img.shields.io/github/workflow/status/aliyun/fc-docker/release%20fc-docker%20images) ![](https://img.shields.io/docker/image-size/aliyunfc/runtime-nodejs10) ![](https://img.shields.io/docker/pulls/aliyunfc/runtime-nodejs10.svg) | | [nodejs12](https://hub.docker.com/r/aliyunfc/runtime-nodejs12/tags) | ![](https://img.shields.io/github/workflow/status/aliyun/fc-docker/release%20fc-docker%20images) ![](https://img.shields.io/docker/image-size/aliyunfc/runtime-nodejs12) ![](https://img.shields.io/docker/pulls/aliyunfc/runtime-nodejs12.svg) | | [nodejs14](https://hub.docker.com/r/aliyunfc/runtime-nodejs14/tags) | ![](https://img.shields.io/github/workflow/status/aliyun/fc-docker/release%20fc-docker%20images) ![](https://img.shields.io/docker/image-size/aliyunfc/runtime-nodejs14) ![](https://img.shields.io/docker/pulls/aliyunfc/runtime-nodejs14.svg) | | [python2.7](https://hub.docker.com/r/aliyunfc/runtime-python2.7/tags) | ![](https://img.shields.io/github/workflow/status/aliyun/fc-docker/release%20fc-docker%20images) ![](https://img.shields.io/docker/image-size/aliyunfc/runtime-python2.7) ![](https://img.shields.io/docker/pulls/aliyunfc/runtime-python2.7.svg) | | [python3.6](https://hub.docker.com/r/aliyunfc/runtime-python3.6/tags) | ![](https://img.shields.io/github/workflow/status/aliyun/fc-docker/release%20fc-docker%20images) ![](https://img.shields.io/docker/image-size/aliyunfc/runtime-python3.6) ![](https://img.shields.io/docker/pulls/aliyunfc/runtime-python3.6.svg) | | [python3.9](https://hub.docker.com/r/aliyunfc/runtime-python3.9/tags) | ![](https://img.shields.io/github/workflow/status/aliyun/fc-docker/release%20fc-docker%20images) ![](https://img.shields.io/docker/image-size/aliyunfc/runtime-python3.9) ![](https://img.shields.io/docker/pulls/aliyunfc/runtime-python3.9.svg) | | [java8](https://hub.docker.com/r/aliyunfc/runtime-java8/tags) | ![](https://img.shields.io/github/workflow/status/aliyun/fc-docker/release%20fc-docker%20images) ![](https://img.shields.io/docker/image-size/aliyunfc/runtime-java8) ![](https://img.shields.io/docker/pulls/aliyunfc/runtime-java8.svg) | | [java11](https://hub.docker.com/r/aliyunfc/runtime-java11/tags) | ![](https://img.shields.io/github/workflow/status/aliyun/fc-docker/release%20fc-docker%20images) ![](https://img.shields.io/docker/image-size/aliyunfc/runtime-java11) ![](https://img.shields.io/docker/pulls/aliyunfc/runtime-java11.svg) | | [php7.2](https://hub.docker.com/r/aliyunfc/runtime-php7.2/tags) | ![](https://img.shields.io/github/workflow/status/aliyun/fc-docker/release%20fc-docker%20images) ![](https://img.shields.io/docker/image-size/aliyunfc/runtime-php7.2) ![](https://img.shields.io/docker/pulls/aliyunfc/runtime-php7.2.svg) | | [dotnetcore2.1](https://hub.docker.com/r/aliyunfc/runtime-dotnetcore2.1/tags) | ![](https://img.shields.io/github/workflow/status/aliyun/fc-docker/release%20fc-docker%20images) ![](https://img.shields.io/docker/image-size/aliyunfc/runtime-dotnetcore2.1) ![](https://img.shields.io/docker/pulls/aliyunfc/runtime-dotnetcore2.1.svg) | | [custom](https://hub.docker.com/r/aliyunfc/runtime-custom/tags) | ![](https://img.shields.io/github/workflow/status/aliyun/fc-docker/release%20fc-docker%20images) ![](https://img.shields.io/docker/image-size/aliyunfc/runtime-custom) ![](https://img.shields.io/docker/pulls/aliyunfc/runtime-custom.svg) | | [go1](https://hub.docker.com/r/aliyunfc/runtime-go1/tags) | ![](https://img.shields.io/github/workflow/status/aliyun/fc-docker/release%20fc-docker%20images) ![](https://img.shields.io/docker/image-size/aliyunfc/runtime-go1) ![](https://img.shields.io/docker/pulls/aliyunfc/runtime-go1.svg) | 除了可以运行您的函数，本项目还包含 runtime 对应的用于编译项目的镜像。他们包含了常用的编译工具打包工具，比如 gcc、g++、npm、maven 等。 注意：[Fun](https://github.com/aliyun/fun) 现已基于 fc-docker，推出了 fun local 子命令，用于本地运行、调试函数。体验更好，推荐优先使用 Fun。 ## 使用条件 要使用本项目，需要首先安装 [docker](https://www.docker.com/)。 ## 示例 您可以在 demos 目录体验： ```shell # 进入 demos/nodejs6 或者 demos/nodejs8 或者 demos/nodejs10 或者 demos/nodejs12 目录，执行下面命令分别在对应目录中运行函数： docker run --rm -v $(pwd):/code --env-file ./env.list aliyunfc/runtime-nodejs6 --handler "index.handler" --event '{"key" : "value"}' # 进入 demos/python2.7 目录，执行下面命令在 python2.7 中运行函数： docker run --rm -v $(pwd):/code --env-file ./env.list aliyunfc/runtime-python2.7 --handler "index.handler" --event '{"some": "event"}' # 进入 demos/python3.6 目录，执行下面命令在 python3.6 中运行函数： docker run --rm -v $(pwd):/code --env-file ./env.list aliyunfc/runtime-python3.6 --handler "index.handler" --event '{"some": "event"}' # 进入 demos/python3.9 目录，执行下面命令在 python3.9 中运行函数： docker run --rm -v $(pwd):/code --env-file ./env.list aliyunfc/runtime-python3.9 --handler "index.handler" --event '{"some": "event"}' # 进入 demos/php7.2 目录，执行下面命令在 php7.2 中运行函数： docker run --rm -v $(pwd):/code --env-file ./env.list aliyunfc/runtime-php7.2 --handler "index.handler" --event '{"some": "event"}' # 进入 demos/java8 目录，执行 mvn package 打包函数，然后执行下面命令运行函数: docker run -v $(pwd)/target/java8-1.0.0.jar:/code/java8-1.0.0.jar --env-file ./env.list aliyunfc/runtime-java8 --handler "examples.Hello::handleRequest" ``` 支持更多的长/短参数，列表如下： | 短参数 | 长参数 | 参数含义 | | :----- | :---------------------: | --------------------: | | -h | --handler | 函数入口 | | 无 | --timeout | 函数超时时间 | | -i | --initializer | 函数初始化入口 | | -e | --initializationTimeout | 初始化超时时间 | | 无 | --event | 上传 event | | 无 | --stdin | event 从 stdin 中获取 | | 无 | --server | server 模式 | build 镜像的使用方法： ```shell # 下载 nodejs 依赖(npm rebuild) docker run --rm -v $(pwd):/code aliyunfc/runtime-nodejs6:build # 在 build 容器中运行自定义命令 docker run --rm -v $(pwd):/code aliyunfc/runtime-python2.7:build fun docker run --rm -v $(pwd):/code aliyunfc/runtime-python3.6:build fcli docker run --rm -v $(pwd):/code aliyunfc/runtime-python3.9:build fcli # 在 build 容器中运行交互式 bash docker run --rm -it -v $(pwd):/code aliyunfc/runtime-python2.7:build bash ``` ## 环境变量 本项目支持通过环境变量定制容器的一些行为，可用的环境变量包括： - FC_ACCESS_KEY_ID - FC_ACCESS_KEY_SECRET - FC_SECURITY_TOKEN - FC_FUNCTION_NAME 使用方法为： ```shell docker run --rm -it -e FC_ACCESS_KEY_ID=xxxxxxx -e FC_ACCESS_KEY_SECRET=xxxxxxxx -v $(pwd):/code nodejs6 ``` ## build 环境中包含的依赖 - fcli - fun - vim - zip - git - build-essential - clang - libgmp3-dev - python2.7-dev - apt-utils - dialog