Godot - Premiers pas
Apprenez en faisant 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.
✔️ Préparation
Avant de commencer, assurez-vous de créer un compte gratuit avec Edgegap (aucune carte de crédit requise). Vous pouvez inviter les membres de votre équipe ensuite, même s’ils n’ont pas encore de compte Edgegap.
Configurez quelques éléments essentiels sur votre machine de développement :
⚙️ 1. Connecter le compte
☑️ Connectez-vous et vérifiez qu’il n’y a pas de nouvelles erreurs dans votre sortie liées au plugin d’Edgegap.
✅ Vous pouvez maintenant passer à l’étape suivante.
🔧 2. Compiler le serveur de jeu
Que vous utilisiez une machine Windows, Mac ou Linux, vous devrez compiler votre serveur pour l’exécution Linux, car la plupart des fournisseurs cloud aujourd’hui (y compris Edgegap) fonctionnent sous Linux. Ne vous inquiétez pas, aucune connaissance de Linux n’est requise pour y parvenir avec notre plugin.
☑️ Validez les modèles d’exportation pour vous assurer que le plugin a correctement configuré votre modèle de serveur Linux.
☑️ Ajoutez un nouveau script de démarrage à votre projet pour lancer automatiquement un serveur dédié. Créez un nouveau nœud sous votre scène principale et liez le nouveau script dans Inspecteur / Script / Charger.
Il s’agit d’un script modèle minimal pouvant être étendu pour répondre aux besoins de votre projet.
Il s’agit d’une version personnalisée du script de démarrage pour netfox forest brawl exemple.
Les builds serveur utilisent généralement le port 7777. Si vous personnalisez votre port, veuillez préciser le mêmee dans votre Applications et versions une fois que vous Godot.
☑️ Une fois que vous êtes satisfait de votre configuration, appuyez sur Compiler le serveur, attendez la fin du processus et vérifiez qu’il n’y a pas de nouvelles erreurs dans votre sortie. La réalisation de cette étape entraînera l’apparition d’un nouveau build 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é.
☑️ Commencez en cliquant sur le Valider Docker bouton pour vous assurer que vous avez terminé ✔️ Préparation.
☑️ Vous pouvez configurer les options suivantes (ou conserver les valeurs par défaut) :
Nom de l’image est un identifiant unique de votre choix, servant à étiqueter votre build serveur avant son envoi.
Généralement, cela inclura le nom de votre jeu — par exemple « my-game-server ».
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 le marquage, par exemple
2026.07.30-16.25.00-UTC.
Chemin vers le Dockerfile peut être utilisé pour personnaliser la recette de vos images.
Nous recommandons de conserver le réglage par défaut pour l’instant, vous pourrez en savoir plus plus tard dans la section Godot.
Paramètres de construction Docker facultatifs peuvent être utilisés pour donner à Docker des instructions plus précises sur certains détails.
Nous recommandons de conserver le réglage par défaut pour l’instant, vous pouvez en savoir plus plus tard dans la documentation Docker.
☑️ Une fois que vous êtes satisfait de votre configuration, appuyez sur Conteneuriser avec Docker, attendez la fin du processus et vérifiez qu’il n’y a pas de nouvelles erreurs dans votre sortie. La réalisation de cette étape entraînera nouvelle image apparaissant 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 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) :
Tag de l’image du serveur de l’étape précédente.
Par défaut, il s’agit du dernier tag que vous avez généré avec le plugin.
☁️ apparaissant devant le nom de votre image indique que cette image a été téléversée.
Paramètres facultatifs de docker run peuvent être fournis pour exposer plusieurs ports ou exécuter votre image sur des machines macOS.
Vous pouvez publier plusieurs ports pour votre conteneur si nécessaire, ajoutez simplement le paramètre
-p {internal port}/{protocol}pour chacun, par exemple-p 8080/tcp -p 7777/udppour publier et mapper votre port serveur8080vers un port externe aléatoire pour la connexion TCP et le port serveur7777vers un port externe aléatoire pour la connexion UDP en même temps. Trouvez la configuration du port du serveur dans votre script de démarrage.Si vous utilisez une machine dotée d’une architecture ARM (macOS M1, M2, M3, etc.), vous devriez voir ce paramètre facultatif inclus dans vos Paramètres facultatifs de construction Docker :
--platform=linux/amd64.
☑️ Une fois que vous êtes satisfait de votre configuration, appuyez sur Déployer le conteneur local, attendez la fin du processus et vérifiez qu’il n’y a pas de nouvelles erreurs dans votre sortie. La réalisation de cette étape entraînera le démarrage d’un nouveau conteneur sur votre machine de développement.
☑️ Il est maintenant temps de connecter votre client de jeu Godot Editor à votre conteneur Docker local pour vérifier que votre image serveur fonctionne correctement. Trouvez les détails de connexion de votre client et saisissez :
localhostou0.0.0.0(équivalent dans la plupart des cas) à la place de l’IP du serveur,la valeur de port externe randomisée trouvée dans Docker Desktop / Containers.
☑️ 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 sur 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 (stockage pour les images).
☑️ Vous pouvez configurer les options suivantes (ou conserver les valeurs par défaut) :
Nom de l’application sur Edgegap peut correspondre au nom de votre image ou être personnalisé.
Nous avons choisi de reprendre le nom de votre image pour l’instant.
Version de l’application sur Edgegap peut correspondre à votre tag ou être personnalisée.
Les horodatages sont une excellente option pour les noms de version 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.0etdev.En savoir plus sur Applications et versions plus tard.
Image du serveur de l’étape Godot.
Trouvez n’importe quel nom et tag d’image stockés sur votre machine dans Docker Desktop / Images.
☑️ Une fois que vous êtes satisfait de votre configuration, appuyez sur Téléverser l’image et créer la version de l’application, attendez la fin du processus et vérifiez qu’il n’y a pas de nouvelles erreurs dans votre sortie.
☑️ Vous serez maintenant invité à définir un port pour votre nouvelle version d’application. Assurez-vous de définir la même valeur de port serveur que dans l’étape Tableau de bord, où vous pourrez configurer des paramètres facultatifs. La réalisation de cette étape entraînera la création d’une nouvelle version d’application, et votre artefact de build étant étiqueté et téléversé dans le registre de conteneurs d’Edgegap.
Version de l’application sur Edgegap peut correspondre à votre tag ou être personnalisée.
Les horodatages sont une excellente option pour les noms de version 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.0etdev.En savoir plus sur Applications et versions plus tard.
☑️ Vous serez maintenant invité à définir un port pour votre nouvelle version d’application. Assurez-vous de définir la même valeur de port serveur que dans l’étape Godot (par défaut 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 Déploiements. L'achèvement de cette étape entraînera le démarrage d'un nouveau déploiement 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 n'affichent aucune erreur et que vos Déploiements 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 Godot Editor à votre déploiement cloud. Récupérez votre hôte du déploiement à la place de l’IP du serveur et le déploiement’s port externe du déploiement, configurez-les dans les détails de connexion de votre client et jouez.
Désactiver le VPN lors des tests pour des conditions plus réalistes et recevoir un déploiement à faible latence.
☑️ 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.
Si vous ne parvenez pas à identifier le problème, nous traînons dans notre Discord Communautaire 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é.
Arrêter les déploiements
Une fois la partie terminée (ou les joueurs partis), votre déploiement peut être arrêté pour économiser des coûts. Le fait de fonctionner à vide ou seulement partiellement rempli peut augmenter inutilement vos coûts !
Des exemples de scripts Godot arrivent bientôt !
Connectez votre Stockage des points de terminaison pour enregistrer les journaux de déploiement, sinon ils seront supprimés !
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 - fournies automatiquement par Edgegap,
Variables de matchmaking - fournies automatiquement par Edgegap lors de l’utilisation de Appariement,
Variables de version d’application - paires clé-valeur personnalisées configurables par vous.
Des exemples de scripts Godot arrivent bientôt !
Automatisation des sessions
Lancer vos déploiements manuellement, en collant l’URL et les ports, ne suffira pas pour un jeu en direct.
Automatisez les flux de jeu populaires pour gérer les sessions et la mise à l’échelle à la demande avec l’une ou l’autre des options suivantes :
Manches plus courtes
Parties à la demande
Classement par niveau et/ou Règles personnalisées
Persistant ou en manches
Hubs régionaux sociaux
Affectation automatique et/ou Recherche personnalisée
Backend personnalisé :
Migrer des parties en cours
Des exemples de scripts Godot arrivent bientôt !
Optimiser l’utilisation
Quelques conseils pour commencer à optimiser l’utilisation de votre serveur :
Un taux de tick plus élevé signifie plus de mises à jour, ce qui nécessite davantage d’utilisation du CPU et de trafic sortant de données.
Godot utilise par défaut 60 ticks par seconde, ce qui fonctionne très bien pour les shooters rapides ou les jeux très sensibles à la latence. D’autres genres peuvent se contenter de 30 Hz, voire 15 Hz.
Le coût caché d’un taux de tick plus élevé réside dans un plus grand nombre de cycles CPU (par seconde) pour (dé)compresser les données, et recalculer les propriétés et procédures faisant autorité côté serveur. Avancez avec prudence si votre jeu comporte de nombreux joueurs par partie (10+), de nombreux nœuds avec collisions, des simulations physiques complexes ou de nombreux adversaires/alliés contrôlés par des bots.
Testez la réactivité du jeu avec différents taux de tick dans vos paramètres de netcode. Pour ENET, consultez Paramètres du projet / Physique / Commun / Ticks de physique par seconde.
Comment choisir le bon protocole réseau ? Faites-le fonctionner d’abord, puis améliorez-le.
Le protocole ENET intégré à Godot avec UDP par défaut est un excellent choix par défaut, offrant de bonnes performances et une compatibilité sur la plus large gamme d’appareils et de cas d’utilisation.
Certains jeux peuvent vouloir expérimenter avec TCP, WS, WebRTC ou d’autres protocoles. Cela peut améliorer la fiabilité de votre connexion avec les appareils mobiles et les consoles, en particulier sur les réseaux publics (cellulaire, entreprise, cybercafé, Wi-Fi d’hôtel, etc.), mais cela exigera certainement des efforts de développement supplémentaires. Demandez-vous si c’est crucial pour votre public cible.
L’utilisation de plusieurs protocoles côte à côte pour garantir que les mises à jour importantes soient livrées en priorité peut améliorer l’expérience des joueurs pour certains genres (par ex. MMO), mais cela demande beaucoup d’efforts de développement supplémentaires et peut ajouter une complexité énorme à votre projet.
Choisissez vos combats avec soin, le développement de jeux ne manque pas de défis.
Personnaliser l’image
Nous prenons également en charge l’ajout de votre propre Dockerfile pour les utilisateurs qui ont besoin de plus de contrôle sur leurs images en raison de l’optimisation de la taille du build, de dépendances superflues ou d’un processus de démarrage plus complexe. Vous pouvez éventuellement fournir un chemin vers votre Dockerfile personnalisé à l’étape Godot. Nous allons maintenant partager quelques conseils « faites-le vous-même » et bonnes pratiques.
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 :
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.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.USER {user}doit suivre un commande useradd (Ubuntu) ou équivalent ; il vaut mieux ne pas tout exécuter en tant querootpour plus de sécurité. Référence Dockerfile ici.CMD {command}sera la dernière ligne, appelant très probablement unStartServer.shou 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.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,EXPOSE 7777/UDPn’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 êtrepublié lors des tests en local avec
docker run <image> -p 7777/udp,ou mappé dans le mappage de ports Edgegap.
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.
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 :
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,
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
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 pour héberger des bases de données et des services de longue durée.
Mis à jour
Ce contenu vous a-t-il été utile ?