Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Tutoriel : intégration rapide avec le GameLift Serveurs Amazon emballage

Bienvenue dans le didacticiel d'intégration pourAmazon GameLift Servers. Dans ce didacticiel, vous déployez rapidement votre serveur de jeu pour qu'il soit hébergé sur une flotte de ressources informatiques basées sur le cloud. Utilisez ce didacticiel pour éviter d'intégrer le SDK du serveur Amazon GameLift Servers dans le code de votre jeu, et déployez plutôt votre jeu avec les fonctionnalités minimales nécessaires pour communiquer avec le Amazon GameLift Servers service et exécuter des sessions de jeu. Vous allez configurer une solution d'hébergement de base et l'utiliser pour profiter de la gamme complète de fonctionnalités telles que la mise à l'échelle automatique et le matchmaking. C'est également un excellent moyen d'héberger un prototype de votre jeu dans le cadre d'une démo en direct ou à des fins de test.

Principaux avantages de cette méthode d'intégration :

Conditions préalables

Avant de commencer, assurez-vous de disposer des éléments suivants :

Vue d’ensemble

Dans ce didacticiel, vous allez :

Étape 1 : Obtenez et créez le wrapper du serveur de jeu

Utilisez les commandes suivantes pour obtenir la source du wrapper du serveur de jeu et créer le wrapper. Ces commandes utilisent SSH, mais vous pouvez également accéder directement au GitHub référentiel.

Windows

> git clone git@github.com:amazon-gamelift/amazon-gamelift-servers-game-server-wrapper.git
> cd amazon-gamelift-servers-game-server-wrapper
> powershell -file .\build.ps1
            

Mac et Linux

$ git clone git@github.com:amazon-gamelift/amazon-gamelift-servers-game-server-wrapper.git
$ cd amazon-gamelift-servers-game-server-wrapper
$ make
            

Lors d'une compilation réussie, un répertoire « out » est ajouté àamazon-gamelift-servers-game-server-wrapper. Ce répertoire contient trois dossiers, un pour chaque option de parc d'hébergement prise en charge, qui contiennent un ensemble d'artefacts de construction. Pour ce didacticiel, vous déployez sur des flottes EC2 gérées. Vous allez donc utiliser le dossier. gamelift-servers-managed-ec2

Étape 2 : Préparez la compilation de votre serveur de jeu

Au cours de cette étape, vous préparez les fichiers de construction de votre serveur de jeu pour les Amazon GameLift Servers télécharger sur.

Créez le répertoire du jeu

Maintenant, préparez un répertoire de jeu sur votre machine locale. Ce répertoire doit contenir tous les fichiers dont vous avez besoin pour exécuter votre serveur de jeuAmazon GameLift Servers. Cela inclut le wrapper du serveur de jeu, la version de votre serveur de jeu et le fichier config.yaml qui permet au wrapper de fonctionner avec votre serveur de jeu.

Procédez comme suit :

Voici un exemple de structure de répertoire :

gamelift-servers-managed-ec2
│-- config.yaml
│-- amazon-gamelift-servers-game-server-wrapper
│-- MyGame
│   │-- server-executable.exe
│   │-- my-game-settings
│   │ ......
            

Étape 3 : Configuration de l'emballage pour votre flotte

Amazon GameLift Serversgère le cycle de vie des instances de calcul d'une flotte, en créant de nouvelles instances avec la version de votre serveur installée et en recyclant les instances selon les besoins. Le service gère le cycle de vie des processus du serveur de jeu qui s'exécute sur chaque instance. Une flotte EC2 gérée peut avoir des instances à plusieurs endroits pour aider les joueurs où qu'ils se trouvent.

Modifiez le fichier config.yaml pour configurer le wrapper pour la journalisation, la configuration des ports et l'initialisation du serveur.

Exemple de configuration :

log-config:
  wrapper-log-level: debug
game-server-logs-dir: ./game-server-logs
ports:
  gamePort: 37016
game-server-details:
  executable-file-path: ./MyGame/my-server-executable
game-server-args:
  - arg: "--port"
    val: "{{.gameport}}"
    pos: 0
        

Étape 4 : Téléchargez la version du serveur de jeu

Vous avez maintenant terminé tous les éléments requis pour la construction de votre serveur de jeu (wrapper du serveur de jeu, config.yaml et fichiers de votre serveur de jeu), et vous êtes prêt à télécharger votre version de jeu sur for hosting. Amazon GameLift Servers Le moyen le plus rapide de télécharger la version de votre jeu est d'utiliser la AWS CLI commande upload-build comme indiqué dans l'exemple suivant.

Téléchargement d'une version de jeu avec Windows :

aws gamelift upload-build \
    --name gamelift-test-2025-03-11-1 \
    --build-version gamelift-test-2025-03-11-1 \
    --build-root out/windows/amd64/gamelift-servers-managed-ec2 \
    --operating-system WINDOWS_2022 \
    --server-sdk-version 5.3.0 \
    --region us-west-2
        

Lorsque vous créez le build, enregistrez l'ID du build à partir de la réponse de l'API pour l'utiliser pour la création de la flotte.

Étape 5 : Création de la flotte EC2 gérée

Les étapes suivantes décrivent une configuration de flotte minimale, afin que vous puissiez être opérationnel dès que possible.

Pour créer votre flotte :

Étape 6 : Création et connexion à une session de jeu

Lorsque le statut de votre flotte indique Active, cela signifie que les serveurs de jeu sont prêts et attendent d'accueillir une session de jeu. Pour démarrer une session de jeu, envoyez une demande de session de jeu au Amazon GameLift Servers service. Ici, vous allez utiliser le AWS CLI pour faire cette demande.

Pour créer une session de jeu, procédez comme suit :

aws gamelift create-game-session \
--fleet-id <FLEET_ID> \
--game-properties '[{"Key": "exampleProperty", "Value": "exampleValue"}]' \
--maximum-player-session-count 3 \
--region us-west-2
        

Vous pouvez également transmettre des propriétés de jeu personnalisées à l'exécutable de votre serveur. Consultez les arguments du serveur de jeu dans le README pour plus de détails. Lorsqu'il reçoit l'appel create-game-session, il demande au wrapper Amazon GameLift Servers de lancer l'exécutable du serveur de jeu et de démarrer une session de jeu. Ce qui se passe config.yaml affecte la configuration du serveur de jeu et les paramètres de lancement définis dans la console déterminent la configuration de la session de jeu elle-même.

Exemple de format pour ajouter des propriétés de jeu :

defaultArgs:
        - arg: "--port"
          val: "{{.GamePort}}"
          pos: 0
        - arg: "--ipAddress"
          val: "{{.IpAddress}}"
          pos: 1
        - arg: "--gameSessionId"
          val: "{{.GameSessionId}}"
          pos: 2
        

Étape 7 : Gérez et surveillez votre flotte

Maintenant que votre parc de serveurs de jeu est configuré et qu'une session de jeu a commencé, vous pouvez la gérer et la surveiller depuis la Amazon GameLift Servers console. La meilleure façon d'y parvenir est d'utiliser la page des détails de la flotte, où vous pouvez modifier les détails de la flotte ou modifier l'échelle et la capacité de la flotte dans l'onglet Scaling. Consultez la section suivante concernant la mise à l'échelle de vos serveurs de jeu.

Cliquez sur l'onglet Métriques pour afficher des graphiques illustrant la surveillance des mesures relatives à l'activité et au matériel. Pour plus de détails sur les graphiques de mesures, cliquez sur le lien Info à côté de l'identifiant de votre flotte. En outre, bien que vous puissiez surveiller de près vos serveurs de jeu depuis l'onglet Métriques, vous pouvez également ajouter des alarmes à ces statistiques dans le CloudWatch tableau de bord.

Pour accéder au CloudWatch tableau de bord depuis la console :

Étape 8 : faites évoluer vos serveurs de jeu

Pour l'étape suivante, vous devez configurer la mise à l'échelle automatique. Grâce à la mise à l'échelle automatique, vous pouvez adapter dynamiquement la capacité de votre flotte en fonction de l'activité du serveur de jeu. Au fur et à mesure que les joueurs arrivent et commencent des sessions de jeu, la mise à l'échelle automatique ajoute d'autres instances, et à mesure que la demande des joueurs diminue, la mise à l'échelle automatique libère les instances inutilisées. Il s'agit d'un moyen efficace de minimiser vos ressources et vos coûts d'hébergement tout en offrant une expérience de jeu fluide et rapide.

Lorsque vous vous préparez au lancement du jeu, vous souhaiterez configurer la mise à l'échelle automatique pour vos flottes. La mise à l'échelle automatique est recommandée comme moyen efficace de minimiser vos ressources et vos coûts d'hébergement tout en offrant une expérience de jeu fluide et rapide.

Pour configurer manuellement la capacité de la flotte

Pour configurer manuellement la capacité de la flotte

Pour utiliser la mise à l'échelle automatique basée sur des cibles

Pour utiliser la mise à l'échelle automatique basée sur des cibles

Target-based la mise à l'échelle automatique (suivi des cibles) associe la mise à l'échelle de la flotte au pourcentage de sessions de jeu disponibles. Au fur et à mesure que les joueurs commencent à jouer à votre jeu et que le nombre de sessions de jeu disponibles diminue, le jeu répond en ajoutant automatiquement d'autres instances à la flotte.

Rule-based la mise à l'échelle automatique vous offre un contrôle plus précis, comme la possibilité de lier la mise à l'échelle à d'autres mesures de la flotte et de définir des seuils personnalisés et des réponses de dimensionnement. Il propose des options puissantes, mais nécessite également l'utilisation de l'interface de ligne de commande et des tests approfondis pour comprendre le comportement des règles personnalisées en action. Ce didacticiel se concentre d'abord sur la mise en place de l'approche basée sur les cibles.

Résoudre les problèmes courants

Les problèmes courants que vous pouvez rencontrer lors du fonctionnement de vos serveurs de jeu et de vos sessions de jeu sont les suivants. Lorsque le serveur ou la session de jeu ne fonctionnent pas correctement, la première étape consiste à vérifier les journaux qui peuvent révéler l'un des problèmes décrits ci-dessous pour les nouveaux déploiements ou les jeux en production.

Les informations suivantes sont souvent révélées dans les journaux :

Pour consulter les journaux des événements de votre GameLift Serveurs Amazon flotte

Pour consulter les journaux des événements de votre Amazon GameLift Servers flotte

Pour consulter les journaux des sessions de jeu

Pour consulter les journaux des sessions de jeu

Pour consulter les journaux de session de jeu à l'aide de la CLI, utilisez l'GetGameSessionLogURLAPI. Amazon GameLift Serversstocke automatiquement les journaux pendant 14 jours.

Vous pouvez également configurer les CloudWatch journaux Amazon pour votre flotte. Cela fournit des fonctionnalités de journalisation supplémentaires et une intégration avec d'autres services AWS de surveillance.

Pour un accès aux journaux en temps réel ou des périodes de conservation prolongées via CloudWatch :

Étapes suivantes