Skip to content

Référence des services

Champs d'une définition et d'une instance de service, valeurs par défaut, formats acceptés, statuts et limites.

ReferenceDeveloper

This page has not been translated yet and is shown in French.

Les services se gèrent depuis la console ; il n'existe pas d'API publique d'hébergement. Les noms entre parenthèses sont ceux du format de l'architecture JSON.

Définition de service

Écrans : Architecture > Services > Nouveau service, puis la fiche du service (onglets Général et Variables consommées).

Champ (console)FormatDéfautModifiable
Nom (name)1 à 100 caractèresoui
Shortname (shortname)1 à 12 caractères, a-z, 0-9, -, unique dans l'application ; dérivé du nom à la créationnon
Slug (slug)1 à 63 caractères ; dérivé du nom à la créationnon
Rôle (role)Frontend (FRONT), Backend (BACK), Worker (WORKER)Backendoui
Technologie (technology)Texte libre ; nestjs, nextjs et custom ont un port par défautoui
Repository (repoRef)Un dépôt de l'applicationoui
Répertoire racine (rootDirectory)Chemin relatif dans le dépôtracine du dépôtoui
Dockerfile (dockerfilePath)Chemin relatif au contexte de buildDockerfileoui
Contexte de build (buildContext)Chemin relatif au répertoire racine.oui
Ignorer ces chemins pour le build automatique (autoBuildExcludePaths)Motifs glob relatifs au répertoire racineaucunoui
Registry, Projet, Nom de l'imageChemin de l'image registry/projet/nomregistre et projet de l'application ; nom dérivé du nom du serviceoui
Protocole (defaultProtocol)HTTP/HTTPS, gRPC, TCPHTTPoui
Port (defaultPort)1 à 655353000 à la création dans la consoleoui
Exposition (defaultExposure)Indicative ; l'exposition publique passe par une URL et une routeInterneoui
CPU Request, CPU LimitMillicores avec l'unité m, entier, 1m à 2000m100m, 500moui
Memory Request, Memory LimitMi ou Gi, au plus 8Gi128Mi, 512Mioui
Liveness Probe, Readiness Probe, Startup ProbeActivée ou désactivéevoir Sondes de santéoui

Chemin construit pour un build : <dépôt>/<répertoire racine>/<contexte de build>, avec le Dockerfile cherché depuis ce dossier.

Instance de service

Écrans : onglet Services d'un environnement > Déployer un service, puis la page du service.

Champ (console)FormatDéfaut
Définition de serviceUne définition sans instance dans l'environnement
Image à déployer / Image TagUne des 50 dernières images construites avec succès
Nombre de réplicas / ReplicasEntier, 1 au minimum1
CPU Request, CPU Limit, Memory Request, Memory LimitMêmes formats que la définition ; vide = valeur de la définitionvaleurs de la définition

Une définition a au plus une instance par environnement.

Statuts d'une instance

LibelléStatutSignification
En attentePENDINGDemande enregistrée
Provisionnement…PROVISIONINGDéploiement en cours
ProvisionnéPROVISIONEDConteneurs démarrés et en bonne santé, configuration à jour
ErreurFAILEDErreur durable ; la plateforme réessaie
Suppression…DESTROYINGSuppression en cours

Santé

LibelléValeur
SainHEALTHY
DégradéDEGRADED
Non sainUNHEALTHY
InconnuUNKNOWN
N/ANOT_APPLICABLE

Valeurs fixées par la plateforme

ÉlémentValeur
Chemin des sondes/health, sur le port du service
Sonde de viedélai initial 30 s, toutes les 30 s, délai de réponse 10 s, 3 échecs
Sonde de disponibilitédélai initial 10 s, toutes les 10 s, délai de réponse 5 s, 3 échecs
Sonde de démarragetoutes les 10 s, délai de réponse 5 s, 30 échecs
Nom des objets dans l'environnementsvc-<identifiant de l'application>-<slug de l'environnement>-<shortname>
Exposition interneLe service est joignable des autres services de l'environnement sur son port
Image sans déploiementTag latest du dépôt d'images
Mise à l'échelle automatiqueNon disponible

Raisons de déploiement liées à un service

Raison affichéeDéclencheur
Service provisionnéPremier déploiement de l'instance
Image mise à jourNouvelle image déployée
Redémarrage manuelRedémarrer ou Redeploy current image
Limites CPU/mémoire modifiéesRessources ou réplicas de l'instance modifiés
Valeur par défaut d'architecture appliquéeRessource ou sonde par défaut de la définition modifiée
Configuration réseau modifiéePort, protocole ou exposition de la définition modifié

Les raisons liées aux variables sont décrites dans Variables et secrets.

Droits

ActionDroit
Voir les servicesVoir les services (profil Développeur)
Déployer un service dans un environnementCréer un service
Déployer une imageDéployer un environnement
Modifier les ressources et les réplicasScaler un service
RedémarrerRedémarrer un service
Agir sur un environnement de productionle droit de l'action et Accès infrastructure en production

Limites

ÉlémentValeur
CPU par conteneur2000m (2 cœurs)
Mémoire par conteneur8Gi
Shortname12 caractères
Instances par service et par environnement1
Images proposées au déploiementles 50 plus récentes