cs50/check

CS50 ECS

镜像概述和主要用途

CS50 ECS 镜像是基于哈佛大学 CS50 课程体系构建的 Docker 镜像，旨在为学习者提供一个集成化的 Elastic Container Service (ECS) 学习与实践环境。该镜像封装了 ECS 相关的核心工具、依赖组件及示例配置，简化了本地模拟 ECS 集群、容器编排及服务部署的流程，适用于容器化技术入门、ECS 服务管理及云原生应用开发的教学场景。

核心功能和特性

1. 集成化 ECS 模拟环境

• 内置简化版 ECS 集群模拟器，支持本地模拟 ECS 任务调度、服务发现及负载均衡
• 兼容 AWS ECS CLI 工具链，可直接对接 AWS ECS 官方命令行操作

2. CS50 课程工具集成

• 预装 CS50 课程标准工具集（如 cs50-cli、check50），支持课程作业提交与自动化评测
• 集成 Git、Docker 及容器编排工具（Docker Compose、ecs-cli），满足全流程开发需求

3. 轻量级与可扩展性

• 基于 Alpine Linux 构建，镜像体积优化至最小（约 500MB），启动速度快
• 支持自定义插件扩展，可通过挂载外部配置文件添加额外工具或服务

4. 多平台兼容

• 支持 AMD64/ARM64 架构，兼容 Linux、macOS 及 Windows（WSL2）系统的 Docker 环境

使用场景和适用范围

1. CS50 课程学习者

• 容器化技术入门：通过本地环境模拟 ECS 集群，学习容器编排基础概念
• ECS 服务部署实践：无需依赖云端资源，直接在本地完成任务定义、服务创建及伸缩策略配置

2. 云原生技术教学

• 高校/培训机构：作为教学实验环境，简化 ECS 相关知识点的演示与实操环节
• 开发者自学：快速搭建 ECS 沙盒环境，测试任务定义文件、服务配置及负载均衡策略

3. 课程项目开发

• 支持 CS50 课程中涉及容器化部署的项目开发，如构建微服务应用并模拟 ECS 集群部署

详细的使用方法和配置说明

环境准备

使用前需确保本地已安装 Docker Engine（20.10+）及 Docker Compose（2.0+）。

基础使用方法

1. 快速启动（docker run）

通过以下命令启动 CS50 ECS 容器，映射本地端口 8080 至容器内 ECS 模拟控制台：

bash
docker run -d \
  --name cs50-ecs \
  -p 8080:8080 \
  -v $(pwd)/cs50-projects:/app/projects \
  docker.xuanyuan.run/cs50/ecs:latest

参数说明：

• -p 8080:8080：映射容器内 ECS 控制台端口至本地
• -v $(pwd)/cs50-projects:/app/projects：挂载本地项目目录至容器内，实现文件持久化与共享

2. Docker Compose 配置

创建 docker-compose.yml 文件，定义包含 CS50 ECS 服务及依赖组件的完整环境：

yaml
version: '3.8'
services:
  cs50-ecs:
    image: docker.xuanyuan.run/cs50/ecs:latest
    container_name: cs50-ecs
    ports:
      - "8080:8080"  # ECS 控制台端口
      - "3000:3000"  # 示例应用端口
    volumes:
      - ./ecs-config:/etc/ecs  # 自定义 ECS 配置
      - ./projects:/app/projects  # 项目目录挂载
    environment:
      - ECS_CLUSTER_NAME=cs50-student-cluster  # 集群名称
      - ECS_SIMULATOR_MODE=local  # 运行模式（local/remote）
      - CS50_AUTO_SUBMIT=true  # 自动提交作业开关
    restart: unless-stopped

使用场景和适用范围

1. CS50 课程学习者

• 容器化基础学习：通过镜像内置的 ECS 模拟器，实践容器生命周期管理（创建、启动、停止、删除）
• ECS 服务部署练习：基于示例配置文件，学习任务定义、服务编排及负载均衡规则配置

2. 云原生技术入门者

• 低成本实践环境：无需 AWS 账号即可本地模拟 ECS 集群，降低云端资源使用成本
• 工具链熟悉：通过预装的 ecs-cli、docker-compose 等工具，掌握容器编排工具的基础操作

3. 教学与培训场景

• 课堂演示：讲师可快速启动标准化环境，演示 ECS 核心概念（如集群、任务、服务）
• 学生作业评测：集成 check50 工具，支持自动化检测容器配置及服务可用性

配置参数说明

环境变量

目录结构说明

容器内部核心目录结构如下，可通过挂载外部目录自定义配置：

/app
├── projects/          # 项目代码存放目录（可外部挂载）
├── examples/          # ECS 示例配置文件（任务定义、服务模板等）
├── cs50-tools/        # CS50 课程工具集（check50、submit50 等）
/etc/ecs
├── cluster.config     # ECS 集群配置文件
├── task-definitions/  # 任务定义模板目录
/var/log/ecs           # ECS 模拟器日志目录

核心功能使用示例

1. 启动 ECS 本地集群

容器启动后，可通过以下命令进入容器并初始化本地集群：

bash
docker exec -it cs50-ecs bash
ecs-simulator init --cluster $ECS_CLUSTER_NAME

2. 部署示例任务

使用内置示例任务定义部署 Nginx 服务：

bash
cd /app/examples/task-definitions
ecs-cli compose --project-name nginx-example service up

部署完成后，可通过本地 http://localhost:3000 访问示例 Nginx 服务。

3. 作业提交与评测

启用 CS50_AUTO_SUBMIT=true 后，完成项目开发可通过以下命令提交作业：

bash
cd /app/projects/your-project
submit50 cs50/ecs/2024/project1

注意事项

• 镜像仅用于学习与教学场景，生产环境需使用 AWS ECS 官方服务
• ECS_SIMULATOR_MODE=remote 模式需配置 AWS 访问密钥（通过挂载 ~/.aws/credentials 实现）
• 本地模式下，部分高级特性（如 IAM 权限控制、自动扩缩容）可能受限，建议以学习目的使用