Collaborez avec l' GameLift agent Amazon - Amazon GameLift

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' GameLift agent Amazon

L' GameLift agent Amazon supervise le fonctionnement des processus du serveur de jeu sur vos GameLift flottes Amazon. 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 à Amazon GameLift Server SDK 5.x ou version ultérieure.

L' GameLift agent Amazon est disponible en externe pour être utilisé avec les GameLift flottes Amazon qui ne sont pas des EC2 flottes gérées. (EC2Les flottes gérées gèrent automatiquement les tâches de l'agent.) Vous pouvez choisir de gérer les GameLift flottes Amazon, y compris les 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' GameLift agent Amazon 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'un Amazon GameLift Anywhere flotte utilisant le RegisterComputeAPI.

  • Appelle le GetComputeAuthTokenAPIpour 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' WebSocket URLenvironnement pour le calcul et établit une WebSocket connexion au GameLift service Amazon.

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

  • 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' GameLift agent Amazon sont disponibles dans l' GameLift agent Amazon GitHub.

À propos de l'agent

L' GameLift agent Amazon 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 des configurations d'exécution mises à jour au GameLift service Amazon.

  • 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. Si l'agent ne parvient pas à envoyer les pulsations cardiaques, le calcul peut être marqué comme obsolète.

  • Signale à Amazon GameLift la fin d'un processus serveur. Amazon GameLift utilise ces informations pour surveiller la disponibilité des serveurs de jeu en vue du 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 GameLift service Amazon pour arrêter le calcul.

  • Demande à Amazon GameLift de mettre fin au calcul.

Journalisation

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