uptycs/ecs-farquery

Uptycs Osquery for AWS ECS with Fargate 镜像文档

1. 镜像概述

Uptycs Osquery for AWS ECS with Fargate 是专为AWS ECS (Elastic Container Service) Fargate环境设计的容器镜像。该镜像集成Uptycs安全监控能力与Osquery工具，允许用户通过类SQL查询语言对Fargate上的容器实例及底层系统进行实时状态查询、安全事件监控与合规性检查。镜像针对Fargate无服务器架构优化，轻量级运行的同时提供全面系统可见性。

2. 核心功能与特性

• AWS ECS Fargate原生集成：适配Fargate服务器less架构，无需管理底层EC2实例，直接部署于ECS集群
• Osquery功能集成：内置Osquery引擎，支持通过SQL-like查询语句检索系统状态数据（进程、网络连接、文件系统变化等）
• 实时监控与数据采集：持续采集容器与系统指标，支持实时查询与历史数据检索
• 安全合规检查：内置安全合规查询模板，快速检查系统漏洞、未授权访问及合规性偏离
• Uptycs平台联动：可将数据发送至Uptycs云端平台，实现集中化日志管理、告警与可视化分析
• 轻量级设计：优化镜像体积与资源占用，适配Fargate的CPU/内存资源限制

3. 使用场景与适用范围

• AWS ECS Fargate环境监控：对Fargate容器集群进行实时状态监控，覆盖进程、网络、文件系统等关键指标
• 容器安全态势感知：通过Osquery查询识别异常进程、可疑网络连接及文件篡改等安全事件
• 合规性审计：满足PCI-DSS、HIPAA等合规要求，执行定期合规性检查并生成报告
• 事件响应与取证：安全事件发生后，通过历史查询数据进行事件溯源与取证分析
• DevSecOps集成：作为CI/CD流程一部分，在容器部署前或运行中执行安全检查，确保镜像合规

4. 使用方法与配置说明

4.1 前提条件

• 拥有AWS账号并已创建ECS集群（支持Fargate启动类型）
• 已注册Uptycs账户，获取Uptycs配置信息（API端点、客户ID、密钥等）
• 具备AWS CLI或ECS控制台操作权限，可管理ECS任务定义与服务

4.2 配置参数

镜像运行需通过环境变量指定以下关键参数：

4.3 部署步骤

1. 创建ECS任务定义：指定Fargate启动类型，配置容器镜像、资源及环境变量
2. 配置网络：确保安全组允许出站连接至Uptycs服务端点（443端口）
3. 部署ECS服务：基于任务定义创建服务，指定服务名称、副本数等参数
4. 验证部署：通过ECS控制台查看任务状态，或通过Uptycs平台确认数据接收状态

5. 部署示例

5.1 ECS任务定义示例（JSON片段）

json
{
  "containerDefinitions": [
    {
      "name": "uptycs-osquery",
      "image": "uptycs/osquery-ecs-fargate:latest",
      "essential": true,
      "environment": [
        { "name": "UPTYCS_HOST", "value": "https://your-uptycs-endpoint.uptycs.io" },
        { "name": "UPTYCS_CUSTOMER_ID", "value": "your-customer-id" },
        { "name": "UPTYCS_API_KEY", "value": "your-api-key" },
        { "name": "UPTYCS_API_SECRET", "value": "your-api-secret" },
        { "name": "ECS_CLUSTER_NAME", "value": "your-ecs-cluster" }
      ],
      "logConfiguration": {
        "logDriver": "awslogs",
        "options": {
          "awslogs-group": "/ecs/uptycs-osquery",
          "awslogs-region": "us-east-1",
          "awslogs-stream-prefix": "ecs"
        }
      }
    }
  ],
  "requiresCompatibilities": ["FARGATE"],
  "networkMode": "awsvpc",
  "cpu": "256",
  "memory": "512",
  "executionRoleArn": "arn:aws:iam::123456789012:role/ecs-task-execution-role"
}

5.2 AWS CLI创建服务示例

bash
aws ecs create-service \
  --cluster your-ecs-cluster \
  --service-name uptycs-osquery-service \
  --task-definition uptycs-osquery-task \
  --launch-type FARGATE \
  --desired-count 1 \
  --network-configuration "awsvpcConfiguration={subnets=[subnet-123456],securityGroups=[sg-123456],assignPublicIp=ENABLED}"

6. 注意事项

• 安全组配置：确保允许出站HTTPS（443端口）连接至Uptycs服务端点
• 资源配置：建议最低配置为0.25 vCPU（256）和0.5 GB（512）内存
• 敏感信息管理：API密钥等敏感信息建议通过AWS Secrets Manager存储，避免明文环境变量
• 版本更新：定期更新镜像版本以获取最新安全补丁与功能优化