shamayil/sqs-cron-worker

Laravel Worker与AWS SQS集成镜像

镜像概述

本Docker镜像专为AWS云服务环境设计，支持在EC2、ECS和Fargate平台上自动运行Laravel工作队列（worker/job），并与AWS SQS（Simple Queue Service）消息队列服务无缝集成，实现后台任务的自动化触发与处理。

核心功能与特性

• 多环境兼容：支持AWS EC2虚拟机、ECS容器服务及Fargate无服务器容器环境
• 自动触发机制：自动启动Laravel worker进程，持续监听并处理队列任务
• AWS SQS集成：原生适配AWS SQS消息队列，实现任务的异步分发与处理
• Laravel框架支持：兼容Laravel队列系统，支持标准Laravel job处理流程

使用场景与适用范围

• 基于AWS云服务部署的Laravel应用后台任务处理
• 需要异步执行的业务场景（如邮件发送、数据处理、定时任务等）
• 容器化部署架构中后台worker进程的统一管理
• 无服务器环境（Fargate）下的任务队列处理需求

使用方法与配置说明

环境变量配置

运行镜像时需配置以下必要环境变量：

Docker Run部署示例

bash
docker run -d \
  -e AWS_ACCESS_KEY_ID=AKIAEXAMPLE123 \
  -e AWS_SECRET_ACCESS_KEY=secret123example \
  -e AWS_REGION=us-east-1 \
  -e SQS_QUEUE_URL=https://sqs.us-east-1.amazonaws.com/123456789012/my-queue \
  -e LARAVEL_APP_ENV=production \
  -e LARAVEL_QUEUE_CONNECTION=sqs \
  your-image-name:latest

Docker Compose配置示例

yaml
version: '3'
services:
  laravel-worker:
    image: your-image-name:latest
    environment:
      - AWS_ACCESS_KEY_ID=AKIAEXAMPLE123
      - AWS_SECRET_ACCESS_KEY=secret123example
      - AWS_REGION=us-east-1
      - SQS_QUEUE_URL=https://sqs.us-east-1.amazonaws.com/123456789012/my-queue
      - LARAVEL_APP_ENV=production
      - LARAVEL_QUEUE_CONNECTION=sqs
    restart: always

注意事项

• 确保AWS IAM角色或用户拥有SQS队列的sqs:ReceiveMessage、sqs:DeleteMessage等必要权限
• Laravel应用需确保config/queue.php中的SQS配置与环境变量保持一致
• 在Fargate环境部署时，需配置适当的任务资源限制（CPU/内存）及网络访问策略