Open-Meteo 项目开发与构建指南

Open-Meteo 项目开发与构建指南

open-meteo Free Weather Forecast API for non-commercial use 项目地址: https://gitcode.com/gh_mirrors/op/open-meteo

项目概述

Open-Meteo 是一个开源的气象数据服务项目，提供全球范围内的天气预报数据访问接口。该项目采用现代化的技术栈构建，支持通过 Docker 容器化部署，同时也提供了本地开发环境配置指南。

从源码构建

Docker 构建流程

1. 获取源代码 首先需要获取项目源代码，可以通过版本控制工具克隆仓库。

2. 构建 Docker 镜像 使用 Docker 构建命令创建项目镜像：

   docker build -t open-meteo .
   

3. 创建数据卷 气象数据需要持久化存储，建议创建专用数据卷：

   docker volume create --name open-meteo-data
   

4. 启动服务 运行容器并映射端口：

   docker run -d --rm -v open-meteo-data:/app/data -p 8080:8080 open-meteo
   

5. 下载必要数据 项目运行需要下载数字高程模型和气象预测数据：

   # 下载数字高程模型
   docker run -it --rm -v open-meteo-data:/app/data open-meteo sync copernicus_dem90 static
   
   # 下载全球温度预测数据
   docker run -it --rm -v open-meteo-data:/app/data open-meteo sync ncep_gfs013 temperature_2m --past-days 3
   

6. 测试服务 服务启动后，可以通过 API 接口获取气象数据：

   curl "http://127.0.0.1:8080/v1/forecast?latitude=47.1&longitude=8.4&models=gfs_global&hourly=temperature_2m"
   

开发环境配置

Docker 开发模式

为了加速开发迭代，项目提供了开发专用的 Docker 配置：

1. 构建开发镜像

   docker build -f Dockerfile.development -t open-meteo-development .
   

2. 启动开发容器

   docker run -it --security-opt seccomp=unconfined -p 8080:8080 -v ${PWD}:/app -v open-meteo-data:/app/data -t open-meteo-development /bin/bash
   

3. 容器内开发命令

   • 运行服务：swift run
   • 下载数据：swift run openmeteo-api download-ecmwf --run 00

macOS 开发环境

1. 前置条件

   • 安装 Xcode（通过 App Store）
   • 安装 Homebrew

2. 安装依赖

   brew install netcdf bzip2
   

3. 开发流程 可以直接使用 Xcode 打开项目，或者通过命令行工具：

   swift run
   

Linux 开发环境

推荐使用 Ubuntu 22.04 系统，这是官方支持 Swift 5.8+ 的 Linux 发行版。

1. 安装系统依赖

   sudo apt install libnetcdf-dev libeccodes-dev libbz2-dev build-essential curl
   sudo apt-get install binutils git gnupg2 libc6-dev libcurl4-openssl-dev libedit2 libgcc-9-dev libpython3.8 \
     libsqlite3-0 libstdc++-9-dev libxml2-dev libz3-dev pkg-config tzdata unzip zlib1g-dev
   sudo apt install libbz2-dev libz-dev
   

2. 安装 Swift 工具链

   wget https://download.swift.org/swift-5.8.1-release/ubuntu2204/swift-5.8.1-RELEASE/swift-5.8.1-RELEASE-ubuntu22.04.tar.gz
   tar xvzf swift-5.8.1-RELEASE-ubuntu22.04.tar.gz
   sudo mv swift-5.8.1-RELEASE-ubuntu22.04 /opt
   ln -s /opt/swift-5.8.1-RELEASE-ubuntu22.04/ /opt/swift
   echo 'export PATH=/opt/swift/usr/bin:$PATH' >> ~/.bashrc
   source ~/.bashrc
   

3. 验证安装

   swift --version
   

4. 运行项目

   swift run
   swift run openmeteo-api download-ecmwf --run 00
   

开发技巧

1. 重启服务：在开发过程中，可以通过 Ctrl+C 停止服务后重新运行 swift run 来重启。

2. 发布构建：为了提高性能，可以使用发布模式构建：

   swift run -c release
   

3. 数据管理：开发过程中频繁下载测试数据会影响效率，建议创建专门用于开发的小型数据集。

4. 调试技巧：在 Docker 开发模式下，可以使用 Swift 的调试工具进行断点调试和性能分析。

通过以上配置，开发者可以快速搭建 Open-Meteo 的开发环境，进行功能开发和测试。项目采用现代化的容器化技术，使得环境配置和部署变得简单高效。

open-meteo Free Weather Forecast API for non-commercial use 项目地址: https://gitcode.com/gh_mirrors/op/open-meteo