Créez un Amazon GameLift Anywhere flotte - 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.

Créez un Amazon GameLift Anywhere flotte

Cette rubrique explique comment créer un Amazon GameLift Anywhere flotte. Avec une flotte Anywhere, vous pouvez utiliser les principales fonctionnalités de gestion des sessions de GameLift jeu d'Amazon tout en hébergeant des sessions de jeu avec vos propres ressources informatiques. Créez une flotte Anywhere pour votre matériel sur site ou d'autres ressources basées sur le cloud.

Les flottes Anywhere sont couramment utilisées aux côtés des flottes GameLift gérées par Amazon dans une solution d'hébergement hybride. Ils fournissent également des environnements de test utiles lors du développement d'un jeu à héberger sur Amazon GameLift. Consultez ces rubriques pour en savoir plus sur quand et comment intégrer Amazon GameLift Anywhere des flottes dans une solution d'hébergement de jeux :

Les flottes Anywhere étant autogérées, leur mise en place nécessite un travail supplémentaire. Pour préparer une flotte Anywhere à accueillir des sessions de jeu et des joueurs, vous devez effectuer les tâches suivantes :

Avant de commencer

Avant de créer une flotte Anywhere, effectuez les tâches suivantes. Pour des conseils plus détaillés, consultez le Feuille de route de développement pour l'hébergement avec Amazon GameLift Anywhere ouFeuille de route de développement pour l'hébergement hybride avec Amazon GameLift.

  • Intégrez le code de votre serveur de jeu à la SDK version 5.x (ou supérieure) GameLift du serveur Amazon. Vous n'avez pas besoin d'effectuer toutes les tâches d'intégration au jeu, uniquement celles requises pour la création d'un serveur de jeu. Une pratique courante consiste à configurer votre machine locale en tant que flotte Anywhere et à utiliser une interface de ligne de commande pour tester l'intégration de votre serveur de jeu (voirConfigurez des tests locaux avec Amazon GameLift Anywhere). Vous pouvez intégrer des composants supplémentaires (tels qu'un client de jeu GameLift compatible avec Amazon) au fur et à mesure que vous les développez.

  • Package du logiciel de votre serveur de jeu pour l'installer sur les ordinateurs de votre flotte Anywhere. Le package doit inclure la version de votre serveur de jeu intégré et tous les logiciels de support nécessaires au fonctionnement de votre serveur de jeu.

  • Décidez si vous souhaitez utiliser l' GameLift agent Amazon avec votre flotte Anywhere. L'agent est un outil de gestion des processus sur ordinateur qui automatise certaines des tâches clés liées à la gestion des processus du serveur et des calculs à utiliser avec Amazon. GameLift Pour de plus amples informations, veuillez consulter Collaborez avec l' GameLift agent Amazon.

Créez un emplacement personnalisé

Créez un emplacement personnalisé pour représenter l'emplacement physique de vos ressources informatiques. Lorsque vous créez une flotte Anywhere, au moins un emplacement personnalisé doit déjà être défini. Vous pouvez créer des emplacements personnalisés supplémentaires et les ajouter à un parc existant à tout moment.

Pour créer un emplacement personnalisé

Utilisez la GameLift console Amazon ou le AWS Command Line Interface (AWS CLI) pour créer un emplacement personnalisé.

Console

Dans la GameLift console Amazon, utilisez le volet de navigation pour ouvrir la page Locations. Choisissez Créer un emplacement pour ouvrir la boîte de dialogue Créer.

  1. Dans la boîte de dialogue, entrez le nom de l'emplacement. Il est recommandé d'utiliser un nom qui décrit un emplacement significatif pour un ensemble de ressources de calcul. Il peut s'agir d'emplacements géographiques, d'un nom de centre de données ou d'un autre identifiant de localisation. Amazon GameLift ajoute le nom de votre emplacement personnalisé avec custom-.

  2. (Facultatif) Ajoutez des balises à votre emplacement personnalisé. Chaque balise est constituée d’une clé et d’une valeur facultative que vous définissez. Attribuez des balises aux AWS ressources que vous souhaitez classer de manière utile, par exemple par objectif, propriétaire ou environnement. Choisissez Ajouter un nouveau tag pour chaque tag que vous souhaitez ajouter.

  3. Sélectionnez Create (Créer).

AWS CLI

Créez un emplacement personnalisé à l'aide de la create-locationcommande. Entrez une location-name valeur, qui doit commencer parcustom-. Il est recommandé d'utiliser un nom qui décrit un emplacement significatif pour un ensemble de ressources de calcul. Il peut s'agir d'emplacements géographiques, d'un nom de centre de données ou d'un autre identifiant de localisation.

aws gamelift create-location \ --location-name custom-location-1

Sortie

{ "Location": { "LocationName": "custom-location-1", "LocationArn": "arn:aws:gamelift:us-east-1:111122223333:location/custom-location-1" } }

Créez une flotte Anywhere

Créez une flotte Anywhere pour un ensemble de ressources informatiques dont vous êtes propriétaire. Une nouvelle flotte Anywhere commence à être vide ; vous ajoutez des ordinateurs à la flotte en les enregistrant.

À propos de la création, un nouveau Anywhere la flotte passe rapidement de l'état de la flotte NEW àACTIVE. Vous pouvez ajouter des calculs à la flotte une fois celle-ci atteinte. ACTIVE

Pour créer une flotte Anywhere

Utilisez la GameLift console Amazon ou le AWS Command Line Interface (AWS CLI) pour créer une flotte Anywhere.

Console

Dans la GameLift console Amazon, utilisez le volet de navigation pour ouvrir la page Fleets. Choisissez Créer une flotte pour démarrer le flux de travail de création de flotte.

Étape 1 Choisissez le type de calcul

Sélectionnez l'option N'importe où, puis Next.

Étape 2 Définir les détails de la flotte

Au cours de cette étape, spécifiez certains paramètres clés pour l'ensemble de la flotte.

  1. Remplissez la section Détails de la flotte :

    1. Entrez un nom de flotte. Nous vous recommandons d'utiliser un modèle de dénomination des flottes qui facilite l'identification des types de flottes lors de la consultation des listes de flottes.

    2. Fournissez une brève description de la flotte.

  2. Définissez ces informations supplémentaires facultatives selon vos besoins. Vous pourrez mettre à jour ces paramètres de flotte ultérieurement.

    1. Lorsque vous créez une flotte à des fins de production ou de pré-production, utilisez ce paramètre pour spécifier une valeur de coût horaire pour les calculs de la flotte. Amazon GameLift peut utiliser ces informations pendant le processus de placement des sessions de jeu pour sélectionner les ressources d'hébergement en fonction du coût.

    2. Si vous souhaitez combiner les données métriques de ce parc et d'autres, spécifiez un nom de groupe de métriques. Utilisez le même nom de groupe de mesures pour toutes les flottes que vous souhaitez combiner. Consultez les métriques du groupe de métriques pour voir les données agrégées.

  3. Ajoutez des balises facultatives à votre position personnalisée. Chaque balise est constituée d’une clé et d’une valeur facultative que vous définissez. Attribuez des balises aux AWS ressources que vous souhaitez classer de manière utile, par exemple par objectif, propriétaire ou environnement. Choisissez Ajouter un nouveau tag pour chaque tag que vous souhaitez ajouter.

  4. Choisissez Next pour continuer le flux de travail.

Étape 3 Sélectionnez des emplacements personnalisés

Au cours de cette étape, identifiez l'emplacement physique des ordinateurs que vous prévoyez d'ajouter à cette flotte. Vous pouvez définir un ou plusieurs emplacements dès maintenant, et vous pouvez ajouter ou supprimer des emplacements ultérieurement selon vos besoins.

  1. Dans Emplacements personnalisés, sélectionnez un ou plusieurs emplacements pour les calculs de la flotte. La liste inclut tous les emplacements personnalisés qui ont été définis dans votre sélection actuelle Région AWS. Pour définir un nouvel emplacement personnalisé que vous souhaitez ajouter à la flotte, choisissez Créer un emplacement.

  2. Choisissez Next pour continuer le flux de travail.

Étape 4 Réviser et créer

Vérifiez vos paramètres avant de créer la flotte.

Lorsque vous êtes prêt à déployer la nouvelle flotte, choisissez Create. Amazon lance GameLift immédiatement le processus d'activation de la flotte, en attribuant un identifiant unique et en attribuant le NEW statut de la flotte. Vous pouvez suivre la progression de la flotte sur la page Flottes.

AWS CLI

Utilisez la create-fleetcommande pour créer un parc de types de calculANYWHERE. Entrez un nom et au moins un emplacement personnalisé. Amazon GameLift crée la ressource de flotte Anywhere dans votre ressource par défaut actuelle Région AWS (ou vous pouvez ajouter une balise --region pour en spécifier une autre Région AWS).

L'exemple de demande suivant crée une nouvelle flotte avec les paramètres minimaux requis. Remplacez FleetName et custom-location par vos propres informations.

aws gamelift create-fleet \ --name FleetName \ --compute-type ANYWHERE \ --locations "Location=custom-location"

Exemple de réponse

{ "FleetAttributes": { "FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "FleetArn": "arn:aws:gamelift:us-west-2:111122223333:fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "Name": "HardwareAnywhere", "CreationTime": "2023-02-23T17:57:42.293000+00:00", "Status": "ACTIVE", "MetricGroups": [ "default" ], "CertificateConfiguration": { "CertificateType": "DISABLED" }, "ComputeType": "ANYWHERE" } }

À propos de la création, un nouveau Anywhere la flotte passe rapidement au statut de flotteACTIVE. Vous pouvez ajouter des calculs à la flotte une fois celle-ci atteinte. ACTIVE

Notez que la réponse n'inclut pas les emplacements de la flotte. Vous pouvez obtenir les détails complets de la flotte en appelant describe-fleet-attributeset describe-fleet-location-attributes.

Ajouter un ordinateur à la flotte

Pour ajouter une ressource de calcul à une flotte et la préparer à héberger des sessions de jeu, effectuez les tâches suivantes :

  • Enregistrez le calcul auprès de la flotte. L'enregistrement indique à Amazon GameLift quelles ressources d'hébergement physiques font partie de la flotte.

  • Demandez un jeton d'authentification pour le calcul. Chaque serveur de jeu qui s'exécute sur l'ordinateur a besoin de ce jeton pour se connecter au GameLift service Amazon. Les jetons d'authentification sont temporaires et doivent être régulièrement actualisés.

Note

Si vous déployez le logiciel de votre serveur de jeu avec Amazon GameLift Agent, vous pouvez ignorer cette étape. L'agent enregistre automatiquement chaque calcul et conserve un jeton d'authentification valide pour le calcul. Consultez Collaborez avec l' GameLift agent Amazon.

Vous pouvez enregistrer un ordinateur et demander un jeton d'authentification en utilisant le AWS CLI ou en effectuant des appels programmatiques vers le AWS SDK pour Amazon GameLift. Ces actions ne sont pas disponibles via la GameLift console Amazon.

Il est recommandé d'automatiser ces deux tâches en ajoutant un script de démarrage à chaque calcul. Le script de démarrage appelle automatiquement les get-compute-auth-token commandes register-compute et. Vous pouvez également automatiser les tâches afin d'actualiser régulièrement le jeton d'authentification pendant toute la durée de vie du calcul et de désenregistrer le calcul à l'arrêt.

Chacune des actions de démarrage renvoie des valeurs spécifiques au calcul que vous devez stocker sur le calcul. Lorsqu'un processus de serveur de jeu démarre sur le calcul, il doit transmettre ces valeurs en tant que paramètres du serveur lors de l'initialisation d'une connexion avec le GameLift service Amazon (voir ServerParameters dans la SDK référence du serveur). Nous vous recommandons de définir ces valeurs spécifiques au calcul (ou leur emplacement de stockage) en tant que variables d'environnement. Si vous utilisez l' GameLift agent Amazon, cette tâche est gérée pour vous. Les valeurs spécifiques au calcul sont les suivantes :

  • register-computerenvoie une valeur pourGameLiftServiceSdkEndpoint. Définissez cette valeur sur le paramètre webSocketUrl du serveur.

  • compute-auth-tokenrenvoie le jeton d'authentification. Définissez cette valeur sur le paramètre authToken du serveur.

AWS CLI

Les instructions suivantes décrivent comment soumettre manuellement chaque demande à l'aide du AWS CLI.

Pour enregistrer un ordinateur

Appelez register-computepour enregistrer un ordinateur. Identifiez l'ID de la flotte à laquelle ajouter le calcul. Fournissez les informations de calcul suivantes : un nom, une adresse IP et un emplacement significatifs. L'emplacement du calcul doit être un emplacement personnalisé déjà associé à la flotte. Si vous souhaitez utiliser un autre emplacement personnalisé, utilisez la GameLift console Amazon pour mettre à jour le parc ou appelez la AWS CLI commande create-fleet-locationspour ajouter un emplacement personnalisé au parc.

Dans l'exemple suivant, remplacez les valeurs d'espace réservé pour votre calcul et votre flotte. La fleet-id valeur est renvoyée lorsque vous créez une flotte Anywhere. Vous pouvez obtenir les détails complets de la flotte en appelant describe-fleet-attributeset describe-fleet-location-attributes.

aws gamelift register-compute \ --compute-name HardwareAnywhere \ --fleet-id arn:aws:gamelift:us-east-1:111122223333:fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa \ --ip-address 10.1.2.3 \ --location custom-location-1

Exemple de sortie

{ "Compute": { "FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "FleetArn": "arn:aws:gamelift:us-west-2:111122223333:fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "ComputeName": "HardwareAnywhere", "ComputeArn": "arn:aws:gamelift:us-west-2:111122223333:compute/HardwareAnywhere", "IpAddress": "10.1.2.3", "ComputeStatus": "Active", "Location": "custom-location-1", "CreationTime": "2023-02-23T18:09:26.727000+00:00", "GameLiftServiceSdkEndpoint": "wss://us-west-2.api.amazongamelift.com" } }

Pour demander un jeton d'authentification

Appelez get-compute-auth-tokenpour demander un jeton d'authentification valide. Enregistrez un calcul. Identifiez l'ID du parc et le nom du calcul.

Dans l'exemple suivant, remplacez les valeurs d'espace réservé pour votre calcul et votre flotte. La fleet-id valeur est renvoyée lorsque vous créez une flotte Anywhere. Vous pouvez obtenir les détails complets de la flotte en appelant describe-fleet-attributes. Pour obtenir des informations de calcul, appelez list-computeavec l'identifiant de la flotte pour voir tous les calculs enregistrés dans la flotte.

aws gamelift get-compute-auth-token \ --fleet-id arn:aws:gamelift:us-east-1:111122223333:fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa \ --compute-name HardwareAnywhere

Exemple de sortie

{ "FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "FleetArn": "arn:aws:gamelift:us-east-1:111122223333:fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "ComputeName": "HardwareAnywhere", "ComputeArn": "arn:aws:gamelift:us-east-1:111122223333:compute/HardwareAnywhere", "AuthToken": "0c728041-3e84-4aaa-b927-a0fb202684c0", "ExpirationTimestamp": "2023-02-23T18:47:54+00:00" }

Démarrez un serveur de jeu

Après avoir créé une flotte Anywhere et ajouté un ou plusieurs ordinateurs à la flotte, vous êtes prêt à commencer à gérer vos serveurs de jeu.

Étape 1 Installez le logiciel de votre serveur de jeu

Créez votre serveur de jeu et installez tous les logiciels qui en dépendent sur chaque ordinateur de votre flotte Anywhere. La version du serveur de jeu doit être intégrée à la SDK version 5.x (ou supérieure) du GameLift serveur Amazon avec les fonctionnalités minimales requises pour communiquer avec le GameLift service Amazon.

Étape 2 Préparez vos ordinateurs pour exécuter un serveur de jeu

Assurez-vous que chaque ordinateur est enregistré et possède un jeton d'authentification valide. Si vous utilisez des scripts pour gérer ces tâches, assurez-vous qu'ils s'exécutent sur chaque ordinateur avant de démarrer tout processus du serveur de jeu.

Si vous avez déployé l' GameLift agent Amazon avec le logiciel de votre serveur de jeu, assurez-vous que le fichier exécutable de l'agent est lancé.

Étape 3 Lancer un processus de serveur de jeu

Exécutez une instance de l'exécutable de votre serveur de jeu sur un ordinateur. Si la version de votre serveur de jeu est correctement intégrée, le processus du serveur de jeu appelle le serveur à SDK agir InitSDK() avec un ensemble de paramètres de serveur valides. Lorsque le processus serveur est prêt à héberger une session de jeu, il appelleProcessReady().

Note

Si vous avez déployé le logiciel de votre serveur de jeu avec Amazon GameLift Agent, vous pouvez ignorer cette étape. L'agent lance automatiquement les processus du serveur de jeu en fonction des instructions d'exécution que vous fournissez.

Vous pouvez suivre la progression en consultant les métriques des processus du serveur pour l'activation et les processus actifs du serveur. Consultez GameLiftMétriques Amazon pour les flottes. Si le processus de votre serveur de jeu ne parvient pas à s'initialiser, vérifiez qu'il récupère les bonnes valeurs de paramètres du serveur pour le calcul sur lequel il s'exécute.