Deployment Cheat Sheet

Common gotchas and quick fixes when deploying CVMs, including cross-architecture image builds and Docker log sizing.

Platform Compatibility

Build Docker Images on x86 Linux

When developing on Mac ARM (M1/M2/M3), build your Docker images for linux/amd64 before deploying. Phala Cloud runs x86_64 — ARM images will fail to start.

Resources:

• Docker Multi-platform Builds
• Building x86 Docker Images on M1 Macs
• Running x86_64 Docker Images on Apple Silicon

Performance Optimization

Limit Docker Log Size

Configure logging options for all services to prevent excessive disk usage:

x-common: &common-config
  restart: always
  logging:
    driver: "json-file"
    options:
      max-size: "100m"
      max-file: "5"

services:
  example:
    <<: *common-config
    image: example:0.1.0
    container_name: example
    ports:
      - "8000:8000"