# Comment fonctionne Skipbox

> Ce qui se passe entre un push et une tâche terminée : le webhook, les vérifications, un exécuteur créé pour une seule tâche, votre machine dédiée ou une nouvelle VM, et ce qui se passe après la tâche.

Skipbox exécute vos tâches GitHub Actions sur des exécuteurs auto-hébergés qu'il gère pour vous. GitHub exécute toujours vos workflows, conserve vos journaux et affiche les résultats. Skipbox fournit seulement la machine sur laquelle tourne chaque tâche.

## Du push à la tâche terminée

1. Une tâche dont le `runs-on` demande un label Skipbox est mise en file d'attente sur GitHub.
2. GitHub prévient Skipbox par le webhook de l'application.
3. Skipbox vérifie la tâche : le compte doit avoir un forfait ou son essai, avec de la place pour une tâche de plus de cette taille. Le forfait S exécute jusqu'à 8 tâches à la fois, de 4 vCPU · 16 Go chacune. En continu : des tâches qui s'exécutent à tout moment, tout le mois, avec des minutes illimitées. Forfait S : 1, M : 2, L : 4. Burst : d'autres tâches tournent en même temps sur d'autres machines hébergées par Skipbox si une est libre, jusqu'à 7 à la fois. Chaque forfait inclut 10 000 minutes par mois civil. Une tâche en burst démarre sur une machine neuve avec le cache de GitHub Actions ; la machine de votre forfait garde ses caches chauds. Quand les minutes de burst d'un mois sont épuisées, le forfait n'exécute que ses tâches en continu jusqu'au 1er, où le burst revient. Voir [Simultanéité et file d'attente](https://docs.skipbox.dev/fr/concurrency).
4. Skipbox demande à GitHub un enregistrement d'exécuteur qui ne prend qu'une seule tâche, avec les labels propres à la tâche.
5. L'exécuteur va sur la machine dédiée à votre organisation ou sur une nouvelle VM (voir [Isolation des VM](https://docs.skipbox.dev/fr/isolation)). Il prend une tâche avec ces labels, et GitHub lui envoie votre code, les secrets que transmet votre workflow, et un jeton pour la tâche.
6. À la fin de la tâche, votre machine dédiée supprime les identifiants de l'exécuteur et les identifiants git du checkout de la tâche, puis se contrôle elle-même. Elle garde ses caches, et à partir du 13 novembre 2026, le checkout et sa sortie de build (le `target/` de Cargo et le `.next/cache` de Next.js) aussi ; une nouvelle VM est supprimée avec son disque. Un exécuteur encore enregistré est retiré.

## Ce qui ne change pas

- Vos workflows, vos actions et vos journaux restent sur GitHub. Skipbox ne garde aucune copie de votre code ni de vos journaux. Il ne modifie un workflow que par une pull request que vous demandez et fusionnez (voir [Autorisations de l'application GitHub](https://docs.skipbox.dev/fr/permissions)).
- Déplacer une tâche tient en une ligne : son `runs-on`. La ramener, c'est la même ligne.
- Les tâches dont vous ne modifiez pas le `runs-on` continuent de tourner sur les exécuteurs de GitHub.

## Où tournent les tâches

Votre machine dédiée et les nouvelles VM tournent sur un serveur que Skipbox exploite au Japon et sur des serveurs Hetzner Cloud en Finlande et en Allemagne (UE). Les nouvelles VM tournent aussi sur des serveurs Google Cloud au Canada et en France, en Espagne et en Italie (UE). Voir [Réseau et trafic sortant](https://docs.skipbox.dev/fr/network).

## Une tâche à la fois

Une VM exécute une tâche à la fois. Votre machine dédiée est conservée pour la tâche suivante de votre organisation, avec ses caches. Le code des personnes sans accès en écriture (comme les pull requests venant de forks) n'y tourne jamais : il reçoit une nouvelle VM qui lit vos caches sans pouvoir les modifier. Activez « Nouvelle VM pour chaque tâche » pour donner une nouvelle VM à chaque tâche. Une tâche peut tourner jusqu'à 6 heures : voir [Durée maximale d'une tâche](https://docs.skipbox.dev/fr/job-time-limit). Comment les VM sont tenues séparées : [Isolation des VM](https://docs.skipbox.dev/fr/isolation).

Mis à jour le 2026-11-20 · https://docs.skipbox.dev/fr/how-it-works
