🛠 Docker et conteneurs x86 sur la carte

Objetivos

Demostrar la propuesta de valor del Alpha: un verdadero ecosistema de PC portátil (la documentación oficial menciona Docker, Visual Studio y las cámaras RealSense) en 115 × 78 mm. Instalarás Docker Engine bajo Linux, lanzarás un contenedor, montarás un volumen en el SSD NVMe del socket M.2 M-key (PCIe 4×) y entenderás por qué las imágenes ARM de una Raspberry Pi no funcionan aquí (y viceversa).

Material

• LattePanda Alpha bajo Linux (Ubuntu; la documentación oficial documenta la 16.04, las versiones recientes arrancan igual vía UEFI — soporte comunitario)
• Almacenamiento: SSD M.2 NVMe muy recomendable (el Alpha 800 tiene 0 GB integrados; el Alpha 864 tiene 64 GB de eMMC, algo justos para las imágenes)
• 8 GB de RAM LPDDR3 — holgado para contenedores ligeros
• Conexión a Internet (Ethernet recomendado para las grandes descargas de imágenes)

Código completo

# 1. Installer Docker Engine (dépôt officiel Docker)
curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker $USER   # puis se reconnecter

# 2. Vérifier l'architecture x86-64 des images
docker version
docker run --rm hello-world

# 3. Conteneur avec volume sur le stockage NVMe
sudo mkdir -p /srv/alpha-data
docker run -d --name webalpha --restart unless-stopped \
  -p 8080:80 -v /srv/alpha-data:/usr/share/nginx/html:ro nginx:alpine

# 4. Tester depuis la carte elle-même
echo "<h1>LattePanda Alpha x86</h1>" | sudo tee /srv/alpha-data/index.html
curl -s http://localhost:8080

# 5. Contrôler l'empreinte mémoire/CPU (2 coeurs / 4 threads)
docker stats --no-stream

Verificación esperada

docker run --rm hello-world muestra el mensaje de éxito en arquitectura amd64; curl
2
devuelve la página servida por nginx; docker stats` muestra la huella real sobre los 2 núcleos del m3-7Y30. Como es x86-64 estándar, las mismas imágenes que en un PC de escritorio funcionan sin recompilación.

Errores frecuentes

• Intentar usar imágenes ARM (las de la Raspberry Pi): error «image architecture arm does not match» — el Alpha es amd64, se necesitan las variantes x86.
• Quedarse sin almacenamiento en el Alpha 864 (64 GB de eMMC compartidos con el SO): mover el data-root de Docker al SSD M.2.
• Olvidar volver a iniciar sesión después de usermod -aG docker: permission denied /var/run/docker.sock.
• Sobrecargar los 2 núcleos con compilaciones pesadas: el TDP de 4,5 W y la refrigeración pasiva se saturan rápidamente — preferir imágenes ligeras (alpine, distroless) y vigilar la temperatura.