simongauld/aoc

Advent of Code Container 镜像文档

镜像概述

Advent of Code Container是一个专为Advent of Code年度编程谜题活动设计的Docker镜像。该镜像提供预配置的开发环境，集成多种常用解题工具和依赖，旨在简化参与者的解题流程，消除环境配置障碍，确保跨设备、跨平台的开发环境一致性。

核心功能与特性

• 多语言支持：内置Python、JavaScript、Go、Java等Advent of Code常见解题语言的运行时环境及编译器
• 工具集成：包含代码格式化工具（Prettier、Black）、测试框架（pytest、Jest）、输入数据获取/解析工具
• 环境隔离：通过Docker容器化确保解题环境与本地系统隔离，避免依赖冲突
• 即开即用：无需手动安装依赖，拉取镜像后可直接开始编写和运行解题代码
• 轻量级设计：基于Alpine或Slim基础镜像构建，减小镜像体积，提升启动速度

使用场景

• Advent of Code参与者日常解题开发与测试
• 跨设备（如家用PC、工作笔记本）保持一致的解题环境
• 新手入门Advent of Code时快速搭建开发环境
• 团队或社区协作中共享统一的解题环境
• 教学场景中演示Advent of Code解题过程

使用方法与配置说明

基本使用流程

1. 拉取镜像（假设镜像名为aoc-container）：

   bash
   docker pull aoc-container:latest
   

2. 运行容器并挂载本地解题目录（将/path/to/your/code替换为实际代码目录）：

   bash
   docker run -it -v /path/to/your/code:/app aoc-container:latest
   

3. 在容器内执行解题代码（以Python为例）：

   bash
   cd /app/2023/day01
   python solution.py
   

Docker Run 高级示例

指定运行语言环境并自动测试代码：

bash
docker run -it \
  -v /path/to/your/code:/app \
  -e LANGUAGE=python \
  -e AUTO_TEST=true \
  aoc-container:latest \
  run-test 2023/day01

• -e LANGUAGE=python：指定使用Python环境
• -e AUTO_TEST=true：启用自动测试模式
• run-test 2023/day01：执行指定日期（2023年第1天）的测试用例

Docker Compose 配置示例

创建docker-compose.yml：

yaml
version: '3'
services:
  aoc-solver:
    image: aoc-container:latest
    volumes:
      - ./code:/app
    environment:
      - LANGUAGE=javascript
      - INPUT_FILE=/app/inputs/2023/day01.txt
    working_dir: /app
    tty: true

启动容器：

bash
docker-compose up -d
docker-compose exec aoc-solver bash

配置参数说明

环境变量

常用命令

注意事项

• 本地代码目录挂载时需确保有读写权限
• 首次运行可能需要下载语言依赖，耗时稍长
• 如需使用特定版本的编程语言，可通过-e LANGUAGE_VERSION=3.11指定（需镜像支持）
• 输入数据获取功能可能需要配置Advent of Code会话Cookie（通过-e AOC_SESSION=your_cookie设置）