Aller au contenu

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.

GuideDéveloppeur
Accès requis
Accès à l'infrastructure de l'application (profil Infra)
Durée
10 min
Voir en Markdown

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 200 sur GET /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 :

  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