michi/edh-stats
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

Enable multi-arch Docker builds with buildx

Browse Source 
Implement multi-architecture builds in deploy.sh via docker buildx
Auto-create a multiarch builder if buildx is missing Build and push
images for linux/amd64 and linux/arm64 Update messaging to reflect
multi-arch pushes
This commit is contained in:
Michael Skrynski
2026-01-15 09:51:26 +01:00
parent df5bf6801e
commit a7e1826140
3 changed files with 95 additions and 38 deletions
Download Patch File Download Diff File Expand all files Collapse all files

56
DEPLOYMENT.md
View File

@@ -24,16 +24,22 @@ This guide covers deploying the EDH Stats Tracker to production using Docker and
chmod +x deploy.sh
# With token as argument
./deploy.sh 1.0.0 ghcr_xxxxxxxxxxxxx
./deploy.sh v1.0.0 ghcr_xxxxxxxxxxxxx
# Or set as environment variable
export GHCR_TOKEN=ghcr_xxxxxxxxxxxxx
export GITHUB_USER=your-github-username
./deploy.sh 1.0.0
./deploy.sh v1.0.0
# Or use interactive mode
./deploy.sh 1.0.0
./deploy.sh v1.0.0
```
**What the script does:**
- Validates Docker and Docker buildx prerequisites
- Builds images for **both** `linux/amd64` (AMD64 servers) and `linux/arm64` (Apple Silicon)
- Pushes to GHCR automatically (no separate push step needed)
- Generates deployment configuration
3. **Review Generated Configuration**
- Check `docker-compose.prod.deployed.yml`
@@ -352,6 +358,50 @@ curl -s http://localhost/ | head -20
## Troubleshooting
### Images Won't Pull / "No Matching Manifest" Error
**Error Example:**
```
no matching manifest for linux/amd64 in the manifest list entries
```
This means the Docker image was built for a different CPU architecture than your server.
**Common Cause:**
- You built the image on Apple Silicon (ARM64) but your server is AMD64 (x86-64)
- Or vice versa
**Solution: Rebuild with Multi-Architecture Support**
The updated `deploy.sh` script now automatically builds for both architectures:
```bash
# Simply run deploy.sh again - it now handles multi-arch builds
./deploy.sh v1.0.4 $GHCR_TOKEN
# The script will:
# - Use Docker buildx to build for linux/amd64 and linux/arm64
# - Push both architectures to GHCR
# - Your server can then pull the amd64 version
```
**Manual Fix (if needed):**
```bash
# Enable buildx
docker buildx create --use --name multiarch-builder
# Rebuild backend for both architectures
docker buildx build \
--platform linux/amd64,linux/arm64 \
--file ./backend/Dockerfile \
--target production \
--tag ghcr.io/YOUR_USER/edh-stats-backend:v1.0.4 \
--push \
./backend
```
---
### Images Won't Pull / "Unauthorized" Error
**Error Example:**

9
QUICK_DEPLOY.md
View File

@@ -12,7 +12,7 @@ Fast-track guide to deploy EDH Stats Tracker to production in minutes.
4. Copy token (save it safely!)
```
### Step 2: Build & Push Images (Local - 3 min)
### Step 2: Build & Push Images (Local - 5 min)
```bash
cd edh-stats
@@ -20,8 +20,13 @@ cd edh-stats
export GITHUB_USER=your-username
export GHCR_TOKEN=ghcr_xxxxx
# Run deployment
# Run deployment (builds for both amd64 and arm64)
./deploy.sh v1.0.0 $GHCR_TOKEN
# Script will:
# - Enable Docker buildx for multi-architecture builds
# - Build images for linux/amd64 (your server) and linux/arm64 (your machine)
# - Push to GHCR automatically
```
### Step 3: Deploy to Server

68
deploy.sh
View File

@@ -83,6 +83,21 @@ validate_prerequisites() {
fi
print_success "Docker daemon is running"
# Check if Docker buildx is available
if ! docker buildx version > /dev/null 2>&1; then
print_warning "Docker buildx not found. Creating builder..."
docker buildx create --use --name multiarch-builder > /dev/null 2>&1 || true
if ! docker buildx version > /dev/null 2>&1; then
print_error "Docker buildx is required for multi-architecture builds."
print_error "Please ensure you have Docker with buildx support."
exit 1
fi
print_success "Docker buildx enabled"
else
print_success "Docker buildx is available"
fi
# Check if Git is installed
if ! command -v git &> /dev/null; then
print_error "Git is not installed. Please install Git first."
@@ -123,21 +138,26 @@ build_backend() {
print_header "Building Backend Image"
print_info "Building: ${BACKEND_IMAGE}"
docker build \
print_info "Building for architectures: linux/amd64,linux/arm64"
docker buildx build \
--platform linux/amd64,linux/arm64 \
--file ./backend/Dockerfile \
--target production \
--tag "${BACKEND_IMAGE}" \
--tag "${BACKEND_IMAGE_LATEST}" \
--build-arg NODE_ENV=production \
--push \
./backend
print_success "Backend image built successfully"
print_success "Backend image built and pushed successfully"
}
build_frontend() {
print_header "Building Frontend Image"
print_info "Building: ${FRONTEND_IMAGE}"
print_info "Building for architectures: linux/amd64,linux/arm64"
# Create a temporary Dockerfile for frontend if it doesn't exist
if [ ! -f "./frontend/Dockerfile.prod" ]; then
@@ -163,13 +183,15 @@ EOF
print_success "Created temporary Dockerfile for frontend"
fi
docker build \
docker buildx build \
--platform linux/amd64,linux/arm64 \
--file ./frontend/Dockerfile.prod \
--tag "${FRONTEND_IMAGE}" \
--tag "${FRONTEND_IMAGE_LATEST}" \
--push \
./frontend
print_success "Frontend image built successfully"
print_success "Frontend image built and pushed successfully"
}
##############################################################################
@@ -192,24 +214,16 @@ login_to_registry() {
push_backend() {
print_header "Pushing Backend Image"
print_info "Pushing: ${BACKEND_IMAGE}"
docker push "${BACKEND_IMAGE}"
print_success "Backend image pushed: ${BACKEND_IMAGE}"
print_info "Pushing latest tag: ${BACKEND_IMAGE_LATEST}"
docker push "${BACKEND_IMAGE_LATEST}"
# Images are already pushed during buildx build step
print_success "Backend image already pushed: ${BACKEND_IMAGE}"
print_success "Latest backend image pushed: ${BACKEND_IMAGE_LATEST}"
}
push_frontend() {
print_header "Pushing Frontend Image"
print_info "Pushing: ${FRONTEND_IMAGE}"
docker push "${FRONTEND_IMAGE}"
print_success "Frontend image pushed: ${FRONTEND_IMAGE}"
print_info "Pushing latest tag: ${FRONTEND_IMAGE_LATEST}"
docker push "${FRONTEND_IMAGE_LATEST}"
# Images are already pushed during buildx build step
print_success "Frontend image already pushed: ${FRONTEND_IMAGE}"
print_success "Latest frontend image pushed: ${FRONTEND_IMAGE_LATEST}"
}
@@ -220,23 +234,11 @@ push_frontend() {
verify_images() {
print_header "Verifying Built Images"
print_info "Checking backend image..."
if docker image inspect "${BACKEND_IMAGE}" > /dev/null 2>&1; then
SIZE=$(docker image inspect "${BACKEND_IMAGE}" --format='{{.Size}}' | numfmt --to=iec 2>/dev/null || docker image inspect "${BACKEND_IMAGE}" --format='{{.Size}}')
print_success "Backend image verified (Size: ${SIZE})"
else
print_error "Backend image verification failed"
exit 1
fi
print_info "Checking frontend image..."
if docker image inspect "${FRONTEND_IMAGE}" > /dev/null 2>&1; then
SIZE=$(docker image inspect "${FRONTEND_IMAGE}" --format='{{.Size}}' | numfmt --to=iec 2>/dev/null || docker image inspect "${FRONTEND_IMAGE}" --format='{{.Size}}')
print_success "Frontend image verified (Size: ${SIZE})"
else
print_error "Frontend image verification failed"
exit 1
fi
print_info "Note: Using buildx for multi-architecture builds"
print_info "Images are built for linux/amd64 and linux/arm64"
print_info "Images are pushed directly to registry (not stored locally)"
print_success "Backend image built and pushed: ${BACKEND_IMAGE}"
print_success "Frontend image built and pushed: ${FRONTEND_IMAGE}"
}
##############################################################################