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.
- Required access
- Accès à l'infrastructure de l'application (profil Infra)
- Duration
- 10 min
This page has not been translated yet and is shown in French.
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.
- 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
200surGET /health: voir Sondes de santé.
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
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 :
- Dans Nom, saisissez le nom du service, par exemple
API. - Dans Rôle, choisissez Frontend - Interface utilisateur web, Backend - API principale et logique métier ou Worker - Tâche de fond ou job.
- Optionnel : dans Technologie, saisissez
nestjs,nextjsou 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 :
- Dans Repository, choisissez le dépôt. La mention « (managé) » ou « (importé) » rappelle son type, et son URL s'affiche sous la liste.
- 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. - Dans Dockerfile, gardez
Dockerfileou saisissez le chemin du fichier, relatif au contexte de build. - 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 :
- Dans Protocole, gardez HTTP/HTTPS pour un service web.
- 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
- Dans la liste Services, ouvrez le menu de la ligne du service et cliquez sur Modifier.
- Dans la carte Ressources par défaut, saisissez CPU Request, CPU Limit, Memory Request et Memory Limit, par exemple
100m,500m,256Mi,512Mi. - 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
- Déployer un service
- Modifier un service
- Variables et secrets : déclarer les variables attendues du service