[PR #129] [MERGED] feat: add openEuler support to Linux distro detection

## 📋 Pull Request Information **Original PR:** https://github.com/kvcache-ai/AgentENV/pull/129 **Author:** [@liunianxuxie](https://github.com/liunianxuxie) **Created:** 8/6/2026 **Status:** ✅ Merged **Merged:** 8/6/2026 **Merged by:** [@yingdi-shan](https://github.com/yingdi-shan) **Base:** `main` ← **Head:** `feat/openeuler` --- ### 📝 Commits (2) - [`4be4d29`](https://github.com/kvcache-ai/AgentENV/commit/4be4d297926748d378e19f0f8d6d74e4f3484c61) feat: add openEuler support to Linux distro detection - [`499d9a2`](https://github.com/kvcache-ai/AgentENV/commit/499d9a2baa3b1f8616c214fec4b8476a4efb16d8) style: fix rustfmt formatting for openEuler match arms ### 📊 Changes **2 files changed** (+19 additions, -3 deletions) <details> <summary>View changed files</summary> 📝 `src/setup/overlaybd.rs` (+16 -2) 📝 `src/setup/packages.rs` (+3 -1) </details> ### 📄 Description ## What Add openEuler support to AgentENV's Linux distribution detection so --setup-only works on openEuler hosts. ## Why openEuler is a glibc-based RPM-family Linux distro widely used on ARM (Kunpeng) servers in China. The upstream ARM64 support (#86) covers Ubuntu/Debian but fails on openEuler with two errors: 1. --setup-only fails with unsupported Linux distribution — distro_from_id in src/setup/packages.rs does not recognize openEuler, so the runtime package list cannot be resolved. 2. overlaybd provisioning fails with unsupported overlaybd release target — configured_overlaybd_release in src/setup/overlaybd.rs does not map openEuler to the RPM-family fallback. ## Related issue No issue filed ## Scope and non-goals Included: - openEuler (ID=openEuler, lowercased to openeuler by the parser) recognized as RPM-family in src/setup/packages.rs - openEuler mapped to the existing Ubuntu 22.04 overlaybd fallback in src/setup/overlaybd.rs - Test coverage for both code paths Excluded: - No changes to dependency URLs, manifests, or tooling (upstream aenv-deps release already provides aarch64 binaries) - No changes to tools-image/ build, network mirrors, or documentation - No changes to non-RPM distributions ## Design and behavior changes openEuler already matches the existing RPM-family pattern used by centos/rhel/tencentos: - src/setup/packages.rs: distro_from_id maps openeuler/openEuler to Distro::Centos, reusing the existing dnf/yum package-manager detection and the libaio runtime package list. - src/setup/overlaybd.rs: configured_overlaybd_release maps openEuler to ubuntu1.22.04.{arch} — the oldest published Ubuntu overlaybd asset, chosen because it bundles its own shared libraries and runs on any glibc-based distro (same reasoning as the existing tencentos/centos/rhel fallback). ## Compatibility and operations - Public API or generated protocol: N/A - Configuration or defaults: N/A - Snapshot manifest, artifact layout, or storage format: N/A - Upgrade and rollback: N/A — additive recognition of a previously-unsupported OS - Host requirements, permissions, ports, or dependencies: openEuler hosts additionally need dpkg (to extract the overlaybd .deb) ## Validation  - [ ] `make fmt` - [ ] `make clippy` - [ ] `make test-unit` - [ ] Relevant Rust integration tests - [ ] `make -C services test` (required when `services/` changes) - [ ] Generated clients/server regenerated with the documented `make` target - [ ] Documentation updated - [ ] Benchmarks or performance comparison completed Commands and results: ```text ``` Skipped checks and reasons: ## Risks and reviewer notes  ## Checklist - [ ] The PR contains one coherent change and no unrelated formatting or refactoring. - [ ] New behavior is covered by tests, or I explained why testing is impractical. - [ ] Logs and examples contain no credentials, tokens, or private registry information. - [ ] I did not manually edit generated code without updating its source and regenerating it. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi commented

2026-10-29 14:20:53 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/kvcache-ai/AgentENV/pull/129
Author: @liunianxuxie
Created: 8/6/2026
Status: ✅ Merged
Merged: 8/6/2026
Merged by: @yingdi-shan

Base: main ← Head: feat/openeuler

📝 Commits (2)

4be4d29 feat: add openEuler support to Linux distro detection
499d9a2 style: fix rustfmt formatting for openEuler match arms

📊 Changes

2 files changed (+19 additions, -3 deletions)

View changed files

📝 src/setup/overlaybd.rs (+16 -2)
📝 src/setup/packages.rs (+3 -1)

📄 Description

What

Add openEuler support to AgentENV's Linux distribution detection so --setup-only works on openEuler hosts.

Why

openEuler is a glibc-based RPM-family Linux distro widely used on ARM (Kunpeng) servers in China. The upstream ARM64 support (#86) covers Ubuntu/Debian but fails on openEuler with two errors:

--setup-only fails with unsupported Linux distribution — distro_from_id in src/setup/packages.rs does not recognize openEuler, so the runtime package list cannot be resolved.
overlaybd provisioning fails with unsupported overlaybd release target — configured_overlaybd_release in src/setup/overlaybd.rs does not map openEuler to the RPM-family fallback.

No issue filed

Scope and non-goals

Included:

openEuler (ID=openEuler, lowercased to openeuler by the parser) recognized as RPM-family in src/setup/packages.rs
openEuler mapped to the existing Ubuntu 22.04 overlaybd fallback in src/setup/overlaybd.rs
Test coverage for both code paths

Excluded:

No changes to dependency URLs, manifests, or tooling (upstream aenv-deps release already provides aarch64 binaries)
No changes to tools-image/ build, network mirrors, or documentation
No changes to non-RPM distributions

Design and behavior changes

openEuler already matches the existing RPM-family pattern used by centos/rhel/tencentos:

src/setup/packages.rs: distro_from_id maps openeuler/openEuler to Distro::Centos, reusing the existing dnf/yum package-manager detection and the libaio runtime package list.
src/setup/overlaybd.rs: configured_overlaybd_release maps openEuler to ubuntu1.22.04.{arch} — the oldest published Ubuntu overlaybd asset, chosen because it bundles its own shared libraries and runs on any glibc-based distro (same reasoning as the existing tencentos/centos/rhel fallback).

Compatibility and operations

Public API or generated protocol: N/A
Configuration or defaults: N/A
Snapshot manifest, artifact layout, or storage format: N/A
Upgrade and rollback: N/A — additive recognition of a previously-unsupported OS
Host requirements, permissions, ports, or dependencies: openEuler hosts additionally need dpkg (to extract the overlaybd .deb)

Validation

make fmt
make clippy
make test-unit
Relevant Rust integration tests
make -C services test (required when services/ changes)
Generated clients/server regenerated with the documented make target
Documentation updated
Benchmarks or performance comparison completed

Commands and results:

Skipped checks and reasons:

Risks and reviewer notes

Checklist

The PR contains one coherent change and no unrelated formatting or refactoring.
New behavior is covered by tests, or I explained why testing is impractical.
Logs and examples contain no credentials, tokens, or private registry information.
I did not manually edit generated code without updating its source and regenerating it.

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

bsakaguchi

closed this issue
added the
pull-request
label

bsakaguchi referenced this issue

2026-10-29 14:21:25 +00:00

[PR #197] [MERGED] chore(release): bump version to v0.1.3 #245

Rows
Columns

[PR #129] [MERGED] feat: add openEuler support to Linux distro detection #197