dtcenter/metviewer

METVIEWER Docker镜像技术文档

一、镜像概述和主要用途

METVIEWER Docker镜像是用于部署和运行METviewer应用的容器化解决方案。METviewer是一款气象数据可视化与分析工具，主要用于处理和展示MET（Model Evaluation Tools）或VSDB格式的气象模型评估数据。该Docker镜像集成了METviewer应用及其依赖组件（如MySQL数据库），简化了部署流程，实现了跨环境的一致运行，并支持数据持久化存储。

二、核心功能和特性

1. 容器化部署：将METviewer与依赖组件（MySQL）打包为容器，无需手动配置复杂的运行环境。
2. 数据持久化：通过本地目录挂载，实现MySQL数据、METviewer输入/输出数据的持久化存储，避免容器删除导致数据丢失。
3. Web GUI访问：提供Web界面（GUI），通过浏览器即可访问和操作METviewer。
4. 灵活部署：支持本地构建镜像或直接拉取DockerHub官方镜像，适应不同网络环境。

三、使用场景和适用范围

适用于需要对MET或VSDB格式气象数据进行可视化分析的用户，包括气象科研人员、业务系统运维人员等。尤其适合需要快速部署、避免环境配置冲突、或需要数据持久化管理的场景。

四、环境准备

1. 前提条件

• 本地已安装Docker（官方安装指南）。
• 验证Docker运行正常：执行docker hello-world，若输出成功信息则Docker环境可用。

2. 获取部署文件

克隆METviewer仓库并进入docker目录（后续操作均在此目录执行）：

bash
git clone https://github.com/dtcenter/METviewer
cd METviewer/docker

五、安装与部署

1. 选择镜像来源

选项1：本地构建镜像（可选）

若需自定义镜像，可在METviewer/docker目录下构建：

bash
docker build -t metviewer .

选项2：拉取DockerHub官方镜像（推荐）

直接使用DockerHub上的预构建镜像：

bash
# 设置环境变量指定镜像（bash语法）
export METVIEWER_DOCKER_IMAGE=dtcenter/metviewer

# 若使用c-shell，执行：
setenv METVIEWER_DOCKER_IMAGE dtcenter/metviewer

2. 设置环境变量

需配置以下环境变量，用于挂载本地目录实现数据持久化。请先手动创建对应本地目录（例如mkdir -p /path/for/mysql/tables）。

（1）MySQL数据目录（MYSQL_DIR）

指定本地目录用于存储MySQL数据库文件（避免数据写入容器内部）：

bash
# bash语法
export MYSQL_DIR=/path/for/mysql/tables  # 替换为实际本地路径

# c-shell语法
setenv MYSQL_DIR /path/for/mysql/tables

（2）METviewer输出目录（METVIEWER_DIR）

指定本地目录用于存储METviewer的输出文件：

bash
# bash语法
export METVIEWER_DIR=/path/for/metviewer/output  # 替换为实际本地路径

# c-shell语法
setenv METVIEWER_DIR /path/for/metviewer/output

（3）METviewer输入数据目录（METVIEWER_DATA）

指定本地目录用于存放METviewer的输入数据（MET或VSDB格式）：

bash
# bash语法
export METVIEWER_DATA=/path/for/data  # 替换为实际本地路径

# c-shell语法
setenv METVIEWER_DATA /path/for/data

3. 启动容器

通过docker-compose启动服务（自动拉取依赖镜像并启动容器）：

bash
# 检查环境配置是否正确，然后启动容器
./check_env.sh && docker-compose up -d

六、使用方法

1. 进入运行中的容器

如需在容器内执行命令，可通过以下命令进入容器bash终端：

bash
docker exec -it metviewer_1 /bin/bash

2. 容器内目录结构

进入容器后，关键目录说明：

• /METviewer/bin：存放METviewer所有模块。
• /data：挂载的本地METVIEWER_DATA目录，用于读取输入数据。

3. 访问MySQL数据库

容器内集成MySQL数据库，可通过以下命令访问（需先进入容器）：

bash
mysql -h mysql_mv -uroot -pmvuser

• 主机名：mysql_mv（容器内MySQL服务名）
• 用户名：root
• 密码：mvuser

4. 访问Web GUI

通过浏览器访问METVIEWER界面，URL：

http://localhost:8080/metviewer/metviewer1.jsp

七、停止容器

如需停止并删除容器（数据仍保存在本地挂载目录），执行：

bash
docker-compose down

八、环境变量说明