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.
RéférenceDéveloppeur
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) | Format | Défaut | Modifiable |
|---|---|---|---|
Nom (name) | 1 à 100 caractères | oui | |
Shortname (shortname) | 1 à 12 caractères, a-z, 0-9, -, unique dans l'application ; dérivé du nom à la création | non | |
Slug (slug) | 1 à 63 caractères ; dérivé du nom à la création | non | |
Rôle (role) | Frontend (FRONT), Backend (BACK), Worker (WORKER) | Backend | oui |
Technologie (technology) | Texte libre ; nestjs, nextjs et custom ont un port par défaut | oui | |
Repository (repoRef) | Un dépôt de l'application | oui | |
Répertoire racine (rootDirectory) | Chemin relatif dans le dépôt | racine du dépôt | oui |
Dockerfile (dockerfilePath) | Chemin relatif au contexte de build | Dockerfile | oui |
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 racine | aucun | oui |
| Registry, Projet, Nom de l'image | Chemin de l'image registry/projet/nom | registre et projet de l'application ; nom dérivé du nom du service | oui |
Protocole (defaultProtocol) | HTTP/HTTPS, gRPC, TCP | HTTP | oui |
Port (defaultPort) | 1 à 65535 | 3000 à la création dans la console | oui |
Exposition (defaultExposure) | Indicative ; l'exposition publique passe par une URL et une route | Interne | oui |
| CPU Request, CPU Limit | Millicores avec l'unité m, entier, 1m à 2000m | 100m, 500m | oui |
| Memory Request, Memory Limit | Mi ou Gi, au plus 8Gi | 128Mi, 512Mi | oui |
| Liveness Probe, Readiness Probe, Startup Probe | Activée ou désactivée | voir 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) | Format | Défaut |
|---|---|---|
| Définition de service | Une définition sans instance dans l'environnement | |
| Image à déployer / Image Tag | Une des 50 dernières images construites avec succès | |
| Nombre de réplicas / Replicas | Entier, 1 au minimum | 1 |
| CPU Request, CPU Limit, Memory Request, Memory Limit | Mêmes formats que la définition ; vide = valeur de la définition | valeurs de la définition |
Une définition a au plus une instance par environnement.
Statuts d'une instance
| Libellé | Statut | Signification |
|---|---|---|
| En attente | PENDING | Demande enregistrée |
| Provisionnement… | PROVISIONING | Déploiement en cours |
| Provisionné | PROVISIONED | Conteneurs démarrés et en bonne santé, configuration à jour |
| Erreur | FAILED | Erreur durable ; la plateforme réessaie |
| Suppression… | DESTROYING | Suppression en cours |
Santé
| Libellé | Valeur |
|---|---|
| Sain | HEALTHY |
| Dégradé | DEGRADED |
| Non sain | UNHEALTHY |
| Inconnu | UNKNOWN |
| N/A | NOT_APPLICABLE |
Valeurs fixées par la plateforme
| Élément | Valeur |
|---|---|
| Chemin des sondes | /health, sur le port du service |
| Sonde de vie | dé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émarrage | toutes les 10 s, délai de réponse 5 s, 30 échecs |
| Nom des objets dans l'environnement | svc-<identifiant de l'application>-<slug de l'environnement>-<shortname> |
| Exposition interne | Le service est joignable des autres services de l'environnement sur son port |
| Image sans déploiement | Tag latest du dépôt d'images |
| Mise à l'échelle automatique | Non disponible |
Raisons de déploiement liées à un service
| Raison affichée | Déclencheur |
|---|---|
| Service provisionné | Premier déploiement de l'instance |
| Image mise à jour | Nouvelle image déployée |
| Redémarrage manuel | Redémarrer ou Redeploy current image |
| Limites CPU/mémoire modifiées | Ressources ou réplicas de l'instance modifiés |
| Valeur par défaut d'architecture appliquée | Ressource ou sonde par défaut de la définition modifiée |
| Configuration réseau modifiée | Port, protocole ou exposition de la définition modifié |
Les raisons liées aux variables sont décrites dans Variables et secrets.
Droits
| Action | Droit |
|---|---|
| Voir les services | Voir les services (profil Développeur) |
| Déployer un service dans un environnement | Créer un service |
| Déployer une image | Déployer un environnement |
| Modifier les ressources et les réplicas | Scaler un service |
| Redémarrer | Redémarrer un service |
| Agir sur un environnement de production | le droit de l'action et Accès infrastructure en production |
Limites
| Élément | Valeur |
|---|---|
| CPU par conteneur | 2000m (2 cœurs) |
| Mémoire par conteneur | 8Gi |
| Shortname | 12 caractères |
| Instances par service et par environnement | 1 |
| Images proposées au déploiement | les 50 plus récentes |