Conteneurisation d'applications TypeScript avec Docker : guide complet

Pourquoi la conteneurisation d'applications TypeScript est un must-have pour le développeur moderne

Imaginez la situation : vous avez écrit une super application TypeScript sur votre MacBook, tout fonctionne parfaitement. Vous déployez le code sur un serveur Ubuntu — et vous obtenez une multitude d'erreurs. Familier ? Le problème réside dans les différences d'environnements : versions de Node.js, bibliothèques système, variables d'environnement. Docker résout ce problème une fois pour toutes. La conteneurisation d'applications TypeScript permet d'empaqueter le code avec toutes ses dépendances dans un conteneur isolé qui s'exécutera de manière identique sur n'importe quel serveur, dans le cloud ou sur la machine locale d'un collègue.

Dans cet article, nous allons voir comment conteneuriser correctement une application TypeScript avec Docker. Vous apprendrez non seulement les étapes de base, mais aussi des techniques avancées : les builds multi-stage, l'optimisation de la taille de l'image, la mise en cache des dépendances et la gestion des variables d'environnement. C'est parti !

Qu'est-ce que Docker et pourquoi en a-t-on besoin en tant que développeur TypeScript

Docker est une plateforme pour créer, distribuer et exécuter des applications dans des conteneurs. Un conteneur est un environnement léger et autonome qui contient tout le nécessaire au fonctionnement de votre application TypeScript : code, runtime (Node.js), outils système, bibliothèques et configurations.

Les avantages pour les projets TypeScript sont évidents :

\n
• Reproductibilité de l'environnement — plus de « ça marche chez moi » et de « ça plante en production ».
\n
• Isolation — chaque application fonctionne dans son propre conteneur sans interférer avec les autres services.
\n
• Scalabilité — facile de lancer 10 instances de votre serveur TypeScript via Docker Compose ou Kubernetes.
• Simplicité de déploiement — une seule image peut être exécutée sur n'importe quelle plateforme : AWS, Google Cloud, DigitalOcean ou en local.

Prérequis

Avant de commencer, assurez-vous d'avoir installé :

\n
• Docker — téléchargez depuis le site officiel (fonctionne sur Windows, macOS, Linux).
\n
• Node.js version 18 ou supérieure (pour la compilation TypeScript).
\n
• TypeScript — installé globalement ou localement dans le projet.

Comme exemple, nous prendrons une simple application Express en TypeScript. Mais l'approche est universelle : vous pouvez conteneuriser n'importe quel projet TypeScript — d'un bot Telegram à un serveur NestJS.

Structure du projet

Pour commencer, créons une structure minimale d'application TypeScript :

my-typescript-app/\n├── src/\n│   └── index.ts\n├── package.json\n├── tsconfig.json\n└── Dockerfile

Le fichier src/index.ts contiendra un serveur HTTP simple :

import express from 'express';\nconst app = express();\nconst PORT = process.env.PORT || 3000;\n\napp.get('/', (req, res) => {\n  res.send('Hello from TypeScript + Docker!');\n});\n\napp.listen(PORT, () => {\n  console.log(`Server is running on port ${PORT}`);\n});

Le fichier tsconfig.json avec les configurations de base :

{\n  "compilerOptions": {\n    "target": "ES2020",\n    "module": "commonjs",\n    "outDir": "./dist",\n    "rootDir": "./src",\n    "strict": true,\n    "esModuleInterop": true\n  }\n}

Écrire le premier Dockerfile pour une application TypeScript

La méthode la plus simple est de faire un build en une seule étape. Mais nous allons tout de suite suivre la bonne voie et créer un build multi-stage. Cela permettra de réduire l'image finale de plusieurs fois.

# Stage 1: Build\nFROM node:18-alpine AS builder\nWORKDIR /app\nCOPY package*.json ./\nRUN npm install\nCOPY . .\nRUN npm run build\n\n# Stage 2: Production\nFROM node:18-alpine\nWORKDIR /app\nCOPY --from=builder /app/dist ./dist\nCOPY --from=builder /app/package*.json ./\nRUN npm install --production\nEXPOSE 3000\nCMD ["node", "dist/index.js"]

Détaillons chaque étape :

\n
• bu