Aller au contenu

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.

RéférenceDéveloppeur
Voir en Markdown

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.

Dépôt Git

Champ (console)FormatDéfaut
Repository managéActivé : créé par Wakastart ; désactivé : importéactivé
Nom du repository1 à 63 caractères, a-z, 0-9, -, unique dans l'application ; non modifiable
URL du repositoryDépôt importé seulement : https://… terminée par .git
VisibilitéPrivé, Interne, PublicInterne
Branche par défautNom de branchemain
StatutLibellé
PENDINGEn attente
PROVISIONINGProvisionnement…
PROVISIONEDProvisionné
FAILEDÉchec
DESTROYINGSuppression…

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)FormatDéfaut
ServiceUn service de l'application
Type de sourceBranche, Tag, Commit SHABranche
Branche / TagChoisi dans la liste du dépôt, ou saisibranche par défaut
Commit SHA40 caractères hexadécimaux
Mode BoostCoché ou noncoché

Statuts

StatutLibellé (liste)Libellé (page du build)
PENDINGEn attenteEn attente — « Le build est en file d'attente »
BUILDINGEn coursConstruction en cours — « L'image Docker est en cours de construction »
SUCCEEDEDSuccèsSuccès — « Le build s'est terminé avec succès »
FAILEDÉchecÉchec — « Le build a échoué »

Déclencheurs

LibelléValeurOrigine
ManuelMANUALDéclencher le build
AutomatiqueGIT_PUSHPush sur une branche suivie avec Build automatique

Tag d'image

SourceFormat (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

ModeCPUMémoire
Standard250m réservés, 1 CPU au plus512 Mio réservés, 2 Gio au plus
Boost500m réservés, 2 CPU au plus1 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 attentePENDING
En coursIN_PROGRESS
RéussiSUCCEEDED
ÉchecFAILED
RemplacéSUPERSEDED
Ignoré (service désactivé)SKIPPED

Déclenché par

LibelléValeurSignification
UtilisateurUSERAction d'une personne dans la console
AutoAUTO_DEPLOYAuto-deploy on new build après un build réussi
SystèmeSYSTEMChangement propagé par la plateforme

Raisons de déploiement

CatégorieRaison affichéeDéclencheur
ProvisionnementService provisionnéPremier déploiement d'une instance
ImageImage mise à jourNouvelle image déployée, à la main ou automatiquement
RedémarrageRedémarrage manuelRedémarrer ou Redeploy current image
ConfigurationLimites CPU/mémoire modifiéesRessources ou réplicas de l'instance modifiés
ConfigurationBinding de ressource modifiéLiaison à une base ou un bucket modifiée
VariableVariable liée modifiéeLiaison d'une variable modifiée
VariableVariable d'environnement modifiéeValeur d'une variable de l'environnement modifiée
VariableVariable de plateforme modifiéeVariable fournie par la plateforme modifiée
VariableContrat de variable modifiéVariable attendue du service ajoutée, modifiée ou supprimée
VariableVariable calculée modifiéeValeur calculée modifiée, par exemple l'adresse d'un autre service
SecretSecret mis à jourValeur d'un secret relié modifiée
ArchitectureValeur par défaut d'architecture appliquéeRessource ou sonde par défaut de la définition modifiée
ArchitectureConfiguration réseau modifiéePort, 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)ValeurDéfaut
Purge automatiqueactivée ou désactivéedésactivée
Builds gardés par branche3 à 50010
Quota de stockagefixé par Wakastart, 1 à 10 240 Goaucun
RègleValeur
Groupes de rétentionune branche ; tous les tags Git ; tous les commits sans branche
Protection d'une image déployée ou remplacée90 jours
Heure de la purge3 h 30 chaque nuit
Suppressions par nuit100 images au plus pour toute la plateforme
Mesure de la place occupéetoutes les 15 minutes et après chaque build réussi
Libération effective de la placenettoyage hebdomadaire, le dimanche
Avertissement de quotaà 80 %
Builds refusésà 100 % du quota
Badge (liste des builds)Signification
Déployé · prod, devL'image tourne dans des environnements de ces types
ConservéL'image est protégée de la purge
BoostLe build a utilisé le mode Boost

Droits

ActionDroit
Voir les buildsVoir les builds
Lancer un buildDéclencher un build
Supprimer un buildSupprimer un build
Voir le registreVoir le stockage du registre
Régler la purgeGérer la purge automatique des builds
Activer le build ou le déploiement automatiqueModifier un environnement
Déployer une imageDéployer un environnement
Voir l'historique des déploiementsVoir les deployments

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

Limites

ÉlémentValeur
Fichier committé depuis la console1 Mo
Logs conservés par buildla fin de la sortie : 5 000 dernières lignes, 80 000 caractères au plus
Images proposées au déploiementles 50 plus récentes
Historique des déploiements50 lignes par page, 200 au plus
Rafraîchissement de la page d'un build en cours5 s
Prise en charge d'un build ou d'un déploiement10 s au plus
Détection d'un build réussi pour le déploiement automatique30 s au plus
Hébergeur Git pris en chargeGitHub