Aller au contenu

Construire des images ARM64 depuis un runner x86 avec buildx et QEMU

Mon runner CI/CD tourne sur un PC x86_64, mais l'application se déploie sur un Raspberry Pi en ARM64. Retour sur le build croisé et sur le piège du registre Docker en HTTP.

Publié le 2 min de lectureProjet lié : Homelab Proxmox

#Docker#CI/CD#ARM64#Homelab

Dans mon homelab, chaque git push sur l’API de démonstration déclenche une chaîne complète : récupération du code, build de l’image Docker, publication sur un registre privé, déploiement en SSH sur le Raspberry Pi, puis vérification automatique que le service répond.

Le problème : le runner GitHub Actions auto-hébergé tourne sur le PC Proxmox, en x86_64, alors que le Raspberry Pi est en ARM64. Une image construite nativement sur l’un ne s’exécute tout simplement pas sur l’autre.

Le build croisé : buildx et QEMU

Plutôt que d’ajouter un second runner physique en ARM64, le runner x86 construit directement des images ARM64. Deux briques rendent ça possible :

  • QEMU, enregistré sur le runner, qui émule le jeu d’instructions ARM64 pendant le build ;
  • docker buildx, qui permet de cibler une autre plateforme avec --platform linux/arm64.

Le piège : BuildKit et le registre en HTTP

Le registre Docker privé tourne en HTTP simple sur le réseau local. Or BuildKit, le moteur de build de buildx, s’exécute dans son propre conteneur : il ignore la configuration Docker de l’hôte et refuse de pousser vers un registre non HTTPS, ce qui est un comportement de sécurité par défaut.

La solution a été de donner à BuildKit sa propre configuration, qui déclare explicitement le registre interne comme registre HTTP de confiance, puis de créer le builder avec cette configuration :

- name: Préparer buildx
  run: |
    printf '[registry."192.168.1.102:5000"]\n  http = true\n  insecure = true\n' > /tmp/buildkitd.toml
    docker buildx rm multiarch 2>/dev/null || true
    docker buildx create --use --name multiarch --driver docker-container --config /tmp/buildkitd.toml

- name: Build ARM64 et push vers le Registry
  run: |
    docker buildx build \
      --platform linux/arm64 \
      -t $REGISTRY/$IMAGE_NAME:${{ github.sha }} \
      -t $REGISTRY/$IMAGE_NAME:latest \
      --push .

Extrait du workflow réel deploy.yml, lignes 21 à 33.

Le builder est recréé à chaque exécution (buildx rm puis buildx create), ce qui garantit que la configuration utilisée est toujours celle du dépôt.

Pourquoi un runner auto-hébergé

La compilation croisée est plus lourde qu’un build natif. Elle s’exécute ici sur du matériel déjà possédé, et le registre Docker privé n’a jamais besoin d’être exposé sur Internet : tout reste dans le réseau Tailscale.

Ce que j’en retiens

Le build croisé lui-même tient en une option. Ce qui a demandé du diagnostic, c’est de comprendre que BuildKit vit dans son propre conteneur, avec sa propre configuration : le refus de pousser ne venait pas du registre, mais de cette configuration isolée.

Le homelab complet est décrit sur sa fiche, et l’API de démonstration est sur GitHub.

Toutes les notes