# Référence des builds et déploiements

> Champs, statuts, déclencheurs, tags d'image, raisons de déploiement, règles de rétention et limites des builds et déploiements.

Les builds et déploiements se pilotent depuis la console ; il n'existe pas d'API publique d'hébergement. Pour les concepts, voir [Builds et déploiements, la différence](/v1.0/builds-et-deploiements/builds-et-deploiements).

## Dépôt Git

| Champ (console) | Format | Défaut |
|---|---|---|
| **Repository managé** | Activé : créé par Wakastart ; désactivé : importé | activé |
| **Nom du repository** | 1 à 63 caractères, `a-z`, `0-9`, `-`, unique dans l'application ; non modifiable | |
| **URL du repository** | Dépôt importé seulement : `https://…` terminée par `.git` | |
| **Visibilité** | **Privé**, **Interne**, **Public** | **Interne** |
| **Branche par défaut** | Nom de branche | `main` |

| Statut | Libellé |
|---|---|
| `PENDING` | En attente |
| `PROVISIONING` | Provisionnement… |
| `PROVISIONED` | Provisionné |
| `FAILED` | Échec |
| `DESTROYING` | Suppression… |

Un dépôt géré est créé sur GitHub sous le nom `<identifiant de l'application>-<nom>`. Un dépôt importé est directement **Provisionné**.

## Build

| Champ (console) | Format | Défaut |
|---|---|---|
| **Service** | Un service de l'application | |
| **Type de source** | **Branche**, **Tag**, **Commit SHA** | **Branche** |
| **Branche** / **Tag** | Choisi dans la liste du dépôt, ou saisi | branche par défaut |
| **Commit SHA** | 40 caractères hexadécimaux | |
| **Mode Boost** | Coché ou non | coché |

### Statuts

| Statut | Libellé (liste) | Libellé (page du build) |
|---|---|---|
| `PENDING` | En attente | En attente — « Le build est en file d'attente » |
| `BUILDING` | En cours | Construction en cours — « L'image Docker est en cours de construction » |
| `SUCCEEDED` | Succès | Succès — « Le build s'est terminé avec succès » |
| `FAILED` | Échec | Échec — « Le build a échoué » |

### Déclencheurs

| Libellé | Valeur | Origine |
|---|---|---|
| **Manuel** | `MANUAL` | **Déclencher le build** |
| **Automatique** | `GIT_PUSH` | Push sur une branche suivie avec **Build automatique** |

### Tag d'image

| Source | Format (UTC) |
|---|---|
| Branche | `<branche>-AAAAMMJJ-hhmmss` |
| Tag Git | `<tag>-AAAAMMJJ-hhmmss` |
| Commit | `<branche ou « commit »>-AAAAMMJJ-hhmmss-<sha7>` |

128 caractères au plus, composés de `A-Z`, `a-z`, `0-9`, `_`, `.` et `-` ; les autres caractères deviennent `-`. Chaque build pousse aussi le tag `latest`.

### Ressources d'un build

| Mode | CPU | Mémoire |
|---|---|---|
| Standard | 250m réservés, 1 CPU au plus | 512 Mio réservés, 2 Gio au plus |
| Boost | 500m réservés, 2 CPU au plus | 1 Gio réservé, 15 Gio au plus |

Le build se fait sans cache : chaque build repart de zéro.

## Déploiement

### Statuts

| Libellé | Valeur |
|---|---|
| En attente | `PENDING` |
| En cours | `IN_PROGRESS` |
| Réussi | `SUCCEEDED` |
| Échec | `FAILED` |
| Remplacé | `SUPERSEDED` |
| Ignoré (service désactivé) | `SKIPPED` |

### Déclenché par

| Libellé | Valeur | Signification |
|---|---|---|
| **Utilisateur** | `USER` | Action d'une personne dans la console |
| **Auto** | `AUTO_DEPLOY` | **Auto-deploy on new build** après un build réussi |
| **Système** | `SYSTEM` | Changement propagé par la plateforme |

### Raisons de déploiement

| Catégorie | Raison affichée | Déclencheur |
|---|---|---|
| Provisionnement | Service provisionné | Premier déploiement d'une instance |
| Image | Image mise à jour | Nouvelle image déployée, à la main ou automatiquement |
| Redémarrage | Redémarrage manuel | **Redémarrer** ou **Redeploy current image** |
| Configuration | Limites CPU/mémoire modifiées | Ressources ou réplicas de l'instance modifiés |
| Configuration | Binding de ressource modifié | Liaison à une base ou un bucket modifiée |
| Variable | Variable liée modifiée | Liaison d'une variable modifiée |
| Variable | Variable d'environnement modifiée | Valeur d'une variable de l'environnement modifiée |
| Variable | Variable de plateforme modifiée | Variable fournie par la plateforme modifiée |
| Variable | Contrat de variable modifié | Variable attendue du service ajoutée, modifiée ou supprimée |
| Variable | Variable calculée modifiée | Valeur calculée modifiée, par exemple l'adresse d'un autre service |
| Secret | Secret mis à jour | Valeur d'un secret relié modifiée |
| Architecture | Valeur par défaut d'architecture appliquée | Ressource ou sonde par défaut de la définition modifiée |
| Architecture | Configuration réseau modifiée | Port, protocole ou exposition de la définition modifié |

Un déploiement de raison « Image mise à jour » remplace tous les déploiements encore en attente de la même instance ; les autres ne remplacent que les déploiements en attente de même raison.

## Registre

| Réglage (console) | Valeur | Défaut |
|---|---|---|
| **Purge automatique** | activée ou désactivée | désactivée |
| **Builds gardés par branche** | 3 à 500 | 10 |
| Quota de stockage | fixé par Wakastart, 1 à 10 240 Go | aucun |

| Règle | Valeur |
|---|---|
| Groupes de rétention | une branche ; tous les tags Git ; tous les commits sans branche |
| Protection d'une image déployée ou remplacée | 90 jours |
| Heure de la purge | 3 h 30 chaque nuit |
| Suppressions par nuit | 100 images au plus pour toute la plateforme |
| Mesure de la place occupée | toutes les 15 minutes et après chaque build réussi |
| Libération effective de la place | nettoyage hebdomadaire, le dimanche |
| Avertissement de quota | à 80 % |
| Builds refusés | à 100 % du quota |

| Badge (liste des builds) | Signification |
|---|---|
| **Déployé · prod, dev** | L'image tourne dans des environnements de ces types |
| **Conservé** | L'image est protégée de la purge |
| **Boost** | Le build a utilisé le mode Boost |

## Droits

| Action | Droit |
|---|---|
| Voir les builds | **Voir les builds** |
| Lancer un build | **Déclencher un build** |
| Supprimer un build | **Supprimer un build** |
| Voir le registre | **Voir le stockage du registre** |
| Régler la purge | **Gérer la purge automatique des builds** |
| Activer le build ou le déploiement automatique | **Modifier un environnement** |
| Déployer une image | **Déployer un environnement** |
| Voir l'historique des déploiements | **Voir les deployments** |

En production, chaque action d'écriture demande aussi **Accès infrastructure en production**.

## Limites

| Élément | Valeur |
|---|---|
| Fichier committé depuis la console | 1 Mo |
| Logs conservés par build | la fin de la sortie : 5 000 dernières lignes, 80 000 caractères au plus |
| Images proposées au déploiement | les 50 plus récentes |
| Historique des déploiements | 50 lignes par page, 200 au plus |
| Rafraîchissement de la page d'un build en cours | 5 s |
| Prise en charge d'un build ou d'un déploiement | 10 s au plus |
| Détection d'un build réussi pour le déploiement automatique | 30 s au plus |
| Hébergeur Git pris en charge | GitHub |
