Collaborez avec l'Amazon GameLift Serversagent - Amazon GameLift Servers
À propos de l'agent

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.

Collaborez avec l'Amazon GameLift Serversagent

L'Amazon GameLift Serversagent supervise le fonctionnement des processus du serveur de jeu sur vos Amazon GameLift Servers flottes. L'agent est déployé sur chaque ordinateur d'un parc et assure la gestion automatisée des processus, la gestion de l'hébergement et la journalisation du calcul. Pour utiliser l'agent, la version de votre serveur de jeu doit être intégrée au SDK du serveur pour la Amazon GameLift Servers version 5.x ou ultérieure.

L'Amazon GameLift Serversagent est disponible en externe pour être utilisé avec des Amazon GameLift Servers flottes qui ne sont pas des EC2 flottes gérées. ( EC2 Les flottes gérées gèrent automatiquement les tâches de l'agent.) Vous pouvez choisir de gérer Amazon GameLift Servers des flottes, y compris des flottes Anywhere, avec ou sans l'agent. Sans l'agent, vous devez proposer une solution alternative pour effectuer les tâches requises.

Lorsqu'il est déployé sur un ordinateur, l'Amazon GameLift Serversagent doit être lancé avant le démarrage des processus du serveur de jeu. Au lancement, l'agent exécute les tâches suivantes :

  • Enregistre le calcul auprès d'une flotte Amazon GameLift Servers Anywhere à l'aide de l'RegisterComputeAPI.

  • Appelle l'GetComputeAuthTokenAPI pour récupérer un jeton d'autorisation et le stocke pour qu'il soit utilisé par les processus du serveur qui s'exécutent sur le calcul.

  • Définit la variable d'environnement WebSocket URL pour le calcul et établit une WebSocket connexion au Amazon GameLift Servers service.

  • Demande au Amazon GameLift Servers service la dernière version de la configuration d'exécution de la flotte.

  • Démarre et arrête les processus du serveur conformément aux instructions de configuration d'exécution.

Le code source et les instructions de compilation de l'Amazon GameLift Serversagent sont disponibles dans l'Amazon GameLift Serversagent GitHub.

À propos de l'agent

L'Amazon GameLift Serversagent est conçu pour effectuer les tâches suivantes pour vos flottes :

Gestion des processus

  • Démarre de nouveaux processus serveur tels que définis dans les instructions d'exécution. L'agent peut utiliser une configuration d'exécution personnalisée déployée avec l'agent. Vous pouvez également fournir un dans RuntimeConfiguration le cadre de la définition de votre flotte. Cette approche présente l'avantage de pouvoir modifier la configuration d'exécution de la flotte à tout moment. L'agent demande régulièrement au Amazon GameLift Servers service des configurations d'exécution mises à jour.

  • Surveille les activations des processus du serveur et met fin aux processus lorsqu'ils ne s'activent pas à temps.

  • Envoie des battements de cœur à. Amazon GameLift Servers Si l'agent ne parvient pas à envoyer les pulsations cardiaques, le calcul peut être marqué comme obsolète.

  • Signale Amazon GameLift Servers la fin d'un processus serveur. Amazon GameLift Serversutilise ces informations pour surveiller la disponibilité du serveur de jeu pour le placement des sessions de jeu.

  • Émet des événements de flotte pour les processus du serveur, notamment :

    • SERVER_PROCESS_INVALID_PATH: Les paramètres de lancement du processus du serveur de jeu n'étaient pas correctement configurés.

    • SERVER_PROCESS_TERMINATED_UNHEALTHY: Le processus du serveur de jeu n'a pas signalé de bilan de santé valide dans les 3 minutes suivant l'activation et a donc été interrompu.

    • SERVER_PROCESS_FORCE_TERMINATED: Le processus du serveur de jeu ne s'est pas correctement arrêté après avoir OnProcessTerminate() été envoyé dans les 30 secondes.

    • SERVER_PROCESS_CRASHED: Le processus d'un serveur de jeu s'est bloqué pour une raison ou une autre.

Gestion du calcul

  • Reçoit des messages du Amazon GameLift Servers service pour arrêter le calcul.

  • Demande de terminer le calcul parAmazon GameLift Servers.

Journalisation

  • Télécharge les journaux dans un compartiment Amazon S3 de votre AWS compte.