Docker镜像：sofarocean/copernicus-marine 技术文档

1. 镜像概述

sofarocean/copernicus-marine 是一个集成了 copernicusmarine 库与 AWS CLI 工具的Docker镜像，旨在为用户提供开箱即用的容器化环境，无需单独配置即可同时使用这两个工具。该镜像适用于需要访问Copernicus海洋数据服务（Copernicus Marine Service）并通过AWS服务进行数据处理、存储或管理的场景，简化了环境依赖管理与工具集成流程。

2. 核心功能与特性

2.1 工具集成

• copernicusmarine：Python库，提供访问Copernicus海洋数据服务的接口，支持数据查询、下载与处理（基于Copernicus Marine Service数据）。
• AWS CLI：Amazon Web Services命令行工具，支持管理AWS资源（如S3存储、EC2实例等）、配置凭证及执行自动化操作。

2.2 环境优势

• 环境隔离：容器化部署避免本地环境依赖冲突，确保工具版本一致性。
• 版本可控：通过Docker标签管理不同版本，支持生产环境与开发环境版本分离。
• 即开即用：无需手动安装依赖，拉取镜像后可直接使用集成工具。

3. 使用场景

3.1 海洋数据获取与AWS集成处理

适用于需要从Copernicus海洋数据服务下载海洋数据（如海浪、海温、洋流等），并通过AWS S3存储、EC2计算资源或Lambda函数进行后续处理的开发者或数据科学家。

3.2 自动化数据工作流

在脚本或CI/CD流程中，通过容器化环境执行数据下载（copernicusmarine）与云端同步（AWS CLI）的自动化任务，简化跨工具流程配置。

3.3 开发与测试环境

为团队提供统一的工具版本环境，避免因本地配置差异导致的“在我机器上能运行”问题。

4. 使用方法

4.1 拉取镜像

镜像托管于Docker Hub，支持通过标签拉取最新版本或指定版本：

bash
# 拉取最新版本
docker pull sofarocean/copernicus-marine:latest

# 拉取指定版本（如release-0.0.1）
docker pull sofarocean/copernicus-marine:release-0.0.1

# 拉取开发版本（如分支特定版本）
docker pull sofarocean/copernicus-marine:0.0.1-fancy-feature-branch

4.2 运行容器

4.2.1 基础交互式运行

启动容器并进入交互式终端，直接使用 copernicusmarine 和 aws 命令：

bash
docker run -it --rm sofarocean/copernicus-marine:latest /bin/bash

在容器内验证工具：

bash
# 验证copernicusmarine版本
copernicusmarine --version

# 验证AWS CLI版本
aws --version

4.2.2 挂载本地目录

将本地数据目录挂载到容器，实现数据持久化或文件传输：

bash
docker run -it --rm -v /本地路径:/容器内路径 sofarocean/copernicus-marine:latest /bin/bash

示例：挂载本地~/data目录到容器/data，用于存储下载的海洋数据：

bash
docker run -it --rm -v ~/data:/data sofarocean/copernicus-marine:latest /bin/bash

4.2.3 配置AWS凭证

AWS CLI需通过凭证访问AWS服务，推荐通过以下方式配置：

• 方式1：挂载AWS配置文件（推荐，安全且持久）
  将本地~/.aws目录（包含credentials和config文件）挂载到容器：

  bash
  docker run -it --rm -v ~/.aws:/root/.aws sofarocean/copernicus-marine:latest /bin/bash
  

  容器内即可直接使用已配置的AWS账户：

  bash
  aws s3 ls  # 列出S3存储桶
  

• 方式2：环境变量注入
  通过-e参数传递AWS凭证（适合临时场景）：

  bash
  docker run -it --rm \
    -e AWS_ACCESS_KEY_ID="你的AccessKey" \
    -e AWS_SECRET_ACCESS_KEY="你的SecretKey" \
    -e AWS_REGION="us-east-1" \
    sofarocean/copernicus-marine:latest /bin/bash
  

4.2.4 使用copernicusmarine

容器内通过copernicusmarine命令访问Copernicus海洋数据服务，具体使用方法参考其***文档，示例：

bash
# 下载指定数据集（需Copernicus账户，可通过环境变量或配置文件认证）
copernicusmarine download --dataset "cmems_mod_glo_phy_my_0.083deg_P1D-m" --output /data

5. 镜像标签与版本控制

5.1 标签规则

• latest：指向最新稳定发布版本。
• release-<version>：正式发布版本，遵循语义化版本（如release-0.0.1）。
• <version>-<branch-name>：开发版本，关联特定功能分支（如0.0.1-fancy-feature-branch），用于测试未正式发布的功能。

5.2 版本选择建议

• 生产环境：使用release-<version>标签，确保版本稳定性。
• 开发/测试：可使用开发版本标签或latest（注意latest可能随更新变化）。

6. 镜像访问与获取

镜像托管于Docker Hub，地址：[***]

通过docker pull命令直接拉取，如：

bash
docker pull sofarocean/copernicus-marine:latest  # 最新稳定版
docker pull sofarocean/copernicus-marine:release-0.0.1  # 指定正式版本

附录：镜像发布流程（内部参考）

发布正式版本

1. 合并PR至main分支；
2. 为最新提交打语义化版本标签：git tag 0.0.1；
3. 推送标签：git push origin --tags；
4. Docker Hub自动构建镜像，标签为sofarocean/copernicus-marine:release-0.0.1。

发布开发版本

1. 在功能分支打标签：git tag {current-version}-{branch_name}（如git tag 0.0.1-fancy-feature-branch）；
2. 推送标签：git push origin --tags；
3. Docker Hub自动构建镜像，标签为sofarocean/copernicus-marine:0.0.1-fancy-feature-branch。