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 GameLift Serveurs Amazon Flotte Anywhere
Cette rubrique explique comment créer une flotte Amazon GameLift Servers Anywhere. Avec une flotte Anywhere, vous pouvez utiliser les fonctionnalités de base de gestion des sessions de Amazon GameLift Servers jeu 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 Amazon GameLift Servers gérées dans une solution d'hébergement hybride. Ils fournissent également des environnements de test utiles lors du développement d'un jeu à hébergerAmazon GameLift Servers. Consultez les rubriques suivantes pour savoir quand et comment intégrer les flottes Amazon GameLift Servers Anywhere dans une solution d'hébergement de jeux :
Les flottes Anywhere étant autogérées, la mise en place d'une flotte 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 obtenir des conseils plus détaillés, consultez le Feuille de route de développement pour l'hébergement avec GameLift Serveurs Amazon N'importe où ouFeuille de route de développement pour l'hébergement hybride avec GameLift Serveurs Amazon.
-
Intégrez le code de votre serveur de jeu au SDK Amazon GameLift Servers du serveur version 5.x (ou supérieure). Vous n'avez pas besoin d'effectuer toutes les tâches d'intégration du jeu, mais uniquement celles nécessaires à 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 les tests locaux avec GameLift Serveurs Amazon N'importe où). Vous pouvez intégrer des composants supplémentaires (comme un client de jeu Amazon GameLift Servers activé) au fur et à mesure que vous les développez.
-
Packagez le logiciel de votre serveur de jeu pour l'installer sur votre parc informatique Anywhere. Le package doit inclure la version intégrée de votre serveur de jeu et tous les logiciels de support nécessaires au fonctionnement de votre serveur de jeu.
-
Décidez si vous souhaitez utiliser l'Amazon GameLift Serversagent avec votre parc 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 Servers Pour de plus amples informations, veuillez consulter Collaborez avec l'Amazon GameLift Serversagent.
Création d'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, vous devez avoir au moins un emplacement personnalisé déjà défini. Vous pouvez créer des emplacements personnalisés supplémentaires et les ajouter à une flotte existante à tout moment.
Pour créer un emplacement personnalisé
Utilisez la Amazon GameLift Servers console ou le AWS Command Line Interface (AWS CLI) pour créer un emplacement personnalisé.
- Console
-
Dans la Amazon GameLift Servers console, utilisez le volet de navigation pour ouvrir la page Emplacements. Choisissez Créer un emplacement pour ouvrir la boîte de dialogue Créer.
-
Dans la boîte de dialogue, entrez un nom de lieu. 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 Serversajoute le nom de votre emplacement personnalisé avec custom-.
-
(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 une nouvelle étiquette pour chaque étiquette que vous souhaitez ajouter.
-
Choisissez Créer.
- AWS CLI
-
Créez un emplacement personnalisé à l'aide de la create-location commande. Indiquez 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
Output
{
"Location": {
"LocationName": "custom-location-1",
"LocationArn": "arn:aws:gamelift:us-east-1:111122223333:location/custom-location-1"
}
}
Création d’une flotte Anywhere
Créez une flotte Anywhere pour un ensemble de ressources de calcul dont vous êtes propriétaire. Une nouvelle flotte Anywhere commence à être vide ; vous ajoutez des calculs à la flotte en les enregistrant.
Lors de sa création, une nouvelle flotte Anywhere 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 Amazon GameLift Servers console ou le AWS Command Line Interface (AWS CLI) pour créer une flotte Anywhere.
- Console
-
Dans la Amazon GameLift Servers console, utilisez le volet de navigation pour ouvrir la page Flottes. 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 choisissez Suivant.
- Étape 2 Définissez les détails de la flotte
-
Au cours de cette étape, définissez certains paramètres clés pour l'ensemble de la flotte.
-
Remplissez la section « Détails de la flotte » :
-
Entrez un nom de flotte. Nous vous recommandons d'utiliser un modèle de dénomination de flotte qui facilite l'identification des types de flottes lors de l'affichage des listes de flottes.
-
Fournissez une brève description de la flotte.
-
Définissez ces informations supplémentaires facultatives selon vos besoins. Vous pourrez mettre à jour ces paramètres de flotte ultérieurement.
-
Lorsque vous créez une flotte pour les tests de production ou de pré-production, utilisez ce paramètre pour spécifier une valeur de coût par heure pour les calculs de la flotte. Amazon GameLift Serverspeuvent utiliser ces informations pendant le processus de placement des sessions de jeu pour sélectionner les ressources d'hébergement en fonction des coûts.
-
Si vous souhaitez combiner des données métriques pour cette flotte et d'autres, spécifiez un nom de groupe de mesures. Utilisez le même nom de groupe de mesures pour toutes les flottes que vous souhaitez combiner. Consultez les mesures du groupe de mesures pour voir les données agrégées.
-
Ajoutez des balises facultatives à 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 une nouvelle étiquette pour chaque étiquette que vous souhaitez ajouter.
-
Cliquez sur Suivant pour poursuivre 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 à ce parc. Vous pouvez spécifier un ou plusieurs emplacements dès maintenant, et vous pouvez ajouter ou supprimer des emplacements ultérieurement selon vos besoins.
-
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 la liste que vous avez actuellement sélectionnée Région AWS. Pour définir un nouvel emplacement personnalisé que vous souhaitez ajouter à la flotte, choisissez Créer un emplacement.
-
Cliquez sur Suivant pour poursuivre 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 Créer. Amazon GameLift Serverslance immédiatement le processus d'activation de la flotte, en attribuant un identifiant unique et en plaçant la flotte en NEW statut. Vous pouvez suivre la progression de la flotte sur la page Flottes.
- AWS CLI
-
Utilisez la create-fleet commande pour créer une flotte de type de calculANYWHERE. Entrez un nom et au moins un emplacement personnalisé. Amazon GameLift Serverscrée la ressource de flotte Anywhere avec votre valeur 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"
}
}
Une fois créée, une nouvelle flotte Anywhere 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 l'emplacement de la flotte. Vous pouvez obtenir les détails complets de la flotte en appelant describe-fleet-attributes et describe-fleet-location-attributes.
Ajouter un calcul à la flotte
Pour ajouter une ressource informatique à 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 Servers 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 le calcul a besoin de ce jeton pour se connecter au Amazon GameLift Servers service. Les jetons d'authentification sont temporaires et doivent être régulièrement actualisés.
Si vous déployez le logiciel de votre serveur de jeu avec l'Amazon GameLift ServersAgent, 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'Amazon GameLift Serversagent.
Vous pouvez enregistrer un calcul et demander un jeton d'authentification à l'aide de la AWS CLI ou en effectuant des appels programmatiques au AWS SDK pour. Amazon GameLift Servers Ces actions ne sont pas disponibles via la Amazon GameLift Servers console.
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 pour actualiser régulièrement le jeton d'authentification pendant toute la durée de vie du calcul et annuler l'enregistrement du 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 est lancé sur le calcul, il doit transmettre ces valeurs en tant que paramètres du serveur lors de l'initialisation d'une connexion avec le Amazon GameLift Servers service (voir ServerParameters dans la référence du SDK du serveur). Nous vous recommandons de définir ces valeurs spécifiques au calcul (ou leurs emplacements stockés) en tant que variables d'environnement. Si vous utilisez l'Amazon GameLift ServersAgent, 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 de l' AWS interface de ligne de commande.
Pour enregistrer un ordinateur
Appelez register-compute pour 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 Amazon GameLift Servers console pour mettre à jour le parc ou appelez la commande AWS CLI create-fleet-locations pour ajouter un emplacement personnalisé au parc.
Dans l'exemple suivant, remplacez les valeurs d'espace réservé pour votre calcul et votre parc. 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 et 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-token pour demander un jeton d'authentification valide. Enregistrez un ordinateur. Identifiez l'identifiant de la flotte et le nom du calcul.
Dans l'exemple suivant, remplacez les valeurs d'espace réservé pour votre calcul et votre parc. 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 trouver des informations de calcul, appelez list-compute avec 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émarrer un serveur de jeu
Après avoir créé une flotte Anywhere et y avoir ajouté un ou plusieurs ordinateurs, vous pouvez commencer à gérer vos serveurs de jeu.
- Étape 1 Installez le logiciel de votre serveur de jeu
Configurez votre serveur de jeu et installez tous les logiciels qui en dépendent sur chaque ordinateur de votre parc Anywhere. La version du serveur de jeu doit être intégrée au SDK Amazon GameLift Servers du serveur version 5.x (ou supérieure) avec le minimum de fonctionnalités requises pour communiquer avec le Amazon GameLift Servers service.
- É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 les processus du serveur de jeu.
Si vous avez déployé l'Amazon GameLift Serversagent 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 l'action SDK du serveur 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().
Si vous avez déployé le logiciel de votre serveur de jeu avec l'Amazon GameLift ServersAgent, 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 statistiques des processus du serveur pour les activer et les activer. Consultez GameLift Serveurs Amazon métriques pour les flottes. Si le processus de votre serveur de jeu ne parvient pas à s'initialiser, vérifiez qu'il récupère les valeurs de paramètres de serveur appropriées pour le calcul sur lequel il s'exécute.