[PR #86] [MERGED] feat: add ARM64 support for AgentENV

## 📋 Pull Request Information **Original PR:** https://github.com/kvcache-ai/AgentENV/pull/86 **Author:** [@zlzGithub-0801](https://github.com/zlzGithub-0801) **Created:** 7/30/2026 **Status:** ✅ Merged **Merged:** 8/6/2026 **Merged by:** [@yingdi-shan](https://github.com/yingdi-shan) **Base:** `main` ← **Head:** `feat/arm64-support` --- ### 📝 Commits (1) - [`9c37d83`](https://github.com/kvcache-ai/AgentENV/commit/9c37d837c0f4b734e0959084893b2103256f290a) feat: add ARM64 support for AgentENV ### 📊 Changes **9 files changed** (+138 additions, -36 deletions) <details> <summary>View changed files</summary> 📝 `.github/workflows/release.yml` (+109 -21) 📝 `Makefile` (+2 -1) 📝 `config/deps_manifest.toml` (+3 -3) 📝 `deploy/docker/Dockerfile.agentenv` (+1 -1) 📝 `deploy/docker/Dockerfile.gateway` (+1 -1) 📝 `deploy/docker/Dockerfile.scheduler` (+2 -2) 📝 `docs/src/getting-started/quickstart.md` (+1 -1) 📝 `scripts/install.sh` (+8 -2) 📝 `src/setup/deps.rs` (+11 -4) </details> ### 📄 Description ## What Add ARM64/aarch64 support across AgentENV runtime dependency provisioning, release artifacts, and Docker images. ## Why AgentENV installation and Server releases previously assumed x86_64. On ARM64 hosts, the installer rejected the architecture and dependency setup could not resolve an architecture-specific kernel artifact. ## Related issue Closes #60, #63 ## Scope and non-goals Included: - Firecracker and Linux kernel download paths - Release behavior - Installation script Not included: - Other AgentENV runtime logic ## Design and behavior changes - During setup, download the matching Firecracker binary and Linux kernel based on the configured version and host architecture. - Add `aenv-server-linux-aarch64.tar.gz` to the release artifacts and publish the Docker image as a multi-architecture image. - Update the installation script to select the appropriate release artifact based on the host architecture. ## Compatibility and operations - Public API or generated protocol: N/A — no API schema or generated code changes. - Configuration or defaults: The bundled Firecracker and kernel URLs now point to the `kvcache-ai/firecracker` GitHub Release and include architecture-specific asset names. - Snapshot manifest, artifact layout, or storage format: N/A — no snapshot or persistent storage format changes. - Upgrade and rollback: N/A — Existing x86_64 installations remain supported. - Host requirements, permissions, ports, or dependencies: ARM64 execution requires an aarch64 Linux host with KVM access and the same existing AgentENV host requirements. ## Validation - [x] `make fmt` - [x] `make clippy` - [x] `make test-unit` - [x] Relevant Rust integration tests - [ ] `make -C services test` (required when `services/` changes) - [x] Generated clients/server regenerated with the documented `make` target - [x] Documentation updated - [ ] Benchmarks or performance comparison completed Commands and results: ```text ``` Skipped checks and reasons: This PR does not change `services/` and doesn't have performance-sensitive change either. ## Risks and reviewer notes  ## Checklist - [x] The PR contains one coherent change and no unrelated formatting or refactoring. - [x] New behavior is covered by tests, or I explained why testing is impractical. - [x] Logs and examples contain no credentials, tokens, or private registry information. - [x] 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:36 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/kvcache-ai/AgentENV/pull/86
Author: @zlzGithub-0801
Created: 7/30/2026
Status: ✅ Merged
Merged: 8/6/2026
Merged by: @yingdi-shan

Base: main ← Head: feat/arm64-support

📝 Commits (1)

9c37d83 feat: add ARM64 support for AgentENV

📊 Changes

9 files changed (+138 additions, -36 deletions)

View changed files

📝 .github/workflows/release.yml (+109 -21)
📝 Makefile (+2 -1)
📝 config/deps_manifest.toml (+3 -3)
📝 deploy/docker/Dockerfile.agentenv (+1 -1)
📝 deploy/docker/Dockerfile.gateway (+1 -1)
📝 deploy/docker/Dockerfile.scheduler (+2 -2)
📝 docs/src/getting-started/quickstart.md (+1 -1)
📝 scripts/install.sh (+8 -2)
📝 src/setup/deps.rs (+11 -4)

📄 Description

What

Add ARM64/aarch64 support across AgentENV runtime dependency provisioning, release artifacts, and Docker images.

Why

AgentENV installation and Server releases previously assumed x86_64. On ARM64 hosts, the installer rejected the architecture and dependency setup could not resolve an architecture-specific kernel artifact.

Closes #60, #63

Scope and non-goals

Included:

Firecracker and Linux kernel download paths
Release behavior
Installation script

Not included:

Other AgentENV runtime logic

Design and behavior changes

During setup, download the matching Firecracker binary and Linux kernel based on the configured version and host architecture.
Add aenv-server-linux-aarch64.tar.gz to the release artifacts and publish the Docker image as a multi-architecture image.
Update the installation script to select the appropriate release artifact based on the host architecture.

Compatibility and operations

Public API or generated protocol: N/A — no API schema or generated code changes.
Configuration or defaults: The bundled Firecracker and kernel URLs now point to the kvcache-ai/firecracker GitHub Release and include architecture-specific asset names.
Snapshot manifest, artifact layout, or storage format: N/A — no snapshot or persistent storage format changes.
Upgrade and rollback: N/A — Existing x86_64 installations remain supported.
Host requirements, permissions, ports, or dependencies: ARM64 execution requires an aarch64 Linux host with KVM access and the same existing AgentENV host requirements.

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:

This PR does not change services/ and doesn't have performance-sensitive change either.

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:46 +00:00

[PR #237] [MERGED] fix(privileges): make scoped-spawn capability tests root-aware #278

Rows
Columns

[PR #86] [MERGED] feat: add ARM64 support for AgentENV #169