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.
Politiques de dimensionnement basées sur des règles dans Amazon GameLift Servers offrez un contrôle précis lors de l'adaptation automatique de la capacité d'une flotte en fonction de l'activité des joueurs. Pour chaque politique, vous pouvez associer le dimensionnement à l'un des nombreux indicateurs de flotte, identifier un point de déclenchement et personnaliser l'événement de montée en charge ou de réduction correspondant. Les politiques basées sur des règles sont utiles pour compléter la mise à l'échelle basée sur des cibles afin de faire face à des circonstances particulières.
Une politique basée sur des règles stipule ce qui suit : « Si une métrique de flotte atteint ou dépasse une valeur seuil pendant un certain temps, modifiez la capacité de la flotte d'un montant spécifié. » Cette rubrique décrit la syntaxe utilisée pour construire une déclaration de stratégie et fournit une aide pour la création et la gestion de vos règles basées sur des règles.
Gérer les stratégies basées sur des règles
Créez, mettez à jour ou supprimez des politiques basées sur des règles à l'aide d'un AWS SDK ou du AWS Command Line Interface (AWS CLI) avec l'API de service pour Amazon GameLift Servers. Vous pouvez consulter toutes les politiques actives dans le Amazon GameLift Servers console.
Pour arrêter temporairement toutes les politiques de dimensionnement d'une flotte, utilisez la AWS CLI commande stop-fleet-actions.
Pour créer ou mettre à jour une politique de dimensionnement basée sur des règles ()AWS CLI :
-
Définissez les limites de capacité. Définissez l'une ou les deux valeurs limites à l'aide de la update-fleet-capacitycommande. Pour de plus amples informations, veuillez consulter Définir Amazon GameLift Servers limites de capacité.
-
Créez une stratégie. Ouvrez une fenêtre de ligne de commande et utilisez la put-scaling-policycommande avec les paramètres de votre politique. Pour mettre à jour une stratégie existante, spécifiez le nom de la stratégie et indiquez une version complète de la stratégie mise à jour.
--fleet-id<unique fleet identifier>--name "<unique policy name>" --policy-type<target- or rule-based policy>--metric-name<name of metric>--comparison-operator<comparison operator>--threshold<threshold integer value>--evaluation-periods<number of minutes>--scaling-adjustment-type<adjustment type>--scaling-adjustment<adjustment amount>Exemple :
aws gamelift put-scaling-policy \ --fleet-id fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa \ --name "Scale up when AGS<50" \ --policy-type RuleBased \ --metric-name AvailableGameSessions \ --comparison-operator LessThanThreshold \ --threshold 50 \ --evaluation-periods 10 \ --scaling-adjustment-type ChangeInCapacity \ --scaling-adjustment 1
Pour supprimer une politique de dimensionnement basée sur des règles à l'aide de : AWS CLI
-
Ouvrez une fenêtre de ligne de commande et utilisez la delete-scaling-policycommande avec l'ID de flotte et le nom de la politique.
Exemple :
aws gamelift delete-scaling-policy \ --fleet-id fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa \ --name "Scale up when AGS<50"
Syntaxe des règles de mise à l'échelle automatique
Pour élaborer une déclaration de politique de dimensionnement basée sur des règles, spécifiez six variables :
S'il <metric name> reste <comparison
operator> <threshold value> pour<evaluation
period>, modifiez la capacité de la flotte en utilisant <adjustment
type> to/by<adjustment value>.
Par exemple, cette déclaration de politique déclenche un événement de mise à l'échelle chaque fois que la capacité supplémentaire d'une flotte est inférieure à ce qui est nécessaire pour gérer 50 nouvelles sessions de jeu :
Si AvailableGameSessions reste à less than 50 pendant 10 minutes, modifier à la capacité de la flotte avec ChangeInCapacity par 1 instances.
- Nom de la métrique
-
Pour démarrer un événement de dimensionnement, associez une politique de dimensionnement automatique à l'une des mesures spécifiques à la flotte suivantes. Pour une description complète des métriques, voirAmazon GameLift Servers métriques pour les flottes.
-
Activation de sessions de jeu
-
Sessions de jeu actives
-
Sessions de jeu disponibles
-
Pourcentage de sessions de jeu disponibles
-
Instances actives
-
Sessions de joueur disponibles
-
Sessions de joueur actuelles
-
Instances inactives
-
Pourcentage d'instances inactives
Si la flotte se trouve dans une file d'attente de session de jeu, vous pouvez utiliser les statistiques suivantes :
-
Profondeur de la file d'attente — Le nombre de demandes de session de jeu en attente pour lesquelles cette flotte est le meilleur site d'hébergement disponible.
-
Temps d'attente : temps d'attente spécifique à la flotte. Durée pendant laquelle la demande de session de jeu plus ancienne attend d'être traitée. Le temps d'attente d'une flotte correspond à la durée passée en file d'attente de la plus ancienne demande actuelle.
-
- Opérateur de comparaison
-
Raconte Amazon GameLift Servers comment comparer les données métriques à la valeur du seuil. Les opérateurs de comparaison valides sont les suivants : supérieur à (>), inférieur à (= <), greater than or equal (>) et inférieur ou égal (<=).
- Valeur de seuil
-
Lorsque la valeur métrique spécifiée atteint ou dépasse la valeur seuil, elle déclenche un événement de mise à l'échelle. Cette valeur est toujours un nombre entier positif.
- Période d'évaluation
-
La métrique doit atteindre ou dépasser le seuil pendant toute la durée de la période d'évaluation avant de démarrer un événement de dimensionnement. La longueur de la période d'évaluation est consécutive ; si la métrique s'écarte du seuil, la période d'évaluation recommence.
- Type et valeur d'ajustement
-
Cet ensemble de variables fonctionne ensemble pour spécifier comment Amazon GameLift Servers devrait ajuster la capacité de la flotte lorsqu'un événement de mise à l'échelle commence. Choisissez parmi trois types de réglage possibles :
-
Modification de la capacité — Augmentez ou diminuez la capacité actuelle d'un nombre spécifié d'instances. Définissez la valeur d'ajustement en fonction du nombre d'instances à ajouter ou à retirer du parc. Les valeurs positives ajoutent des instances, tandis que les valeurs négatives retirent des instances. Par exemple, une valeur de « -10 » réduit la flotte de 10 instances, quelle que soit la taille totale de la flotte.
-
Variation en pourcentage de la capacité — Augmentez ou diminuez la capacité actuelle d'un pourcentage spécifié. Définissez la valeur d'ajustement selon le pourcentage par lequel vous souhaitez augmenter ou diminuer la capacité de la flotte. Les valeurs positives ajoutent des instances, tandis que les valeurs négatives retirent des instances. Par exemple, pour un parc de 50 instances, une variation en pourcentage de « 20 » ajoute 10 instances au parc.
-
Capacité exacte — Augmentez ou diminuez la capacité actuelle jusqu'à une valeur spécifique. Définissez la valeur d'ajustement sur le nombre exact d'instances que vous voulez maintenir dans le parc.
-
Conseils pour une mise à l'échelle automatique basée sur des règles
Les suggestions suivantes peuvent vous aider à tirer le meilleur parti de la mise à l'échelle automatique grâce à des politiques basées sur des règles.
Utilisation de plusieurs stratégies
Vous pouvez avoir plusieurs politiques de dimensionnement automatique pour une flotte en même temps. Le scénario le plus courant consiste à avoir une stratégie basée sur la cible pour gérer la plupart des besoins de dimensionnement et d'utiliser des stratégies basées sur des règles pour gérer les cas limites. Il n'y a aucune limite à l'utilisation de plusieurs politiques.
Dans le cas de plusieurs politiques, chaque stratégie se comporte de manière indépendante. Il n'existe aucun moyen de contrôler la séquence des événements de dimensionnement. Par exemple, si plusieurs règles régissent la montée en gamme, il est possible que l'activité des joueurs déclenche plusieurs événements de mise à l'échelle simultanément. Évitez les politiques qui démarrent les unes les autres. Par exemple, vous pouvez créer une boucle infinie si vous créez des politiques de mise à l'échelle et de réduction qui fixent la capacité au-delà du seuil défini l'une par rapport à l'autre.
Définir une capacité maximale et minimale
Chaque parc comporte une limite de capacité maximale et minimale. Cette fonctionnalité est importante lors de l'utilisation de la mise à l'échelle automatique. La mise à l'échelle automatique ne définit jamais la capacité à une valeur située en dehors de cette plage. Par défaut, les flottes nouvellement créées ont un minimum de 0 et un maximum de 1. Pour que votre politique de dimensionnement automatique affecte la capacité comme prévu, augmentez la valeur maximale.
La capacité de la flotte est également limitée par les limites relatives au type d'instance de la flotte et par les quotas de service dans votre Compte AWS parc. Vous ne pouvez pas définir de minimum et de maximum en dehors de ces limites et quotas de compte.
Métriques de suivi après une modification de la capacité
Après avoir modifié la capacité en réponse à une politique d'autodimensionnement, Amazon GameLift Servers attend 10 minutes avant de répondre aux déclencheurs de la même politique. Cette attente donne Amazon GameLift Servers il est temps d'ajouter les nouvelles instances, de lancer les serveurs de jeu, de connecter les joueurs et de commencer à collecter des données à partir des nouvelles instances. Pendant cette période, Amazon GameLift Servers évalue la stratégie par rapport à la métrique et suit la période d'évaluation de la politique, qui redémarre après la survenue d'un événement de dimensionnement. Cela signifie qu'une politique de dimensionnement peut déclencher un autre événement de dimensionnement immédiatement après la fin du temps d'attente.
Il n'y a aucun temps d'attente entre les événements de dimensionnement et le lancement de différentes politiques de dimensionnement automatique.
