Déployer des applications

Un service est une application déployable construite à partir d’un dépôt Git. Connectez le dépôt, indiquez à Gheima comment le construire et le démarrer, et il redéploie à chaque push.

1. 01

   Push

   Un commit arrive sur la branche configurée.

2. 02

   Build

   Nixpacks détecte votre stack, ou vos commandes s’exécutent.

3. 03

   Déploiement

   La nouvelle version remplace celle en cours.

4. 04

   En ligne

   Les logs défilent sur la page du service.

Connecter un dépôt Git#

1. 1

   Depuis GitHub

   Après avoir connecté l’application GitHub, choisissez un dépôt dans la liste — l’URL de clonage et la branche par défaut se remplissent automatiquement.

2. 2

   Ou saisir une URL

   Cliquez sur « Enter a URL manually » et collez une URL Git comme https://github.com/vous/depot.

Réglages de build et d’exécution#

Ouvrez l’onglet Settings du service. Laissez les commandes de build et de démarrage vides pour laisser Nixpacks détecter votre stack, ou définissez-les explicitement.

Build command

Comment votre app est construite, ex. npm run build. Vide = auto (Nixpacks).

Start command

Comment votre app démarre, ex. npm start. Vide = auto (Nixpacks).

Port

Le port sur lequel votre app écoute. Par défaut 3000 pour les services web.

Health check path

Un chemin qui renvoie 200 quand l’app est saine, ex. /health.

Déploiement automatique au push#

Dans Settings, activez « Auto-deploy on push ». Chaque push sur la branche configurée déclenche un nouveau déploiement, en enregistrant le SHA du commit, le message et l’auteur.

Types de service#

Web

Un service HTTP servi sur un sous-domaine gheima.ma — par défaut.

Worker

Un processus d’arrière-plan sans URL publique (files, tâches).

Static

Un build statique servi en périphérie — voir Sites statiques.

Ressources#

La carte Resources dans Settings dimensionne chaque service : répliques (1–10), mémoire (128–8192 Mo) et CPU (0,1–8 vCPU). Les changements s’appliquent au prochain déploiement, dans les limites de votre plan.

Volumes persistants#

Dans les Paramètres d’un service, attachez un volume persistant à un chemin de montage (ex. /data). C’est un disque local au nœud qui survit aux déploiements et redémarrages — les fichiers écrits y persistent. Appliqué au prochain déploiement. Idéal pour les apps à instance unique ; les apps scale-out doivent utiliser une base managée ou du stockage objet.