diegotry/stepfunctions-callback

diegotry/stepfunctions-callback 镜像说明

镜像概述

本镜像基于AWS Step Functions的回调功能构建，旨在简化工作流中异步任务的状态管理。通过与AWS Step Functions服务交互，镜像可发送回调信号，触发工作流的下一步执行，适用于需要外部系统完成任务后通知流程继续的场景。

核心功能

• 与AWS Step Functions服务建立安全连接
• 发送回调信号更新任务状态（成功/失败）
• 支持传递任务执行结果数据
• 自动处理AWS凭证的环境变量配置

使用场景

• 分布式系统中异步任务的流程协同（如外部API调用、长时间计算任务）
• 工作流中需要人工干预或第三方系统确认的环节
• 微服务架构下跨服务的状态同步

配置说明

需通过环境变量提供以下配置：

• AWS_ACCESS_KEY_ID：AWS访问密钥ID
• AWS_SECRET_ACCESS_KEY：AWS秘密访问密钥
• AWS_REGION：AWS服务区域（如cn-north-1）
• TASK_TOKEN：Step Functions任务的唯一标识
• STATUS：回调状态（可选值：SUCCESS/FAILURE）
• RESULT：任务执行结果（JSON格式字符串）

部署示例

Docker Run命令

bash
docker run -d \
  -e AWS_ACCESS_KEY_ID="your-access-key" \
  -e AWS_SECRET_ACCESS_KEY="your-secret-key" \
  -e AWS_REGION="cn-north-1" \
  -e TASK_TOKEN="your-task-token" \
  -e STATUS="SUCCESS" \
  -e RESULT='{"data":"task-completed"}' \
  diegotry/stepfunctions-callback

Docker Compose示例

yaml
version: "3"
services:
  stepfunctions-callback:
    image: diegotry/stepfunctions-callback
    environment:
      - AWS_ACCESS_KEY_ID=your-access-key
      - AWS_SECRET_ACCESS_KEY=your-secret-key
      - AWS_REGION=cn-north-1
      - TASK_TOKEN=your-task-token
      - STATUS=SUCCESS
      - RESULT='{"data":"task-completed"}'