> 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/godot.md).

# Godot - Prise en main

Déployez votre premier serveur dédié Godot sur Edgegap. Un guide pratique couvrant le build, le téléversement et le déploiement mondial pour les jeux multijoueurs.

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

{% embed url="<https://youtu.be/fcwnUrlkjhA>" %}

## ✔️ 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://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>

<details>

<summary><a href="https://store.godotengine.org/asset/edgegap-godot/dedicated-game-server-hosting-for-godot/">Installer le plug-in de démarrage rapide Edgegap pour les serveurs dédiés Godot</a></summary>

Ce plug-in a été testé et est compatible avec Godot 4.3.x et les versions ultérieures.

Option 1) Installer depuis l’Asset Store :

1. Ouvrez votre projet dans l’éditeur Godot.
2. Ouvrez l’onglet Asset Store et recherchez « edgegap ».
3. Choisissez « Game Server Hosting for Godot », puis cliquez sur Download.

{% hint style="info" %}
Pour mettre à jour le plug-in, accédez à Project / Project Settings / Plugins / Edit et choisissez Update.
{% endhint %}

Option 2) Installer à partir des sources :

1. [Installez un client Git (par exemple, git-scm).](https://git-scm.com/).
2. Depuis le dossier racine de votre projet, clonez le dépôt de notre plug-in dans `addons/edgegap`.

{% code collapsedlinecount="10" %}

```bash
git clone https://github.com/edgegap/buildtool-godot-plugin.git addons/edgegap
```

{% endcode %}

{% hint style="info" %}
Pour mettre à jour le plug-in installé avec Git, ouvrez la ligne de commande dans le dossier du plug-in et exécutez `git pull`.
{% endhint %}

</details>

{% hint style="info" %}
**Activez le nouveau plug-in Edgegap Servers Quickstart sous Project / Project Settings / Plugins.** Un nouvel onglet intitulé « Edgegap » apparaîtra dans le panneau de droite, à côté de l’Inspecteur. Si vous fermez le panneau et souhaitez le rouvrir par la suite, vous trouverez l’option sous Project / Tools / Edgegap.
{% endhint %}

## ⚙️ 1. Connecter un compte

☑️ Connectez-vous et vérifiez qu’aucune nouvelle erreur liée au plug-in Edgegap n’apparaît dans la sortie.

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

## 🔧 2. Générer le serveur de jeu

Que vous utilisiez un ordinateur Windows, Mac ou Linux, vous **devez générer votre serveur pour l’environnement d’exécution Linux**, car la plupart des fournisseurs cloud, dont Edgegap, fonctionnent aujourd’hui sous Linux. Pas d’inquiétude : aucune connaissance de Linux n’est nécessaire pour effectuer cette opération avec notre plug-in.

☑️ **Validez les modèles d’exportation pour vous assurer que le plug-in a correctement configuré le modèle de serveur Linux.**

{% hint style="info" %}
**Utilisateurs avancés**  : personnalisez éventuellement le [modèle d’exportation](https://docs.godotengine.org/en/latest/tutorials/export/exporting_projects.html). Attention ! Cela risque de faire échouer votre build.
{% endhint %}

☑️ **Ajoutez un nouveau script d’initialisation à votre projet pour lancer automatiquement le serveur dédié.** Créez un nœud sous votre scène principale et associez le nouveau script dans Inspector / Script / Load.

{% tabs %}
{% tab title="Exemple de script d’initialisation par défaut" %}
Il s’agit d’un modèle de script minimal que vous pouvez adapter aux besoins de votre projet.

{% file src="/files/5934f234fc63fedd6e13cb931544ee4a29c66c2f" %}
{% endtab %}

{% tab title="Exemple Netfox Forest Brawl" %}
Il s’agit d’une version personnalisée du script d’initialisation pour [netfox forest brawl](#netfox-forest-brawl-example) sample.

{% file src="/files/16d88e9ef8050b7f67d58a6dfdfa21a424e9c0e7" %}
{% endtab %}
{% endtabs %}

{% hint style="success" %}
Par défaut, les builds du serveur utilisent le port `7777`. Si vous personnalisez le port, veuillez indiquer le mêm~~e~~ 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 %}

☑️ Lorsque votre configuration vous convient, cliquez sur **Générer le serveur**, attendez la fin du processus et vérifiez qu’aucune nouvelle erreur n’apparaît dans la sortie. Une fois cette étape terminée, un **nouveau build apparaîtra dans votre projet, dans le dossier** `build`**.**

✅ 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 cliquer sur le bouton **Valider Docker** 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>

☑️ Vous pouvez configurer les options suivantes (ou conserver les valeurs par défaut) :

* **Nom de l’image** est un identifiant unique de votre choix, qui désigne la version compilée de votre serveur avant sa distribution.
  * Il comprend généralement le nom de votre jeu, par exemple « my-game-server ».
* **Balise de l’image** est un identifiant qui désigne une version spécifique de votre image.
  * Le terme « artefact de compilation » est parfois utilisé pour désigner une version spécifique de votre image.
  * Les horodatages sont un excellent choix par défaut pour les balises, par ex. `2026.07.30-16.25.00-UTC` .
* **Chemin d’accès au Dockerfile** permet de personnaliser la recette de vos images.
  * Nous vous recommandons de conserver le paramètre par défaut pour le moment ; vous pourrez en savoir plus plus tard dans la section [#customize-image](#customize-image "mention").
* **Paramètres facultatifs de docker build** permettent de préciser davantage certaines subtilités à Docker.
  * Nous vous recommandons de conserver le paramètre par défaut pour le moment. Vous pouvez [en savoir plus plus tard dans la documentation Docker](https://docs.docker.com/reference/cli/docker/image/build/#options).

{% hint style="info" %}
**Reconstruire à partir du code source** sera automatiquement compilé et conteneurisé, afin de **accélérer votre prochaine compilation**.
{% endhint %}

☑️ Une fois votre configuration prête, cliquez sur **Conteneuriser avec Docker**, attendez la fin du processus et vérifiez qu’aucune nouvelle erreur n’apparaît dans la sortie. Une fois cette étape terminée, une **nouvelle image apparaîtra sur votre machine locale**. Vous pouvez le vérifier dans Docker Desktop, sous l’onglet Images, dans la section Local (par défaut), ou dans l’interface CLI de 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).

☑️ Vous pouvez configurer les options suivantes (ou conserver les valeurs par défaut) :

* **Balise de l’image du serveur** de l’étape précédente.
  * La dernière balise créée avec le plug-in est sélectionnée par défaut.
  * :cloud: affiché devant le nom de votre image indique que celle-ci a été téléversée.
* **Paramètres facultatifs de docker run** peuvent être indiqués pour exposer plusieurs ports ou exécuter votre image sur des machines macOS.
  * Vous pouvez publier plusieurs ports pour votre conteneur si nécessaire ; il suffit d’ajouter le paramètre `-p {internal port}/{protocol}` pour chacun, par exemple `-p 8080/tcp -p 7777/udp` pour publier et associer le port de votre serveur `8080` à un port externe aléatoire pour les connexions TCP, et le port du serveur `7777` à un port externe aléatoire pour les connexions UDP, simultanément. **Recherchez la configuration du port du serveur dans votre script d’amorçage.**
  * Si vous utilisez une machine dotée d’une architecture ARM (macOS M1, M2, M3, etc.), le paramètre facultatif suivant devrait figurer dans les paramètres facultatifs de docker build : `--platform=linux/amd64` .

☑️ Une fois votre configuration prête, cliquez sur **Déployer le conteneur local**, attendez la fin du processus et vérifiez qu’aucune nouvelle erreur n’apparaît dans la sortie. Une fois cette étape terminée, un **nouveau conteneur sera 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 le client de jeu de l’éditeur Godot à votre conteneur Docker local** pour vérifier que votre image serveur fonctionne correctement. Trouvez les informations de connexion de votre client et saisissez :

* `localhost` ou `0.0.0.0` (équivalent dans la plupart des cas) à la place de l’adresse IP du serveur,
* la valeur du port externe aléatoire indiquée dans Docker Desktop / Containers.

<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).

☑️ Vous pouvez configurer les options suivantes (ou conserver les valeurs par défaut) :

* **Le nom de l’application** sur Edgegap peut correspondre au nom de votre image ou être personnalisé.
  * Pour l’instant, nous avons choisi de reprendre le nom de votre image.
* **La version de l’application** sur Edgegap peut correspondre à votre tag ou être personnalisée.
  * Les horodatages sont un excellent choix pour nommer les versions d’application, par exemple `2024.01.30-16.50.20-UTC` .
  * Plusieurs versions d’application peuvent pointer vers le même tag d’image, comme `v1.1.0` et `dev` .
  * Pour en savoir plus sur [Applications et versions](https://docs.edgegap.com/fr/learn/orchestration/application-and-versions.md) plus loin.
* **Image serveur** de l’étape [#id-3.-containerize-server](#id-3.-containerize-server "mention").

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

☑️ Une fois votre configuration prête, cliquez sur **Téléverser l’image et créer une version de l’application**, attendez la fin du processus, puis vérifiez qu’aucune nouvelle erreur n’apparaît dans votre sortie.

☑️ Vous serez redirigé vers notre [tableau de bord](https://app.edgegap.com/), où vous pourrez configurer des paramètres facultatifs. Cette étape entraînera la création d’une [nouvelle version de l’application](https://app.edgegap.com/application-management/applications/list), et votre [artefact de build sera étiqueté et téléversé dans le registre de conteneurs d’Edgegap](https://app.edgegap.com/registry-management/repositories/list).

* **La version de l’application** sur Edgegap peut correspondre à votre tag ou être personnalisée.
  * Les horodatages sont un excellent choix pour nommer les versions d’application, par exemple `2024.01.30-16.50.20-UTC` .
  * Plusieurs versions d’application peuvent pointer vers le même tag d’image, comme `v1.1.0` et `dev` .
  * Pour en savoir plus sur [Applications et versions](https://docs.edgegap.com/fr/learn/orchestration/application-and-versions.md) plus loin.

☑️ Vous serez maintenant invité à définir un port pour votre nouvelle version de l’application. Veillez à définir la même valeur de port serveur qu’à l’étape [#id-4.-test-server-locally](#id-4.-test-server-locally "mention") (la valeur par défaut est 7777).

✅ 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 le client de jeu de l’éditeur Godot à votre déploiement dans le cloud**. Récupérez l’ **hôte du déploiement** à la place de l’adresse IP du serveur, ainsi que le **port externe**du déploiement, renseignez ces valeurs dans les informations de connexion de votre client et jouez.

<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 les joueurs partis), vous pouvez arrêter votre déploiement pour réduire les coûts. [Laisser un déploiement inoccupé ou ne comportant que quelques joueurs peut entraîner des coûts inutiles !](https://edgegap.com/blog/how-session-fill-rate-affects-your-multiplayer-hosting-costs)

{% hint style="success" %}
Des exemples de scripts Godot arrivent bientôt !
{% 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

Consultez des informations utiles, comme l’ID du déploiement, l’adresse IP du serveur, son emplacement et bien 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 lorsque vous utilisez [Matchmaking](https://docs.edgegap.com/fr/learn/matchmaking.md),
* [Variables de version de l’application](https://docs.edgegap.com/fr/learn/orchestration/application-and-versions.md#injected-variables) - des paires clé-valeur personnalisables par vos soins.

{% hint style="success" %}
Des exemples de scripts Godot arrivent bientôt !
{% 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" %}
Des exemples de scripts Godot arrivent bientôt !
{% endhint %}

### Steam (serveur GodotSteam)

Publier votre jeu sur Steam avec [GodotSteam](https://godotsteam.com/) ? Votre serveur dédié peut utiliser [GodotSteam Server](https://codeberg.org/godotsteam/godotsteam-server) pour se connecter à Steam et vérifier que chaque joueur qui rejoint la partie est un véritable utilisateur Steam qui possède votre jeu.

Suivez [Héberger un serveur dédié GodotSteam Server sur Edgegap](https://docs.edgegap.com/fr/docs/sample-projects/godot/godotsteam-server.md) pour :

* exporter un serveur Linux sans interface avec l’extension GDExtension GodotSteam Server,
* connecter le serveur à Steam et valider les tickets d’authentification Steam des joueurs,
* ajouter le fichier `steamclient.so` de Steam à votre image Docker avec SteamCMD,
* le déployer sur Edgegap et connecter les clients Steam.

{% hint style="warning" %}
Le Dockerfile par défaut du plug-in Edgegap ne copie que le binaire de votre serveur et le fichier `.pck`. GodotSteam Server a également besoin de ses fichiers `.so` et de `steamclient.so` dans l’image : utilisez le Dockerfile du guide.
{% endhint %}

### Optimiser l’utilisation

Voici quelques conseils pour commencer à optimiser l’utilisation de votre serveur :

**Une fréquence de tick plus élevée signifie davantage de mises à jour, et donc une utilisation accrue du processeur et un volume de données sortantes plus important.**

* Godot utilise par défaut 60 ticks par seconde, ce qui convient parfaitement aux jeux de tir rapides ou aux jeux très sensibles à la latence. D’autres genres peuvent se contenter de 30 Hz, voire de 15 Hz.
* Le coût caché d’une fréquence de tick plus élevée réside dans le nombre accru de cycles processeur (par seconde) nécessaires pour empaqueter et dépaqueter les données, ainsi que pour recalculer les propriétés et procédures contrôlées par le serveur. Soyez prudent si votre jeu compte de nombreux joueurs par partie (10 ou plus), de nombreux nœuds avec des collisionneurs, des simulations physiques complexes ou beaucoup d’adversaires ou de coéquipiers contrôlés par l’ordinateur.
* Testez la réactivité du jeu avec différentes fréquences de tick dans les paramètres de votre code réseau. Pour ENET, consultez Project Settings / Physics / Common / Physics Ticks Per Second.

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

* ENET, intégré à Godot et utilisant par défaut le protocole UDP, constitue un excellent choix par défaut, offrant de bonnes performances et une grande compatibilité avec la plupart des appareils et des cas d’utilisation.
* Certains jeux peuvent vouloir tester TCP, WS, WebRTC ou d’autres protocoles. Cela peut améliorer la fiabilité de la connexion sur les appareils mobiles et les consoles, en particulier sur les réseaux publics (réseaux cellulaires, réseaux d’entreprise, cybercafés, Wi-Fi d’hôtel, etc.), mais nécessitera certainement des efforts de développement supplémentaires. Demandez-vous si cela est essentiel pour votre public cible.
* Utiliser plusieurs protocoles en parallèle pour garantir la transmission prioritaire des mises à jour importantes peut améliorer l’expérience des joueurs dans certains genres (par exemple, les MMO), mais cela demande beaucoup plus de travail de développement et peut considérablement complexifier votre projet.
* Choisissez soigneusement vos batailles : le développement de jeux ne manque pas de défis.

### Personnaliser l’image

Nous permettons également d’ajouter votre propre Dockerfile aux utilisateurs qui souhaitent mieux contrôler leurs images, par exemple pour optimiser la taille de la compilation, éliminer les dépendances superflues ou mettre en place un processus de démarrage plus complexe. Vous pouvez, si vous le souhaitez, indiquer le chemin d’accès à votre Dockerfile personnalisé à l’étape [#id-3.-containerize-server](#id-3.-containerize-server "mention"). Nous allons maintenant partager quelques conseils et bonnes pratiques pour vous débrouiller par vous-même.

**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.
