# Services

> Exécutez les conteneurs de votre application, dimensionnez-les environnement par environnement et redémarrez-les sans changer leur configuration.

Un service est un programme de votre application qui tourne en continu dans un conteneur : un front web, une API, un traitement de fond. Vous le décrivez une fois dans l'architecture de l'application, puis vous le faites tourner dans chaque environnement avec les ressources qui conviennent.

## Comment ça marche

```mermaid
flowchart LR
  REPO["Dépôt Git<br/>services/api"] -->|build| IMG["Image<br/>api:main-20261023-101500"]
  DEF["Définition de service « API »<br/>port 3000 · 100m / 512Mi · sondes /health"]
  DEF --> INST1["Instance en dev<br/>1 réplica"]
  DEF --> INST2["Instance en prod<br/>2 réplicas · 1Gi"]
  IMG -->|déployer| INST1
  IMG -->|déployer| INST2
```

La **définition de service** dit comment construire et lancer le service : dépôt, dossier, Dockerfile, port, ressources par défaut, sondes de santé, variables attendues. Dans chaque environnement, une **instance** fait tourner une image précise de ce service, avec ses propres réplicas et, si besoin, ses propres ressources. Voir [Définitions et instances de service](/v1.0/services/definitions-et-instances).

Le code devient une image par un [build](/v1.0/builds-et-deploiements) ; l'image devient un service en cours d'exécution par un déploiement.

## Commencer

::::cards{cols=3}
:::card{title="Créer un service" href="/v1.0/services/creer-un-service" icon="PlusSquare"}
Déclarez un service dans l'architecture de l'application.
:::
:::card{title="Déployer un service" href="/v1.0/services/deployer-un-service" icon="Rocket"}
Faites-le tourner dans un environnement avec une image construite.
:::
:::card{title="Dimensionner un service" href="/v1.0/services/dimensionner-un-service" icon="Gauge"}
Ajustez réplicas, CPU et mémoire pour un environnement.
:::
::::

## Fonctionnalités

::::cards{cols=3}
:::card{title="Valeurs par défaut héritées" href="/v1.0/services/definitions-et-instances" icon="GitFork"}
Réglez une fois les ressources, surchargez-les seulement où il le faut.
:::
:::card{title="Sondes de santé" href="/v1.0/services/sondes-de-sante" icon="HeartPulse"}
Redémarrage automatique d'un conteneur bloqué, trafic retenu tant qu'il n'est pas prêt.
:::
:::card{title="Redémarrage progressif" href="/v1.0/services/redemarrer-un-service" icon="RotateCw"}
Relancez les conteneurs d'un service sans coupure ni changement de configuration.
:::
:::card{title="État en direct" href="/v1.0/services/consulter-l-etat-d-un-service" icon="Activity"}
Statut, santé, image en cours, métriques et logs sur une seule page.
:::
:::card{title="Monorepo" href="/v1.0/services/creer-un-service" icon="FolderTree"}
Plusieurs services dans un même dépôt, chacun avec son dossier racine.
:::
:::card{title="Variables attendues" href="/v1.0/variables-et-secrets" icon="KeyRound"}
Le service déclare ses variables ; chaque environnement leur donne une valeur.
:::
::::

## Produits liés

::::cards{cols=3}
:::card{title="Builds et déploiements" href="/v1.0/builds-et-deploiements" icon="Hammer"}
Construisez les images de vos services et déployez-les.
:::
:::card{title="Domaines et URLs" href="/v1.0/domaines-et-urls" icon="Globe"}
Exposez un service sur une URL publique.
:::
:::card{title="Supervision et logs" href="/v1.0/supervision" icon="LineChart"}
Lisez les logs et les métriques de chaque service.
:::
::::

## Ressources

- [Référence des services](/v1.0/services/reference)
- [Résoudre les problèmes de services](/v1.0/services/depannage)
- [Applications et environnements](/v1.0/applications)
- [Limites et quotas](/v1.0/limites)
