Déployer Node.js.Exécutez la commande de production réelle.
Déployez un processus web ou un worker Node.js persistant à partir de ses scripts de packages existants, avec les contrôles de santé de la version, les journaux, les secrets, le routage et l’historique Git associés.
Conserver le dépôtExaminer la compilation et les journauxDomaines personnalisés et TLS
Déploiement Adios
Version candidate
Node.js
Opérationnel
SOURCE
Git
REGION
de
ROUTE
HTTPS
01Source reçue
02Compilation terminée
03Environnement d’exécution démarré
04Vérification de santé réussie
Route promue en production
production.adios.run
Une mise en production adaptée à
Node.js 24ExpressFastifyNestJSHonoWorkers
Le parcours de mise en production
Même opérationnel, un projet Node.js doit être mis en production en toute sécurité.
L’application ou le service ne représente qu’une partie de la production. Les résultats de compilation, l’état d’exécution, les contrôles de santé, les secrets, les journaux, les routes et la version promue doivent pouvoir être examinés ensemble.
Conservez votre méthode de compilation Node.js
Installez les dépendances à partir du fichier de verrouillage enregistré dans le dépôt et exécutez le script de compilation existant du projet. Les applications JavaScript et TypeScript conservent leur organisation habituelle de packages et leurs commandes.
Promouvoir la version dont les contrôles de santé réussissent
Démarrez le point d’entrée de production, écoutez sur le port déclaré et exigez une réponse du contrôle de santé avant d’activer la version candidate.
Relier la production au code source
Les résultats de compilation, les journaux d’exécution, l’état de santé, les secrets, les domaines et la version promue restent associés au projet au lieu d’être dispersés entre des outils indépendants.
Du code source à la mise en production
Trois étapes vous permettent de vérifier le parcours de déploiement.
Utilisez le code source et le fonctionnement en production déjà définis pour le projet. Le manifeste décrit ce que la plateforme doit compiler ou provisionner et les critères à remplir pour que le résultat soit prêt.
01
Commencer par la source ou un modèle
Importez le dépôt existant, ou examinez et déployez l’une des variantes de modèles précisément référencées ci-dessous.
$adios login
02
Revoir le contrat de déploiement
Consignez dans adios.yaml les commandes, la version de l’environnement d’exécution ou du service, les critères de santé et les références aux secrets.
$git diff -- adios.yaml
03
Déployer et inspecter le résultat
Suivez les résultats de compilation et d’exécution, vérifiez la version candidate, puis ouvrez la route ou la connexion de service promue en production.
$adios up
adios.yaml
Votre projet
name: node-service
build_cmd: npm ci && npm run build
start_cmd: node dist/server.js
runtime:
name: node@24
port: 8080
health_path: /healthz
Adaptez le gestionnaire de packages, le répertoire de sortie, la commande de démarrage et le chemin de contrôle de santé à votre projet.
Points de départ déployables
Démarrer Node.js à partir d'un modèle lorsque le dépôt n'est pas prêt.
Choisissez Express, Fastify ou NestJS pour partir d’un modèle adapté à votre framework, ou examinez Hono pour une API plus légère.
Projets de démarrage d’API
Node.js Express
Projets de démarrage Express, Fastify, Hono et NestJS avec des commandes de démarrage adaptées à la production.
JavaScriptnpm
Clé du modèle
node-express
Environnement d’exécution
node
Dépôt
template-node-express
Emplacement de la source
.
git clone https://github.com/adiosdotdev/template-node-express.git
cd template-node-express
adios up
Vérifier la charge de travail.Puis promouvez la version en production.
Pour sécuriser la première mise en production, partez d’une compilation ou d’une configuration de service reproductible et d’un aperçu qui sollicite les dépendances réellement utilisées en production.
Prêt quand...
Les dépendances sont installées à partir d’un ensemble de packages dont les versions sont verrouillées.
La commande de production n’utilise pas de surveillance des fichiers propre au développement.
Le processus écoute sur le port du manifeste.
Les identifiants d’exécution ne sont pas enregistrés dans le dépôt.
Prévisualiser quand...
Des modules natifs ou des binaires de navigateur sont installés pendant la compilation.
L’application utilise des workers, des WebSockets ou des flux.
Le démarrage dépend d’une base de données ou d’un broker de messages.
Les réponses à vos questions
Ce qu’il faut savoir avant de déployer Node.js.
Vérifiez les limites de l’environnement d’exécution ou du service, le chemin du modèle, le comportement en cas d’échec et les contrôles de production avant de créer la première version.
Adios peut-il déployer un projet Node.js existant ?
Oui. Exécutez la CLI Adios depuis la racine du projet, conservez votre dépôt et vos fichiers de dépendances et ajoutez un fichier adios.yaml décrivant la compilation de production, la commande de démarrage, le port et le chemin de contrôle de santé.
Ai-je besoin de Docker pour déployer Node.js ?
Pas pour un environnement d’exécution standard pris en charge. Utilisez les commandes de production habituelles du projet dans adios.yaml. Si la compilation nécessite des packages système inhabituels ou des bibliothèques natives, vérifiez ces dépendances dans un aperçu avant la promotion en production.
Puis-je utiliser npm, pnpm ou un autre gestionnaire de packages Node.js ?
Utilisez le gestionnaire de paquets et le fichier de verrouillage déjà choisi par le dépôt, puis mettez ses commandes déterministes d'installation et de production dans adios.yaml.
Un worker Node.js peut-il fonctionner sans route HTTP ?
Oui. Donnez au worker une commande de démarrage persistante et définissez une stratégie de contrôle de santé adaptée. Testez les nouvelles tentatives, l’arrêt et les échecs de dépendances indépendamment du trafic web.
Que se passe-t-il si la compilation ou le contrôle de santé échoue ?
La version candidate conserve ses résultats de compilation et d’exécution pour vérification. Ses contrôles de santé doivent réussir avant sa promotion comme version desservant la route de l’application.
Puis-je partir d’un modèle plutôt que d’un dépôt existant ?
Oui. Cette page référence les modèles Adios officiels les plus proches pour Node.js. Examinez la variante exacte du code source, déployez-la dans la console ou clonez-la localement et exécutez adios up.