conda-ecopkgs开发者手册：package.yml和supported-versions.yml配置详解

【免费下载链接】conda-ecopkgsThis repo aims to manage the conda packages which support openEuler.项目地址: https://gitcode.com/openeuler/conda-ecopkgs

前往项目官网免费下载：https://ar.openeuler.org/ar/

📖 文章简介

欢迎阅读conda-ecopkgs开发者手册！本文将为您详细解析在openEuler conda生态包管理项目中两个核心配置文件：package.yml和supported-versions.yml的完整配置指南。无论您是初次接触conda包管理的新手，还是经验丰富的开发者，本指南都将帮助您快速掌握如何为openEuler系统配置和验证conda软件包。

🔧 项目概述与核心功能

conda-ecopkgs是openEuler社区的重要项目，致力于管理和验证在openEuler操作系统上运行的conda软件包。该项目通过标准化的配置文件确保conda包在openEuler不同版本上的兼容性和稳定性，为科学计算、生物信息学、人工智能等领域的开发者提供可靠的软件环境。

项目的核心功能包括：

• 📦conda包管理：统一管理openEuler支持的conda软件包
• ✅版本验证：确保软件包在不同openEuler版本上的兼容性
• 🔄自动化测试：通过CI/CD流水线自动验证软件包安装和使用
• 📋标准化配置：提供统一的配置模板和规范

📁 项目目录结构解析

在深入了解配置文件之前，让我们先看看项目的整体结构：

conda-ecopkgs/ ├── packages/ # 所有conda软件包的配置目录 │ ├── 3d-dna/ │ │ ├── package.yml # 软件包基本信息配置 │ │ └── supported-versions.yml # 版本支持情况配置 │ ├── abinit/ │ │ ├── package.yml │ │ └── supported-versions.yml │ ├── alphafold/ │ │ ├── package.yml │ │ └── supported-versions.yml │ └── ... (其他软件包) ├── config/ │ └── os-versions.txt # openEuler操作系统版本列表 ├── README.md # 项目说明文档 └── LICENSE # 许可证文件

每个软件包都有独立的目录，包含两个核心配置文件：package.yml和supported-versions.yml。

📝 package.yml配置文件详解

package.yml文件是conda软件包的核心配置文件，它定义了软件包的基本信息、安装方法和使用说明。让我们通过一个完整示例来深入了解每个配置项的作用。

🎯 基础信息配置

# packages/3d-dna/package.yml 示例 name: 3d-dna category: hpc channel: bioconda description: 3D de novo assembly (3D-DNA) pipeline. license: MIT homepage: https://github.com/aidenlab/3d-dna/tree/201008 maintainer: baigj maintainer-email: guangjiebai@gmail.com

各字段说明：

📋 使用说明配置

usage: | - 添加Channel ``` conda config --add channels bioconda conda config --add channels conda-forge ``` - 创建隔离环境(可选) ``` conda create -n 3d-dna conda activate 3d-dna ``` - 安装软件包 ``` conda install 3d-dna ```

使用说明配置要点：

1. 格式要求：使用YAML的多行字符串格式（|）
2. 内容结构：通常包括三个主要步骤：
   • 🛠️添加Channel：配置conda软件源
   • 🏗️创建环境：建议创建独立的conda环境
   • 📥安装软件：使用conda install命令安装
3. 代码块：使用Markdown代码块格式包裹命令

🔗 依赖频道配置

dependency-channels: - conda-forge

这个配置指定了软件包依赖的其他conda频道，确保所有依赖都能正确解析和安装。

🔄 上游版本跟踪（可选）

# packages/abinit/package.yml 中的示例 upstream: backend: GitHub version_scheme: RPM version_url: abinit/abinit version_filter: rc

上游配置字段说明：

📊 supported-versions.yml配置文件详解

supported-versions.yml文件记录了软件包在不同openEuler版本上的支持情况，是CI/CD验证的重要依据。

🏷️ 版本支持格式

# packages/3d-dna/supported-versions.yml 示例 24.03-LTS-SP1: 201008: - noarch 22.03-LTS-SP4: 201008: - noarch 24.03-LTS: 201008: - noarch 24.03-LTS-SP2: 201008: - noarch

配置结构解析：

openEuler版本: 软件包版本: - 架构1 - 架构2 - ...

🖥️ 架构支持示例

# packages/abinit/supported-versions.yml 示例 24.03-LTS-SP3: 10.0.3: - x86_64 - aarch64

支持的架构类型：

📋 openEuler版本规范

openEuler版本命名遵循特定格式，您可以在config/os-versions.txt文件中查看当前支持的版本列表。

常见的版本格式：

• 24.03-LTS：2024年3月发布的长期支持版
• 24.03-LTS-SP1：第一个服务包（Service Pack）
• 22.03-LTS-SP4：2022年3月LTS的第4个服务包

🚀 实战配置指南

案例1：为openEuler添加新的conda软件包

假设我们要为openEuler添加一个名为my-package的新conda包：

步骤1：创建软件包目录

mkdir -p packages/my-package

步骤2：编写package.yml

# packages/my-package/package.yml name: my-package category: others channel: conda-forge description: 这是一个示例软件包，用于演示配置方法。 license: MIT homepage: https://github.com/example/my-package maintainer: your-name maintainer-email: your-email@example.com usage: | - 添加Channel ``` conda config --add channels conda-forge ``` - 创建隔离环境 ``` conda create -n my-package conda activate my-package ``` - 安装软件包 ``` conda install my-package ``` dependency-channels: - conda-forge

步骤3：编写supported-versions.yml

# packages/my-package/supported-versions.yml 24.03-LTS-SP3: 1.0.0: - x86_64 - aarch64

案例2：为现有软件包添加新版本支持

如果您要为已存在的软件包添加对新openEuler版本的支持：

步骤1：编辑supported-versions.yml

# 在现有配置中添加新版本支持 24.03-LTS-SP3: # 新的openEuler版本 2.1.0: # 软件包新版本 - x86_64 - aarch64 2.0.0: # 软件包旧版本（如果需要继续支持） - x86_64

步骤2：提交变更并等待CI验证CI系统会自动验证该软件包在新版本openEuler上的兼容性。

✅ 配置验证与最佳实践

🔍 配置文件验证清单

在提交配置前，请检查以下要点：

✅package.yml验证清单：

• 软件包名称与conda官方一致
• 分类（category）选择正确
• 频道（channel）配置准确
• 许可证信息完整
• 使用说明清晰易懂
• 维护者信息正确

✅supported-versions.yml验证清单：

• openEuler版本格式正确
• 软件包版本号准确
• 架构支持列表完整
• YAML格式正确（缩进、冒号等）

📋 常见错误与解决方法

🔄 CI/CD工作流程

当您提交配置文件变更时，项目会自动触发CI/CD流程：

1. 配置验证：检查YAML格式和必填字段
2. 环境准备：为每个支持的openEuler版本创建测试环境
3. 软件包安装：在测试环境中安装指定版本的软件包
4. 功能测试：运行软件包的基本功能测试
5. 结果报告：生成测试报告，标记通过/失败

🎯 贡献指南

新增软件包流程

1. 在packages/目录下创建软件包子目录
2. 按照规范编写package.yml和supported-versions.yml
3. 提交Pull Request
4. CI自动验证通过后，由maintainer合并

新增版本支持流程

1. 编辑对应软件包的supported-versions.yml
2. 添加新的openEuler版本和软件版本
3. 提交变更，等待CI验证

⚠️ 注意事项

• 暂不支持删除已验证过的版本支持信息
• 确保所有配置信息准确无误
• 遵循项目的代码规范和提交规范

📈 总结与展望

通过本文的详细解析，您已经掌握了conda-ecopkgs项目中package.yml和supported-versions.yml配置文件的完整使用方法。这两个配置文件是确保conda软件包在openEuler系统上稳定运行的关键。

核心要点回顾：

• 🎯package.yml：定义软件包基本信息、使用方法和维护信息
• 📊supported-versions.yml：记录软件包在不同openEuler版本和架构上的支持情况
• 🔄标准化配置：确保所有软件包遵循统一的配置规范
• ✅自动化验证：通过CI/CD流程保证软件包质量

随着openEuler生态的不断发展，conda-ecopkgs项目将继续为开发者提供更多经过验证的conda软件包。我们鼓励更多开发者参与到项目中，共同完善openEuler的软件生态！

如果您在配置过程中遇到任何问题，欢迎查阅项目文档或联系维护团队。祝您在openEuler上的conda开发之旅顺利愉快！🚀

【免费下载链接】conda-ecopkgsThis repo aims to manage the conda packages which support openEuler.项目地址: https://gitcode.com/openeuler/conda-ecopkgs