apache/openserverless-runtime-go Docker 镜像 - 轩辕镜像

Apache OpenWhisk GO Runtime 镜像文档

1. 镜像概述和主要用途

1.1 概述

本镜像为 Apache OpenServerless（孵化中）项目官方提供的 Apache OpenWhisk GO 运行时环境，用于在 OpenWhisk 无服务器平台上部署和执行 Go 语言编写的函数。它封装了 Go 运行时环境及 OpenWhisk 函数执行框架，确保 Go 函数与 OpenWhisk 平台的无缝集成。

1.2 主要用途

• 作为 OpenWhisk 平台的后端运行时，接收并执行 Go 语言函数
• 处理事件驱动型请求（如 HTTP 事件、消息队列事件等）
• 支持 Go 函数的生命周期管理（初始化、执行、销毁）

2. 核心功能和特性

2.1 核心功能

• OpenWhisk 兼容性：完全兼容 Apache OpenWhisk 平台的函数调用协议，支持同步/异步函数执行
• Go 语言支持：内置 Go 运行时环境，支持主流 Go 版本（如 Go 1.18+），可直接运行编译后的 Go 函数二进制文件或源码
• 事件处理：原生支持 OpenWhisk 事件格式，可解析 HTTP 请求、CloudEvent 等事件类型

2.2 特性

• 轻量级设计：基于精简基础镜像，减少资源占用，适合无服务器场景
• 快速启动：优化函数初始化流程，缩短冷启动时间
• 可配置性：通过环境变量自定义函数执行参数（超时、内存限制等）
• 日志集成：支持 OpenWhisk 日志收集机制，函数输出日志可被平台捕获

3. 使用场景和适用范围

3.1 使用场景

• 事件驱动型微服务：响应 HTTP、消息队列（如 Kafka、RabbitMQ）等事件触发的任务
• API 后端：作为 OpenWhisk API Gateway 的后端，处理 REST API 请求
• 定时任务：通过 OpenWhisk Alarm 触发器执行周期性 Go 函数（如数据备份、报表生成）
• 轻量级数据处理：处理小规模数据转换、过滤或聚合任务

3.2 适用范围

• 需要在 OpenWhisk 平台运行 Go 语言函数的开发者和企业
• 事件驱动架构下的无服务器应用开发
• 对函数启动速度和资源效率有较高要求的场景

4. 使用方法和配置说明

4.1 环境要求

• Docker 19.03+ 或兼容的容器运行时
• Apache OpenWhisk 平台 1.0+（作为函数执行宿主）

4.2 镜像获取

官方镜像可通过 Docker Hub 获取（假设镜像名称为 apache/openwhisk-runtime-go，具体以项目发布为准）：

bash
docker pull apache/openwhisk-runtime-go:latest

4.3 配置参数说明

镜像通过环境变量进行配置，关键参数如下：

4.4 部署示例

4.4.1 直接使用 Docker 运行

适用于本地测试 Go 函数执行（需提前准备编译好的 Go 函数二进制文件，放置于 /action 目录）：

bash
docker run -d \
  --name openwhisk-go-runtime \
  -p 8080:8080 \
  -v /path/to/your/go/function:/action \  # 挂载本地 Go 函数目录
  -e ACTION_NAME=Handle \                 # 函数入口名称
  -e LOG_LEVEL=debug \                    # 调试日志级别
  -e EXECUTION_TIMEOUT=60000 \            # 超时 60 秒
  apache/openwhisk-runtime-go:latest

说明：容器启动后，可通过 http://localhost:8080/run 发送 POST 请求触发函数执行，请求体需符合 OpenWhisk 事件格式（如 {"value": {"key": "value"}}）。

4.4.2 集成 OpenWhisk 平台部署

在 OpenWhisk 平台上部署 Go 函数时，需指定本运行时镜像。通过 wsk 命令行工具创建动作：

bash
wsk action create my-go-action /path/to/function.go \
  --docker apache/openwhisk-runtime-go:latest \  # 指定运行时镜像
  --param key value \                            # 函数参数
  --timeout 60000                                # 超时时间（毫秒）

触发函数执行：

bash
wsk action invoke my-go-action --result

4.4.3 Docker Compose 配置

适用于本地模拟 OpenWhisk 环境，与其他服务（如 Kafka 事件源）联动：

yaml
version: '3.8'
services:
  openwhisk-go-runtime:
    image: apache/openwhisk-runtime-go:latest
    ports:
      - "8080:8080"
    volumes:
      - ./my-go-function:/action  # 挂载本地 Go 函数目录
    environment:
      - ACTION_NAME=ProcessEvent
      - LOG_LEVEL=info
      - EXECUTION_TIMEOUT=45000
    networks:
      - openwhisk-network

  # 可选：添加 Kafka 事件源（示例）
  kafka:
    image: confluentinc/cp-kafka:7.3.0
    ports:
      - "9092:9092"
    environment:
      - KAFKA_ADVERTISED_LISTENERS=PLAINTEXT://kafka:9092
      - KAFKA_OFFSETS_TOPIC_REPLICATION_FACTOR=1
    networks:
      - openwhisk-network

networks:
  openwhisk-network:
    driver: bridge

启动服务：

bash
docker-compose up -d

5. 注意事项

• 本地测试时，Go 函数需编译为 Linux 平台二进制文件（如 GOOS=linux GOARCH=amd64 go build -o /action/exec）
• 生产环境中建议通过 OpenWhisk 平台管理函数，而非直接使用 docker run
• 镜像版本需与 OpenWhisk 平台版本匹配，避免兼容性问题
• 敏感配置（如 API 密钥）建议通过 OpenWhisk 动作参数或平台密钥管理机制注入，而非硬编码环境变量