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

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](/v1.0/applications/format-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é](/v1.0/services/sondes-de-sante) | 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](/v1.0/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 |
