adcircorg/adcirc-ci

镜像概述

该镜像为ADCIRC（Advanced Circulation Model）项目的持续集成测试环境提供基础容器支持，旨在为ADCIRC相关的自动化测试、构建验证等流程提供标准化、一致性的运行环境，确保测试过程的稳定性和可重复性。

核心功能与特性

• 标准化运行环境：提供统一的基础操作系统及运行环境配置，消除因环境差异导致的测试结果不一致问题。
• 预装基础依赖：集成ADCIRC持续集成测试所需的核心依赖组件，减少测试环境搭建时间。
• 轻量级设计：优化镜像体积，支持CI流程中的快速拉取与启动，提升测试效率。
• 兼容性保障：针对ADCIRC项目特性优化，确保与相关测试工具链的兼容性。

使用场景与适用范围

• ADCIRC项目持续集成流程：作为自动化测试环节的基础运行环境，支持单元测试、集成测试等流程。
• 开发团队本地调试：供开发人员在本地模拟CI环境，进行测试脚本验证和问题排查。
• 测试环境标准化管理：统一开发、测试、CI/CD各环节的运行环境，降低环境配置维护成本。

使用方法与配置说明

基础使用（直接运行）

通过以下命令启动镜像容器，验证基础环境：

bash
docker run --rm -it docker.xuanyuan.run/adcirc-ci-base:latest

作为基础镜像构建自定义测试镜像

在Dockerfile中引用该镜像，扩展测试功能：

dockerfile
# 基于基础镜像构建自定义测试环境
FROM docker.xuanyuan.run/adcirc-ci-base:latest

# 添加项目特定测试依赖
RUN apt-get update && apt-get install -y \
    libnetcdf-dev \
    && rm -rf /var/lib/apt/lists/*

# 复制测试脚本
COPY ./adcirc-test-scripts /usr/local/bin/

集成至CI/CD流程

在GitHub Actions、GitLab CI等平台中配置使用：

GitHub Actions示例：

yaml
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - name: Pull base image
        run: docker pull docker.xuanyuan.run/adcirc-ci-base:latest
      - name: Run ADCIRC tests
        run: |
          docker run --rm -v ${{ docker.xuanyuan.run/github.workspace }}:/workspace adcirc-ci-base:latest \
          /workspace/run-adcirc-tests.sh

环境变量配置

该镜像无强制环境变量要求，如需自定义配置，可通过-e参数传入：

bash
docker run --rm -it -e "TEST_ENV=ci" docker.xuanyuan.run/adcirc-ci-base:latest

注意事项

• 镜像版本需与ADCIRC项目测试需求匹配，建议使用最新稳定版。
• 本地测试时，需确保Docker环境已正确配置，且网络通畅以拉取镜像。
• 如需扩展功能，建议通过Dockerfile基于该镜像构建派生镜像，避免直接修改基础镜像。