armybox 0.3.0

A memory-safe #[no_std] BusyBox/Toybox clone in Rust - 299 Unix utilities in ~500KB
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

# Dockerfile for armybox
# Multi-stage build for minimal image size

# =============================================================================
# Stage 1: Build armybox static binary
# =============================================================================
FROM rust:1.83-bookworm AS builder

# Install musl tools for static linking
RUN apt-get update && apt-get install -y \
    musl-tools \
    musl-dev \
    && rm -rf /var/lib/apt/lists/*

# Add musl target
RUN rustup target add x86_64-unknown-linux-musl

WORKDIR /build

# Copy source code
COPY Cargo.toml Cargo.lock ./
COPY src/ src/
COPY benches/ benches/
COPY tests/ tests/

# Build the static binary
RUN RUSTFLAGS="-C target-feature=+crt-static" \
    cargo build --release --target x86_64-unknown-linux-musl \
    --no-default-features --features "coreutils,compression,network,process,system"

# Strip the binary for smaller size
RUN strip /build/target/x86_64-unknown-linux-musl/release/armybox

# =============================================================================
# Stage 2: Minimal runtime image
# =============================================================================
FROM scratch AS runtime

# Copy the static binary
COPY --from=builder /build/target/x86_64-unknown-linux-musl/release/armybox /bin/armybox

# Create symlinks for common utilities
# Note: We'll use the --install feature at runtime instead

# Set up basic environment
ENV PATH="/bin:/usr/bin:/sbin:/usr/sbin"
ENV HOME="/root"

# Default entrypoint is the shell
ENTRYPOINT ["/bin/armybox"]
CMD ["sh"]

# =============================================================================
# Stage 3: Full image with symlinks installed
# =============================================================================
FROM scratch AS full

# Copy the static binary
COPY --from=builder /build/target/x86_64-unknown-linux-musl/release/armybox /bin/armybox

# We can't run --install in a FROM scratch image, so we create a helper
# Users should run: docker run --rm armybox --install /bin
# Or use the armybox:with-symlinks tag

ENV PATH="/bin:/usr/bin:/sbin:/usr/sbin"
ENV HOME="/root"

ENTRYPOINT ["/bin/armybox"]
CMD ["sh"]

# =============================================================================
# Stage 4: Alpine-based image with symlinks (for easier use)
# =============================================================================
FROM alpine:3.19 AS alpine

# Copy armybox binary
COPY --from=builder /build/target/x86_64-unknown-linux-musl/release/armybox /bin/armybox

# Install symlinks
RUN /bin/armybox --install /usr/local/bin

# Set up environment
ENV PATH="/usr/local/bin:/bin:/usr/bin:/sbin:/usr/sbin"

# Use armybox shell as default
SHELL ["/bin/armybox", "sh", "-c"]
CMD ["/bin/armybox", "sh"]