CI Architecture Detection

CI Architecture Detection and Container Builds

This document explains how the CI workflow handles different runner architectures and modern container build approaches.

Architecture Support

The CI workflow automatically detects the runner architecture and downloads the appropriate binaries for:

• Hugo Extended: Required for Hugo modules and SCSS processing
• golangci-lint: Code quality linting

Supported Architectures

Detection Logic

1
2
3
4
5

case "$(uname -m)" in
  x86_64) ARCH="amd64" ;;
  aarch64|arm64) ARCH="arm64" ;;
  *) echo "Unsupported architecture: $(uname -m)"; exit 1 ;;
esac

Container Builds with Kaniko

The CI uses Kaniko for container image builds instead of Docker-in-Docker.

Why Kaniko?

Traditional Docker-in-Docker Issues:

• Requires Docker daemon in CI environment
• Complex permission management (privileged containers)
• systemd/service management problems in containers
• Reliability issues with daemon startup

Kaniko Advantages:

• ✅ No Docker daemon required
• ✅ Works in any container environment
• ✅ Simpler security model
• ✅ Built-in registry authentication
• ✅ Eliminates Docker-in-Docker complexity

Implementation

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

docker-build:
  runs-on: ubuntu-latest
  container: gcr.io/kaniko-project/executor:latest
  steps:
    - name: Build Docker image with Kaniko
      run: |
        /kaniko/executor \
          --dockerfile=Dockerfile \
          --context=. \
          --destination=registry/image:tag \
          --no-push  # or push to registry

Download URLs

Hugo Extended

• x86_64: https://github.com/gohugoio/hugo/releases/download/v{VERSION}/hugo_extended_{VERSION}_linux-amd64.tar.gz
• ARM64: https://github.com/gohugoio/hugo/releases/download/v{VERSION}/hugo_extended_{VERSION}_linux-arm64.tar.gz

golangci-lint

• x86_64: https://github.com/golangci/golangci-lint/releases/download/v{VERSION}/golangci-lint-{VERSION}-linux-amd64.tar.gz
• ARM64: https://github.com/golangci/golangci-lint/releases/download/v{VERSION}/golangci-lint-{VERSION}-linux-arm64.tar.gz

Version Configuration

Binary versions are configured at the top of each installation step:

1
2
3
4
5
6
7
8
9

- name: Install Hugo
  run: |
    HUGO_VERSION="0.151.0"
    # ... architecture detection and download
    
- name: Download golangci-lint
  run: |
    GOLANGCI_VERSION="1.59.1"
    # ... architecture detection and download

Testing

Use the provided test scripts to verify both approaches:

1
2
3
4
5
6
7
8

# Test architecture detection and URL accessibility
./scripts/test-arch-detection.sh

# Test complete CI setup (including Hugo/linter availability)
./scripts/test-ci-hugo.sh

# Test Kaniko container build functionality
./scripts/test-kaniko-ci.sh

Benefits

Architecture Detection

1. Multi-architecture support: Works on both x86_64 and ARM64 runners
2. Faster builds: Downloads prebuilt binaries instead of compiling from source
3. Reliable: Fails fast with clear error messages for unsupported architectures
4. Maintainable: Architecture detection logic is centralized and consistent

Container Build Migration

1. Eliminates Docker daemon issues: No more startup failures or permission problems
2. Better CI reliability: Consistent builds across different CI environments
3. Simplified security: No privileged containers or complex volume mounts required
4. Faster feedback: Immediate build failures instead of timeout loops