> For the complete documentation index, see [llms.txt](https://docs.edgegap.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.edgegap.com/fr/web-games.md).

# Jeux Web (JS/TS) - Premiers pas

Déployez votre premier serveur dédié JavaScript ou TypeScript sur Edgegap. Un guide pratique avec un modèle Node.js minimal, le téléversement et le déploiement mondial pour les jeux multijoueurs dans le navigateur.

Apprenez en pratiquant et déployez votre premier serveur dédié sur Edgegap. À la fin de ce guide, vous aurez déployé un serveur dédié avec Edgegap sans frais.

{% hint style="info" %}
**Ce guide utilise un modèle minimal de serveur WebSocket Node.js**, qui fonctionne avec n'importe quel client de jeu pour navigateur - Three.js, Babylon.js, PlayCanvas, Phaser ou votre propre moteur. Les serveurs construits avec des frameworks comme Colyseus, ou exécutés sur Bun et Deno suivent les mêmes étapes.
{% endhint %}

## ✔️ Préparation

Avant de commencer, assurez-vous de [créer un compte gratuit avec Edgegap](https://app.edgegap.com/auth/register) (aucune carte de crédit requise). Vous pouvez [inviter les membres de votre équipe ensuite](https://app.edgegap.com/user-settings?tab=organizations), même s’ils n’ont pas encore de compte Edgegap.

**Configurez quelques éléments essentiels sur votre machine de développement :**

<details>

<summary><a href="https://nodejs.org/en/download">Installez Node.js 22 ou une version plus récente</a></summary>

* [Installez Node.js depuis la source officielle](https://nodejs.org/en/download), nous recommandons la dernière version LTS.
* Vérifiez votre installation en exécutant `node -v` dans votre ligne de commande.

</details>

<details>

<summary><a href="https://www.docker.com/products/docker-desktop/">Installez Docker Desktop (ou Docker CLI)</a></summary>

* [Installez Docker Desktop à partir de la source officielle](https://www.docker.com/products/docker-desktop/) (aucun compte requis).
* Redémarrez votre ordinateur après avoir terminé l'installation.

</details>

{% hint style="info" %}
**Vous êtes à l'aise avec les builds de votre serveur ?** Passez à [#customize-image](#customize-image "mention") ou [Fonctionnalités avancées](https://docs.edgegap.com/fr/learn/advanced-features.md) pour en savoir plus.
{% endhint %}

## ⚙️ 1. Connecter le compte

Les serveurs JavaScript n'ont pas besoin d'un plugin de moteur. Nous utiliserons votre ligne de commande et notre [Tableau de bord](https://app.edgegap.com/) pour construire, téléverser et déployer votre serveur.

☑️ Connectez-vous à notre Tableau de bord et ouvrez [Registre de conteneurs](https://app.edgegap.com/registry-management/repositories/list). Notez votre **nom du projet** et **identifiants du registre** (nom d'utilisateur et jeton), vous en aurez besoin dans les étapes suivantes.

☑️ Connectez-vous au [Registre de conteneurs d'Edgegap](https://docs.edgegap.com/fr/learn/advanced-features/edgegap-container-registry.md) avec Docker, en utilisant le nom de projet de votre registre, votre nom d'utilisateur et votre jeton :

{% tabs %}
{% tab title="Bash (Linux)" %}

```bash
project='<REGISTRY_PROJECT>';
username='robot$<REGISTRY_ORGANIZATION_ID>+client-push';
token='<REGISTRY_TOKEN>';

echo "$token" | docker login registry.edgegap.com -u "$username" --password-stdin 2>&1
```

{% endtab %}

{% tab title="PowerShell (Windows)" %}

```powershell
$project = '<REGISTRY_PROJECT>'
$username = 'robot$<REGISTRY_ORGANIZATION_ID>+client-push'
$token = '<REGISTRY_TOKEN>'

echo "$token" | docker login registry.edgegap.com -u "$username" --password-stdin 2>&1
```

{% endtab %}
{% endtabs %}

☑️ Vérifiez que vous voyez `Connexion réussie` dans votre ligne de commande.

✅ Vous pouvez maintenant passer à l'étape suivante.

## 🔧 2. Construire le serveur de jeu

Que vous utilisiez une machine Windows, Mac ou Linux, votre **serveur s'exécutera dans un environnement d'exécution Linux**, car la plupart des fournisseurs cloud aujourd'hui (y compris Edgegap) fonctionnent sous Linux. Bonne nouvelle : JavaScript est multiplateforme, donc il n'y a rien à recompiler pour une autre cible, et Docker installera vos dépendances pour Linux à l'étape suivante.

☑️ **Créez un nouveau dossier pour votre serveur avec deux fichiers.** Ce modèle minimal accepte les connexions WebSocket et relaie chaque message à tous les joueurs connectés. Remplacez le relais par votre logique de jeu plus tard.

{% tabs %}
{% tab title="TypeScript - node.js 22.18+ (recommandé)" %}
{% hint style="info" %}
Node.js 22.18+ exécute directement les fichiers TypeScript (supprime les annotations), aucune étape de build n'est nécessaire.
{% endhint %}

1. Copiez le `server.ts` modèle dans votre projet (sauf si vous en avez déjà un) :<br>

   <pre class="language-javascript" data-title="server.ts" data-expandable="true" data-collapsed-line-count="10"><code class="lang-javascript">import http from 'node:http'
   import { WebSocketServer } from 'ws'
   import { DeploymentEnvironment } from '@edgegap/sdk'

   const port = Number(process.env.PORT ?? 7777)
   const deployment = process.env.ARBITRIUM_REQUEST_ID ? DeploymentEnvironment.fromEnv(process.env) : null

   const server = http.createServer((_request: http.IncomingMessage, response: http.ServerResponse) => response.end('ok\n'))
   const wss = new WebSocketServer({ server })

   wss.on('connection', (socket) => {
     console.log(`joueur connecté (${wss.clients.size} en ligne)`)

     socket.on('message', (data) => {
       for (const client of wss.clients) client.send(data.toString())
     })
     socket.on('close', () => console.log(`joueur parti (${wss.clients.size} en ligne)`))
   })

   server.listen(port, '0.0.0.0', () => {
     console.log(`écoute sur 0.0.0.0:${port}`)
     console.log(deployment ? `déploiement ${deployment.requestId} à ${deployment.location?.city}` : 'en local')
   })

   process.on('SIGTERM', () => {
     for (const client of wss.clients) client.close(1001, 'arrêt du serveur')
     server.close(() => process.exit(0))
   })
   </code></pre>
2. Copiez le `package.json` dans votre projet (ou fusionnez-le avec l'existant).<br>

   <pre class="language-json" data-title="package.json" data-expandable="true" data-collapsed-line-count="10"><code class="lang-json">{
     "name": "my-game-server",
     "private": true,
     "type": "module",
     "engines": {
       "node": ">=22"
     },
     "scripts": {
       "start": "node server.ts"
     },
     "dependencies": {
       "@edgegap/sdk": "^1.1.0",
       "ws": "^8.18.3"
     }
   }
   </code></pre>
3. Installez les définitions de type pour votre éditeur :<br>

   <pre class="language-bash" data-collapsed-line-count="10"><code class="lang-bash">npm install --save-dev @types/node @types/ws
   </code></pre>

{% hint style="warning" %}
**La suppression des types ne prend en charge que la syntaxe effaçable.** Évitez `enum`, `namespace`, ainsi que les propriétés de paramètres de constructeur, ou [regroupez plutôt votre serveur](#customize-image).
{% endhint %}
{% endtab %}

{% tab title="JavaScript (node.js plus ancien)" %}

1. Copiez le `server.js` modèle dans votre projet (sauf si vous en avez déjà un) :<br>

   <pre class="language-javascript" data-title="server.js" data-expandable="true" data-collapsed-line-count="10"><code class="lang-javascript">import http from 'node:http'
   import { WebSocketServer } from 'ws'
   import { DeploymentEnvironment } from '@edgegap/sdk'

   const port = Number(process.env.PORT ?? 7777)
   const deployment = process.env.ARBITRIUM_REQUEST_ID ? DeploymentEnvironment.fromEnv(process.env) : null

   const server = http.createServer((_request, response) => response.end('ok\n'))
   const wss = new WebSocketServer({ server })

   wss.on('connection', (socket) => {
     console.log(`joueur connecté (${wss.clients.size} en ligne)`)

     socket.on('message', (data) => {
       for (const client of wss.clients) client.send(data.toString())
     })
     socket.on('close', () => console.log(`joueur parti (${wss.clients.size} en ligne)`))
   })

   server.listen(port, '0.0.0.0', () => {
     console.log(`écoute sur 0.0.0.0:${port}`)
     console.log(deployment ? `déploiement ${deployment.requestId} à ${deployment.location?.city}` : 'en local')
   })

   process.on('SIGTERM', () => {
     for (const client of wss.clients) client.close(1001, 'arrêt du serveur')
     server.close(() => process.exit(0))
   })
   </code></pre>
2. Copiez le `package.json` dans votre projet (ou fusionnez-le avec l'existant).<br>

   <pre class="language-json" data-title="package.json" data-expandable="true" data-collapsed-line-count="10"><code class="lang-json">{
     "name": "my-game-server",
     "private": true,
     "type": "module",
     "engines": {
       "node": ">=22"
     },
     "scripts": {
       "start": "node server.js"
     },
     "dependencies": {
       "@edgegap/sdk": "^1.1.0",
       "ws": "^8.18.3"
     }
   }
   </code></pre>

{% endtab %}
{% endtabs %}

{% hint style="success" %}
`@edgegap/sdk` est facultatif, ce modèle l'utilise pour lire [Variables injectées](#injected-variables) sur Edgegap. Utilisez notre [SDK JavaScript](https://docs.edgegap.com/fr/web-games/matchmaking.md) pour [#session-automation](#session-automation "mention"), ou ajoutez un service de matchmaking tiers.
{% endhint %}

☑️ Installez les dépendances et démarrez votre serveur localement :

{% code collapsedlinecount="10" %}

```bash
npm install
npm start
```

{% endcode %}

☑️ Vérifiez que vous voyez `écoute sur 0.0.0.0:7777` et `en local` dans votre console, puis arrêtez votre serveur avec `Ctrl+C`.

{% hint style="success" %}
Les builds du serveur doivent utiliser l'adresse `0.0.0.0` et le port `7777`. Si vous personnalisez votre port, veuillez indiquer la même valeur dans votre [Applications et versions](https://docs.edgegap.com/fr/learn/orchestration/application-and-versions.md#port-mapping) une fois que vous [#id-5.-upload-to-edgegap](#id-5.-upload-to-edgegap "mention").
{% endhint %}

✅ Vous pouvez maintenant passer à l'étape suivante.

## 🐋 3. Conteneuriser le serveur

Travailler en équipe de développeurs signifie partager votre code. Quand les choses tournent mal, la dernière chose que vous voulez entendre est « ça marche sur ma machine ». Les serveurs de jeu doivent fonctionner de manière fiable sur n'importe quelle machine, car les serveurs d'un jeu à succès tourneront sur des milliers de machines serveur à travers le monde.

Pour aider à rendre votre serveur fiable, nous utilisons Docker - un logiciel de virtualisation garantissant que toutes les dépendances de votre code serveur jusqu'au niveau du système d'exploitation seront toujours exactement les mêmes, peu importe comment ou où le serveur est lancé.

{% hint style="info" %}
Nous recommandons de regarder ["Ne jamais installer localement" (vidéo)](https://www.youtube.com/watch?v=J0NuOlA2xDc\&ab_channel=Coderized). **Vous N'AVEZ PAS besoin d'utiliser Dockerhub avec Docker**.  Docker ≠ Dockerhub. Pensez à Docker comme à un moteur de programmation et à Dockerhub comme à son App Store.
{% endhint %}

☑️ Commencez par exécuter `docker version` dans votre ligne de commande pour vous assurer d'avoir terminé [#preparation](#preparation "mention").

<details>

<summary><a href="https://www.docker.com/products/docker-desktop/">Installez Docker Desktop (ou Docker CLI)</a></summary>

* [Installez Docker Desktop à partir de la source officielle](https://www.docker.com/products/docker-desktop/) (aucun compte requis).
* Redémarrez votre ordinateur après avoir terminé l'installation.

</details>

☑️ **Ajoutez un Dockerfile et un `.dockerignore` fichier à votre dossier de serveur**, une recette pour votre image :

{% tabs %}
{% tab title="TypeScript - node.js 22.18+ (recommandé)" %}
{% code title="Dockerfile" collapsedlinecount="10" %}

```docker
FROM node:22-slim
WORKDIR /app
ENV NODE_ENV=production
COPY package.json package-lock.json ./
RUN npm ci --omit=dev
COPY server.ts ./
USER node
CMD ["node", "server.ts"]
```

{% endcode %}
{% endtab %}

{% tab title="JavaScript (node.js plus ancien)" %}
{% code title="Dockerfile" collapsedlinecount="10" %}

```docker
FROM node:22-slim
WORKDIR /app
ENV NODE_ENV=production
COPY package.json package-lock.json ./
RUN npm ci --omit=dev
COPY server.js ./
USER node
CMD ["node", "server.js"]
```

{% endcode %}
{% endtab %}
{% endtabs %}

{% code title=".dockerignore" collapsedlinecount="10" %}

```
node_modules
.git
*.md
```

{% endcode %}

{% hint style="info" %}
**Démarrez votre serveur avec `node`, pas `npm start`.** Edgegap envoie `SIGTERM` lorsque votre déploiement s'arrête, et seul le processus principal de votre conteneur le reçoit - gérez-le pour mettre en œuvre un arrêt gracieux.
{% endhint %}

☑️ Construisez votre image, en choisissant un nom et un tag d'image :

{% code collapsedlinecount="10" %}

```bash
docker build --platform linux/amd64 \
  -t registry.edgegap.com/<project>/<game-name>:<tag> .
```

{% endcode %}

* **Le nom de l'image** est un identifiant unique de votre choix, qui étiquette votre build de serveur avant son déploiement.
  * En général, il inclura le nom de votre jeu - par exemple « my-game-server ».
  * Préfixez-le avec `registry.edgegap.com/<project>/` en utilisant le nom de votre projet de l'étape [#id-1.-connect-account](#id-1.-connect-account "mention"), afin de pouvoir le téléverser plus tard.
* **Le tag de l'image** est un identifiant pointant vers une version spécifique de votre image.
  * Le terme « artefact de build » est parfois utilisé pour désigner une version spécifique de votre image.
  * Les horodatages sont une excellente option par défaut pour les tags, par exemple `2026.11.02-16.25.00-UTC` .
* **Plateforme** `linux/amd64` garantit que votre image s'exécute sur les serveurs Edgegap, même lors d'un build sur une machine dotée d'une architecture ARM (macOS M1, M2, M3, etc..).

{% hint style="danger" %}
:x: **À ÉVITER — écraser les tags existants ou utiliser `latest`  tag** — cela déploiera un cache obsolète.\
:white\_check\_mark: **À FAIRE — toujours incrémenter votre tag de version** et déployer la nouvelle version.
{% endhint %}

☑️ Attendez que la build se termine et vérifiez qu'il n'y a aucune nouvelle erreur dans votre ligne de commande. L'exécution de cette étape entraînera l'apparition d'une **nouvelle image sur votre machine locale**. Vous pouvez le vérifier soit dans Docker Desktop, dans l'onglet Images sous Local (par défaut), soit dans l'interface CLI docker en exécutant `docker images` .

✅ Vous pouvez maintenant passer à l'étape suivante.

## 🧪 4. Tester le serveur localement

Essayons de déployer localement (sur votre machine) et de connecter un client de jeu, pour nous assurer que l'image du serveur fonctionne correctement avant de l'uploader et de la déployer (ce qui peut prendre un certain temps).

☑️ Démarrez un nouveau conteneur à partir de votre image :

{% code collapsedlinecount="10" %}

```bash
docker run -p 7777/tcp registry.edgegap.com/<project>/<game-name>:<tag>
```

{% endcode %}

* `-p {internal port}/{protocol}` publie et mappe le port de votre serveur `7777` vers un port externe aléatoire. Les WebSockets utilisent le protocole TCP.
* Si vous utilisez une machine avec une architecture ARM (macOS M1, M2, M3, etc.), ajoutez le paramètre `--platform=linux/amd64` .

☑️ Vérifiez que vous voyez `écoute sur 0.0.0.0:7777` dans votre ligne de commande. L'exécution de cette étape entraînera l'apparition d'une **nouveau conteneur démarré** sur votre machine de développement.

{% hint style="info" %}
Pour plus de détails, voir Docker Desktop / Containers, ou la commande Docker CLI `docker ps` .
{% endhint %}

☑️ Il est maintenant temps de **connecter un client de jeu à votre conteneur Docker local** pour vérifier que l'image de votre serveur fonctionne correctement. Ouvrez deux onglets de navigateur, ouvrez la console des outils de développement (`F12`) dans chaque onglet et connectez-vous à votre conteneur en utilisant :

* `localhost` à la place de l'IP du serveur,
* valeur de port externe aléatoire trouvée dans Docker Desktop / Containers.

{% code collapsedlinecount="10" %}

```javascript
const socket = new WebSocket('ws://localhost:<external port>')
socket.onmessage = (event) => console.log('reçu', event.data)
```

{% endcode %}

☑️ Envoyez un message depuis un onglet avec `socket.send('hello')` et vérifiez que les deux onglets affichent `reçu hello`.

<figure><img src="https://3008966946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FCDGTUe5ests3DI3u9rTV%2Fimage.png?alt=media&amp;token=8c4799d8-0622-4142-91a5-93fd1816149c" alt=""><figcaption></figcaption></figure>

☑️ Une fois que vous avez vérifié que vous pouvez vous connecter à votre conteneur de serveur local et jouer sans problème, vous pouvez supprimer le conteneur 🗑️ pour libérer des ressources sur votre machine pour d’autres programmes.

✅ Vous pouvez maintenant passer à l'étape suivante.

## ☁️ 5. Téléverser vers Edgegap

Il est temps de mettre votre serveur en ligne ! Maintenant que votre image peut héberger des joueurs avec succès, nous pouvons la téléverser sur Edgegap et commencer à l’exécuter n’importe où dans le monde. Dans ce guide, nous utiliserons [**le registre de conteneurs d’Edgegap**](https://docs.edgegap.com/fr/learn/advanced-features/edgegap-container-registry.md) (stockage pour les images).

☑️ Téléversez votre image vers le Registre de conteneurs d'Edgegap :

{% code collapsedlinecount="10" %}

```bash
docker push registry.edgegap.com/<project>/<game-name>:<tag>
```

{% endcode %}

{% hint style="success" %}
Trouvez n’importe quel nom et tag d’image stockés sur votre machine dans **Docker Desktop / Images**.
{% endhint %}

☑️ Attendez que le téléversement se termine et vérifiez qu'il n'y a aucune nouvelle erreur dans votre ligne de commande. L'exécution de cette étape entraînera [le téléversement de l'artefact de build vers le Registre de conteneurs d'Edgegap](https://app.edgegap.com/registry-management/repositories/list).

☑️ Ouvrez notre [Tableau de bord](https://app.edgegap.com/application-management/applications/list) et créez une nouvelle Application. Vous pouvez configurer les options suivantes (ou conserver les valeurs par défaut) :

* **Nom de l'application** sur Edgegap peut correspondre à votre nom d'image ou être personnalisée.
* **Version de l'application** sur Edgegap peut correspondre à votre tag ou être personnalisée.
  * Les horodatages sont une excellente option pour les noms de versions d'application, par ex. `2026.11.02-16.25.00-UTC` .
  * Plusieurs versions d'application peuvent pointer vers le même tag d'image, comme `v1.1.0` et `dev` .
  * En savoir plus sur [Applications et versions](https://docs.edgegap.com/fr/learn/orchestration/application-and-versions.md) plus tard.
* **Image** de l'étape [#id-3.-containerize-server](#id-3.-containerize-server "mention"), sélectionnez votre dépôt et votre tag.
* **Ressources** de 0,25 vCPU et 512 Mo de mémoire suffisent largement pour démarrer avec ce modèle.

☑️ Vous serez maintenant invité à définir un port pour la nouvelle version de votre Application :

* **Port** `7777` correspondant au port de votre serveur de l'étape [#id-2.-build-game-server](#id-2.-build-game-server "mention"),
* **Protocole** `WS` (WebSocket),
* **Mise à niveau TLS** activée,
* **Nom** `gameport`.

{% hint style="info" %}
**La mise à niveau TLS permet aux navigateurs de se connecter via des WebSockets sécurisés** (`wss://`). Les pages servies via `https://` ne peuvent pas ouvrir de connexions `ws://` non sécurisées, alors laissez la Mise à niveau TLS activée pour les jeux pour navigateur.
{% endhint %}

{% hint style="info" %}
Le niveau gratuit est limité à 2 applications, 2 versions et 10 Go de stockage du registre de conteneurs.
{% endhint %}

{% hint style="success" %}
**Vous utilisez un agent de codage ?** Voir [Intégration MCP](https://docs.edgegap.com/fr/docs/integration-mcp.md) pour créer des applications, des versions et des déploiements sans quitter votre éditeur.
{% endhint %}

✅ Vous pouvez maintenant passer à l'étape suivante.

## 🚀 6. Déployer dans le cloud

Ceci est l'étape finale de ce guide, après laquelle vous disposerez d'un serveur déployé sur le cloud Edgegap, auquel des joueurs du monde entier pourront se connecter.

☑️ **Choisissez une application et une version** de l'étape précédente à déployer.

☑️ Une fois prêt, cliquez sur **Déployer sur le Cloud**, attendez d'atteindre [/pages/5d7a2f9e0583a99d78071f1c4b8a7892a518534a#id-3.-deployment-ready](https://docs.edgegap.com/pages/5d7a2f9e0583a99d78071f1c4b8a7892a518534a#id-3.-deployment-ready "mention"). L'achèvement de cette étape entraînera le démarrage d'un [nouveau déploiement](https://app.edgegap.com/deployment-management/deployments/list) sur votre compte Edgegap.

☑️ Vérifiez qu'il n'y a pas de nouvelles erreurs dans la sortie de la console. Assurez-vous également que vos [Déploiements](https://docs.edgegap.com/fr/learn/orchestration/deployments.md#container-logs) n'affichent aucune erreur et que vos [Déploiements](https://docs.edgegap.com/fr/learn/orchestration/deployments.md#container-metrics) n'indiquent pas une utilisation des ressources à 100 % (vCPU ou mémoire), sinon de nouvelles connexions de joueurs peuvent être rejetées, ou votre serveur bloqué dans une boucle de redémarrage. Consultez les étapes de dépannage ci-dessous pour résoudre tout problème.

☑️ Nous allons maintenant effectuer le test final et **connecter votre client de jeu à votre déploiement cloud**. Récupérez votre **hôte du déploiement** à la place de l'IP du serveur et le **Port externe** de `gameport`, et connectez-vous avec des WebSockets sécurisés depuis la console de votre navigateur :

{% code collapsedlinecount="10" %}

```javascript
const socket = new WebSocket('wss://<host>:<external port>')
socket.onmessage = (event) => console.log('reçu', event.data)
```

{% endcode %}

<figure><img src="https://3008966946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fz9xjzvZwKSIp9IeC9qo8%2Fimage.png?alt=media&amp;token=e3f345ac-848d-4469-b66f-3655cd393cf3" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Le port externe de votre déploiement sur le cloud Edgegap sera choisi aléatoirement, afin qu'un attaquant potentiel (hacker) soit ralenti et détecté avant de pouvoir causer des dommages.
{% endhint %}

{% hint style="warning" %}
**Désactiver le VPN lors des tests** pour des conditions plus réalistes et recevoir un [déploiement à faible latence](https://docs.edgegap.com/fr/learn/orchestration/deployments.md#server-placement).
{% endhint %}

☑️ Une fois que vous avez vérifié que vous pouvez vous connecter à votre déploiement sans problème et que vous avez fini les tests, **Arrêtez votre déploiement** pour libérer de la capacité dans votre compte pour la prochaine build.

* En cas de problème, [inspectez les journaux du tableau de bord de votre déploiement](https://app.edgegap.com/deployment-management/deployments/list).
* Si vous ne parvenez pas à identifier le problème, nous traînons dans notre [Discord Communautaire](https://discord.gg/NgCnkHbsGp) et heureux de vous aider.

🙌 Félicitations pour votre premier déploiement sur Edgegap ! Si vous souhaitez en savoir plus, continuez à lire.

## 👉 Étapes suivantes

Une fois que vous disposez d'une configuration client/serveur fonctionnelle, assurez-vous de **sauvegarder une copie de votre projet** (en utilisant un logiciel de contrôle de version comme git) afin de toujours pouvoir retracer vos étapes en cas de problème.

Continuez à lire pour en savoir plus sur les sujets liés au cycle de vie des serveurs et à leur découvrabilité.

{% hint style="info" %}
Si vous avez besoin d’aide, [veuillez nous contacter sur Discord](https://discord.gg/MmJf8fWjnt). Pour l’assistance aux jeux en direct, consultez notre [système de tickets](https://edgegap.atlassian.net/servicedesk/customer/portal/3).
{% endhint %}

### Arrêter les déploiements

Une fois la partie terminée (ou lorsque les joueurs partent), votre déploiement peut être arrêté pour économiser des coûts. [Laisser des déploiements vides ou seulement partiellement remplis peut augmenter vos coûts inutilement !](https://edgegap.com/blog/how-session-fill-rate-affects-your-multiplayer-hosting-costs)

Arrêtez votre déploiement depuis le code de votre serveur, Edgegap enverra alors `SIGTERM` à votre serveur :

{% code collapsedlinecount="10" %}

```javascript
const stopDeployment = () =>
  fetch(deployment.selfStopUrl, {
    method: 'DELETE',
    headers: { authorization: deployment.selfStopToken }
  }) // cet exemple utilise le SDK JavaScript pour lire les informations d'arrêt automatique du déploiement
```

{% endcode %}

{% hint style="success" %}
**Appelez `stopDeployment` quand la partie est terminée, lorsque chaque joueur est parti, ou lorsqu'aucun** n'est connecté dans un délai raisonnable après le démarrage du déploiement.
{% endhint %}

{% hint style="warning" %}
Connectez votre [Stockage des points de terminaison](https://docs.edgegap.com/fr/docs/endpoint-storage.md) pour enregistrer les journaux de déploiement, sinon ils seront supprimés !
{% endhint %}

### Variables injectées

Lisez des informations utiles comme l'ID du déploiement, l'adresse IP du serveur, l'emplacement du serveur, et plus encore ; en accédant aux variables d'environnement injectées. Chaque déploiement inclut automatiquement :

* [Variables de déploiement](https://docs.edgegap.com/fr/learn/orchestration/deployments.md#injected-environment-variables) - fournies automatiquement par Edgegap,
* [Variables de matchmaking](https://docs.edgegap.com/fr/learn/matchmaking/matchmaker-in-depth.md#injected-environment-variables) - fournies automatiquement par Edgegap lors de l'utilisation de [Matchmaking](https://docs.edgegap.com/fr/learn/matchmaking.md),
* [Variables de version d'application](https://docs.edgegap.com/fr/learn/orchestration/application-and-versions.md#injected-variables) - paires clé-valeur personnalisées configurables par vous.

Lisez n'importe quelle variable avec `process.env`, ou convertissez-les en objets typés avec notre SDK facultatif :

{% code collapsedlinecount="10" %}

```javascript
import { DeploymentEnvironment } from '@edgegap/sdk'
import { MatchEnvironment } from '@edgegap/sdk/matchmaking'

const deployment = DeploymentEnvironment.fromEnv(process.env)
const match = MatchEnvironment.fromEnv(process.env)
```

{% endcode %}

{% hint style="info" %}
Le parsing ne lève jamais d'erreur, donc le même serveur fonctionne en local. Les variables manquantes sont listées dans un seul avertissement.
{% endhint %}

### Automatisation des sessions

Lors des tests de nouvelles versions avec des développeurs ou des équipes QA, l’étape de session est souvent ignorée et les joueurs se connectent directement aux déploiements, tout en codant en dur ou en désactivant les fonctionnalités liées à la session. Cela permet d’accélérer l’itération de développement et d’isoler les effets secondaires de la session des fonctionnalités du serveur.

{% hint style="warning" %}
**Démarrer vos déploiements manuellement et coller les URL et les ports ne suffira pas pour un jeu en direct.**
{% endhint %}

Automatisez les flux de jeu populaires pour [Sessions de joueur](https://docs.edgegap.com/fr/learn/orchestration/sessions-de-joueur.md) et la montée en charge des serveurs avec l’une des options suivantes :

{% columns %}
{% column width="33.33333333333333%" %}
[Matchmaking](https://docs.edgegap.com/fr/learn/matchmaking.md):

* Jeux compétitifs
* Matchs à la demande
* Classement de compétence et/ou\
  Règles personnalisées
  {% endcolumn %}

{% column width="33.33333333333333%" %}
[Navigateur de serveurs](https://docs.edgegap.com/fr/learn/navigateur-de-serveurs.md):

* Persistant ou social
* Sessions longues
* Affectation automatique et/ou\
  Recherche personnalisée
  {% endcolumn %}

{% column width="33.33333333333333%" %}
Back-end personnalisé :

* Migrer des jeux en direct
* [Déployer avec l’API v2](https://docs.edgegap.com/fr/docs/api/serveurs-dedies.md)
* [Observer les webhooks](https://docs.edgegap.com/fr/learn/orchestration/deployments.md#webhooks)
  {% endcolumn %}
  {% endcolumns %}

{% hint style="success" %}
Ajoutez du matchmaking à votre jeu pour navigateur avec notre optionnel [SDK JavaScript](https://docs.edgegap.com/fr/web-games/matchmaking.md), y compris l'automatisation du client de groupe et du backfill côté serveur.
{% endhint %}

### Exemples

[Inspirez-vous de cinq mini-jeux multijoueurs pour navigateur conçus avec Three.js et des serveurs Node.js faisant autorité.](https://docs.edgegap.com/fr/docs/sample-projects/jeux-web/threejs-minigames.md) Comprend le matchmaking depuis le navigateur, une seule image pour plusieurs jeux, l'affectation des équipes et des déploiements qui s'arrêtent d'eux-mêmes lorsque la partie se termine.

{% hint style="success" %}
[Parcourez nos exemples de jeux](https://docs.edgegap.com/fr/docs/sample-projects.md) pour vous inspirer et gagner en confiance afin d'avancer dans votre projet.
{% endhint %}

### Optimiser l'utilisation

Quelques conseils pour commencer à optimiser l'utilisation de votre serveur :

**Un tick rate plus élevé signifie plus de mises à jour, nécessitant davantage d'utilisation CPU et de trafic sortant.**

* Les jeux pour navigateur simulent souvent entre 30 et 60 ticks par seconde et envoient l'état aux joueurs à 10-20 Hz, les clients interpolant entre les mises à jour. Notre exemple Three.js envoie 20 mises à jour par seconde.
* Node.js exécute votre boucle de jeu sur un seul thread, donc un tick lent retarde les messages pour chaque joueur. Soyez prudent si votre jeu comporte beaucoup de joueurs par partie (10+), des simulations physiques complexes ou de nombreux bots adverses/alliés. Profilez votre serveur avec `node --cpu-prof` pour identifier les points chauds.
* Les messages JSON sont faciles à déboguer, les messages binaires (`ArrayBuffer`) réduisent le trafic sortant pour les mises à jour fréquentes de l'état.

**Comment choisir le bon protocole réseau ? Faites-le fonctionner d'abord, puis améliorez-le.**

* Les navigateurs ne peuvent pas ouvrir de connexions UDP ou TCP brutes, seulement WebSocket, WebRTC et WebTransport. Les WebSockets sont un excellent choix par défaut offrant une compatibilité sur la plus large gamme d'appareils et de réseaux.
* Certains jeux rapides peuvent vouloir expérimenter avec les canaux de données WebRTC ou WebTransport pour une livraison non fiable, mais cela nécessitera certainement des efforts de développement supplémentaires. Demandez-vous si cela est critique pour votre public cible.
* Choisissez soigneusement vos combats, le développement de jeux ne manque pas de défis.

### Personnaliser l'image

Votre Dockerfile de l'étape [#id-3.-containerize-server](#id-3.-containerize-server "mention") peut être personnalisé pour optimiser la taille de build, les dépendances superflues ou nécessiter un processus de démarrage plus complexe. Nous allons maintenant partager quelques conseils et bonnes pratiques "faites-le vous-même".

**Regroupez votre serveur dans un seul fichier avec une build multi-étapes.**

* Des bundlers comme [esbuild](https://esbuild.github.io/) compilent TypeScript et combinent votre code et vos dépendances en un seul fichier, de sorte que votre image finale n'a pas besoin de `node_modules` ou de fichiers source.
* Installez esbuild avec `npm install --save-dev esbuild` et remplacez votre Dockerfile par :

{% code title="Dockerfile" collapsedlinecount="10" %}

```docker
FROM node:22-slim AS build
WORKDIR /app
COPY package.json package-lock.json ./
RUN npm ci
COPY server.js ./
RUN npx esbuild server.js --bundle --platform=node --target=node22 --outfile=dist/server.cjs

FROM node:22-slim
WORKDIR /app
ENV NODE_ENV=production
COPY --from=build /app/dist/server.cjs ./
USER node
CMD ["node", "server.cjs"]
```

{% endcode %}

**Assurez-vous toujours de travailler avec une version de serveur fonctionnelle.**

* Avant de supposer qu’un problème est lié au Dockerfile personnalisé, assurez-vous que votre build de serveur peut être démarré, et que le processus de build dans votre moteur de jeu n’a déclenché aucune exception ni erreur.

**Testez toujours en local avant de téléverser.**

* Tester votre image localement vous fera gagner beaucoup de temps pendant que vous attendez la fin du téléversement. C’est aussi entièrement gratuit ✨ car cela ne nécessite aucune ressource Edgegap.
* Lors des tests en local, assurez-vous de définir correctement votre port interne :

  ```bash
  docker run \
    -p 7777/udp \
    -e ARBITRIUM_PORTS_MAPPING='{"ports":{"gameport":{"internal":7777}}}' \
    'registry.edgegap.com/<repository>:<tag>'
  ```

**Assurez-vous de maîtriser les bases. Chaque Dockerfile a besoin de quelques commandes essentielles :**

* `FROM {image}` est votre image de base ; nous utilisons généralement un Linux pris en charge à long terme, mais toute image de base basée sur Linux fera l’affaire. Il s’agit généralement d’images publiques stockées sur Docker Hub. Référence Dockerfile ici. [Référence Dockerfile ici](https://docs.docker.com/reference/dockerfile/#from).
* `COPY {source} {destination}` pour copier votre build de serveur Linux depuis votre machine hôte dans l’image, afin de pouvoir le démarrer plus tard. [Référence Dockerfile ici](https://docs.docker.com/reference/dockerfile/#copy).
* `USER {user}` doit suivre un [commande useradd (Ubuntu)](https://manpages.ubuntu.com/manpages/bionic/man8/useradd.8.html) ou équivalent ; il vaut mieux ne pas tout exécuter en tant que `root` pour plus de sécurité. [Référence Dockerfile ici](https://docs.docker.com/reference/dockerfile/#user).
* `CMD {command}` sera la dernière ligne, appelant très probablement un `StartServer.sh` ou un script de démarrage de quelque sorte afin de vous assurer que votre serveur s’initialise correctement une fois que tout est configuré. [Référence Dockerfile ici](https://docs.docker.com/reference/dockerfile/#cmd).
* N’utilisez PAS `VOLUME` - vous ne pourrez pas monter de stockage local de cette façon sur Edgegap ; envisagez plutôt notre fonctionnalité de stockage de point de terminaison et utilisez un bucket S3, voir [Stockage de point de terminaison](https://docs.edgegap.com/docs/deployment/endpoint-storage),
* `EXPOSE 7777/UDP`  n’est pas requis ! Cela ne rendra pas réellement le port interne du serveur disponible depuis l’extérieur du conteneur ; ce n’est qu’une indication pour le développeur et le port doit être
  * publié lors des tests en local avec `docker run <image> -p 7777/udp` ,
  * ou mappé dans [le mappage de ports Edgegap](https://docs.edgegap.com/fr/learn/orchestration/application-and-versions.md#other-parameters-optional).

**Retardez la déclaration des paramètres jusqu’au dernier moment possible. La configurabilité > la composabilité en raison des longs temps de build du serveur.** [**Appliquez cette approche aux commandes du Dockerfile afin de construire et téléverser plus rapidement.**](https://medium.com/@esotericmeans/optimizing-your-dockerfile-dc4b7b527756)

* Scénario : vous devez définir des paramètres comme le stade de déploiement, la version, le mode de jeu, la carte, le nombre de joueurs par serveur, la fréquence de sauvegarde, ou similaires.
* Mauvaise solution : créer une image séparée pour chaque combinaison de vos paramètres. Vous passerez tout votre temps à reconstruire les images pour très peu d’avantages avec cette approche.
* Meilleure solution - remplacez les paramètres de configuration juste à temps :
  1. paramètres de déploiement - fournis juste avant le déploiement - sélecteurs de matchmaking transmis sous forme de variables d’environnement, ou votre système personnalisé de gestion de session transmettant des variables d’environnement au moment du déploiement,
  2. paramètres de version - partagés pour tous les déploiements d’une version d’application - stade de déploiement, tag de l’artefact, secrets et points de terminaison tiers, et similaires ; puis
  3. une seule image - contient et charge toutes les options de configuration au lancement.

**N’exécutez PAS de bases de données sur les déploiements Edgegap.**

* Les déploiements Edgegap ne sont pas destinés à des processus de longue durée et peuvent être arrêtés après une longue période d’exécution sans préavis. Une base de données (même distribuée) fonctionnant de cette manière peut être arrêtée et entraîner une perte irréversible de données. Si vous avez besoin d’une base de données, veuillez envisager un DBaaS tiers.
* Envisagez d’utiliser nos [Clusters gérés](https://app.edgegap.com/cluster-management/clusters/list) pour héberger des bases de données et des services de longue durée.
