Skip to content

fix: Bun Feature Failure on Apple Silicon ARM64 + Feature Hardening #149

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
trevordcampbell wants to merge 1 commit into
base: main
Choose a base branch
from
Open

fix: Bun Feature Failure on Apple Silicon ARM64 + Feature Hardening #149

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 29 additions & 7 deletions src/bun/NOTES.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -34,19 +34,41 @@ Pin a specific version:
## Support

- Distros: `Debian` / `Ubuntu` and `Alpine`
- Architectures: `x86_64` and `arm64`
- Architectures: `x86_64` and `arm64` (based on available Bun releases)

## Tests

This feature is tested against various Distro:
This feature is tested against various Distros:

- `Ubuntu` (latest)
- `Debian` (latest)
- `Alpine` (latest)
- `Debian` with a pinned version of Bun (e.g., Bun `v1.1.38`)
- `Ubuntu` (glibc)
- `Debian` (glibc)
- `Alpine` (musl)
- `Debian` with a pinned version of Bun

*Note: Only architectures with actual Bun release assets are supported (x86_64 and arm64).* *

## Architecture and Asset Selection

This feature automatically selects the correct Bun release asset based on the detected architecture and libc:

- **x86_64**: Uses "baseline" builds for optimal CPU compatibility (e.g., `bun-linux-x64-baseline.zip`)
- **arm64**: Uses standard builds since "baseline" variants are not published for ARM64 (e.g., `bun-linux-aarch64.zip`)

The installation includes robust fallback logic:

- Primary: Preferred asset pattern for the detected architecture/libc combination
- Fallback: Alternative patterns if the primary asset is not found
- Error handling: Clear error messages if no suitable asset is available

This approach ensures compatibility across different platforms while gracefully handling potential future changes to Bun's release asset naming.

## Considerations / Future Enhancements

- If Bun’s release assets ever require explicit filtering, we can wire an `assetRegex` or pass `additionalFlags` to the `gh-release` helper. The helper already auto-filters by platform/arch, so no extra flags are set currently.
- Coexistence with Node.js: this feature only installs `bun` and a `bunx` shim and does not modify Node.js.
- PATH/profile: installation to `/usr/local/bin` avoids profile changes.
- Asset regex patterns: the fallback chain ensures compatibility even if Bun changes their release asset naming conventions.

## Debugging

- To enable additional debug logs during installation, set the environment variable `BUN_FEATURE_DEBUG=1`.
- Diagnostic logs from detection functions are emitted to stderr to keep return values clean.
2 changes: 1 addition & 1 deletion src/bun/devcontainer-feature.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"id": "bun",
"version": "1.0.0",
"version": "1.1.0",
"name": "Bun",
"documentationURL": "http://github.com/devcontainers-extra/features/tree/main/src/bun",
"description": "Bun is an all-in-one toolkit for JavaScript and TypeScript apps.",
Expand Down
Loading