# Créer un service

> Déclarez un service dans l'architecture de votre application — dépôt, dossier, Dockerfile, image, port et sondes — avant de le construire et de le déployer.

Créer un service ajoute une définition à l'architecture de l'application. Aucun conteneur ne démarre encore : vous lancerez ensuite un build pour produire son image, puis vous le déploierez dans un environnement.

## Avant de commencer

- Le dépôt Git qui contient le code du service est connecté à l'application : voir [Connecter un dépôt Git](/v1.0/builds-et-deploiements/connecter-un-depot).
- Le dépôt contient un Dockerfile qui produit une image exécutable.
- Votre application écoute sur un port fixe et, si vous activez les sondes de santé, répond `200` sur `GET /health` : voir [Sondes de santé](/v1.0/services/sondes-de-sante).

:::important[Choisissez le nom avec soin]
Le nom court du service est dérivé du nom à la création — ses 12 premiers caractères alphanumériques, en minuscules — et ne change plus. Il apparaît dans les noms techniques et les variables calculées du service. Préférez un nom bref : « API », « Front », « Worker ».
:::

## Déclarer le service

::::steps
### Ouvrir le formulaire

Dans le menu de l'application, cliquez sur **Architecture**, puis sur la carte **Services**, puis sur **Nouveau service**. Le formulaire **Nouveau Service** s'ouvre.

### Renseigner les informations de base

Dans la carte **Informations de base** :

1. Dans **Nom**, saisissez le nom du service, par exemple `API`.
2. Dans **Rôle**, choisissez **Frontend - Interface utilisateur web**, **Backend - API principale et logique métier** ou **Worker - Tâche de fond ou job**.
3. Optionnel : dans **Technologie**, saisissez `nestjs`, `nextjs` ou le nom de votre pile. Cette valeur sert de repère ; le port se règle à l'étape suivante.

### Indiquer le code source

Dans la carte **Code source** :

1. Dans **Repository**, choisissez le dépôt. La mention « (managé) » ou « (importé) » rappelle son type, et son URL s'affiche sous la liste.
2. Si le dépôt contient plusieurs services (monorepo), saisissez dans **Répertoire racine** le dossier du service, par exemple `services/api`. Laissez vide si le service occupe tout le dépôt.
3. Dans **Dockerfile**, gardez `Dockerfile` ou saisissez le chemin du fichier, relatif au contexte de build.
4. Dans **Contexte de build**, gardez `.` pour construire depuis le répertoire racine, ou saisissez un sous-dossier de celui-ci.

### Vérifier l'image

Dans la carte **Image Container**, laissez l'**Instance Harbor** proposée, marquée « (défaut) ». Le **Projet Harbor** est fixé par la plateforme. L'encart **Image finale** affiche le chemin complet de l'image que produiront les builds, par exemple `registre/ab12cd/api:<tag>`.

### Régler le réseau

Dans la carte **Réseau par défaut** :

1. Dans **Protocole**, gardez **HTTP/HTTPS** pour un service web.
2. Dans **Port par défaut**, saisissez le port sur lequel votre conteneur écoute. La valeur proposée est `3000`.

### Choisir les sondes de santé

Dans la carte **Health Checks & Probes**, activez **Liveness Probe** et **Readiness Probe** si votre service répond sur `/health`. Activez **Startup Probe** seulement pour un service qui met plus d'une minute à démarrer. Les champs **Path** et **Port** n'ont pas besoin d'être remplis : les sondes interrogent `/health` sur le port du service.

Laissez la carte **Ressources par défaut du service** telle quelle : vous réglerez les ressources par défaut depuis la fiche du service, à l'étape suivante.

### Créer

Cliquez sur **Créer le service**.

Résultat : le message « Service créé » s'affiche (« Le template "API" a été créé. Vous pouvez maintenant le déployer dans un environnement. ») et le service apparaît dans la liste **Services**.
::::

## Régler les ressources par défaut

1. Dans la liste **Services**, ouvrez le menu de la ligne du service et cliquez sur **Modifier**.
2. Dans la carte **Ressources par défaut**, saisissez **CPU Request**, **CPU Limit**, **Memory Request** et **Memory Limit**, par exemple `100m`, `500m`, `256Mi`, `512Mi`.
3. Cliquez sur **Enregistrer**.

Le CPU se saisit en millicores avec l'unité `m` (`1000m` = 1 cœur, `2000m` au plus) ; la mémoire en `Mi` ou `Gi` (`8Gi` au plus). Sans réglage, la plateforme applique `100m` / `500m` de CPU et `128Mi` / `512Mi` de mémoire.

## Vérifier le résultat

- La liste **Services** affiche le service avec son rôle et son image.
- Sa fiche, onglet **Général**, montre le dépôt, le répertoire racine, l'image et les sondes activées.
- Le résumé de chaque environnement indique maintenant « 1 service non instancié » : c'est attendu.

## Voir aussi

- [Lancer un build](/v1.0/builds-et-deploiements/lancer-un-build)
- [Déployer un service](/v1.0/services/deployer-un-service)
- [Modifier un service](/v1.0/services/modifier-un-service)
- [Variables et secrets](/v1.0/variables-et-secrets) : déclarer les variables attendues du service
