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.
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) | 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 |