Tutorial: Creación de un conjunto de reglas de emparejamiento - Amazon GameLift Servers

Tutorial: Creación de un conjunto de reglas de emparejamiento

Antes de crear un conjunto de reglas de emparejamiento para el emparejador de Amazon GameLift Servers FlexMatch, le recomendamos comprobar la sintaxis del conjunto de reglas. Después de crear un conjunto de reglas con la consola de Amazon GameLift Servers o la AWS Command Line Interface (AWS CLI), no podrá cambiarlo.

Tenga en cuenta que hay una cuota de servicio para el número máximo de conjuntos de reglas que puede tener en una región de AWS, por lo que conviene eliminar los conjuntos de reglas que no se utilizan.

Temas
    Console
    Creación de un conjunto de reglas

    1. Abra la consola de Amazon GameLift Servers en https://console.aws.amazon.com/gamelift/.

    2. Cambie a la región de AWS donde desee crear el conjunto de reglas. Defina conjuntos de reglas en la misma región que la configuración de emparejamiento que los utiliza.

    3. En el panel de navegación, elija FlexMatch, Conjuntos de reglas de emparejamiento.

    4. En la página Conjuntos de reglas de emparejamiento, elija Crear conjunto de reglas.

    5. En la página Crear un conjunto de reglas de emparejamiento, realice el siguiente procedimiento:

      1. En Configuración del conjunto de reglas, en Nombre, especifique un nombre descriptivo único que pueda utilizar para identificarlo en una lista o en las tablas de eventos y métricas.

      2. En Conjunto de reglas, especifique el conjunto de reglas en JSON. Para obtener información sobre el diseño de un conjunto de reglas, consulte Diseño de un conjunto de reglas de FlexMatch. También puede utilizar uno de los conjuntos de reglas de ejemplo de Ejemplos de conjuntos de reglas de FlexMatch.

      3. Elija Validar para verificar que la sintaxis del conjunto de reglas sea correcta. No puede editar los conjuntos de reglas una vez creados, por lo que es una buena idea validarlos primero.

      4. En Etiquetas, añada etiquetas que le ayuden a administrar recursos de AWS y a realizar un seguimiento de ellos.

    6. Seleccione Crear. Si la creación se realiza correctamente, podrá utilizar el conjunto de reglas con un emparejador.

    AWS CLI

    Creación de un conjunto de reglas

    Abra una ventana de línea de comandos y utilice el comando create-matchmaking-rule-set.

    Este comando de ejemplo crea un sencillo conjunto de reglas de emparejamiento para configurar un equipo. Asegúrese de crear el conjunto de reglas en la misma región de AWS que las configuraciones de emparejamiento que lo utilizan.

    aws gamelift create-matchmaking-rule-set \
    --name "SampleRuleSet123" \
    --rule-set-body '{"name": "aliens_vs_cowboys", "ruleLanguageVersion": "1.0", "teams": [{"name": "cowboys", "maxPlayers": 8, "minPlayers":  4}]}'

    Si la solicitud de creación es correcta, Amazon GameLift Servers devuelve un objeto MatchmakingRuleSet que incluye la configuración que haya especificado. Un emparejador puede utilizar ahora el conjunto de reglas nuevo.

    Console
    Eliminación de un conjunto de reglas

    1. Abra la consola de Amazon GameLift Servers en https://console.aws.amazon.com/gamelift/.

    2. Cambie a la región en la que creó el conjunto de reglas.

    3. En el panel de navegación, elija FlexMatch, Conjuntos de reglas de emparejamiento.

    4. En la página Conjuntos de reglas de emparejamiento, seleccione el conjunto de reglas que desee eliminar y, a continuación, elija Eliminar.

    5. En el cuadro de diálogo Eliminar conjunto de reglas, elija Eliminar para confirmar la eliminación.

      nota

      Si una configuración de emparejamiento utiliza el conjunto de reglas, Amazon GameLift Servers muestra un mensaje de error (No se puede eliminar el conjunto de reglas). Si esto ocurre, cambie la configuración de emparejamiento para utilizar un conjunto de reglas diferente e inténtelo de nuevo. Para saber qué configuraciones de emparejamiento utilizan actualmente un conjunto de reglas, elija el nombre de un conjunto de reglas para ver la página de detalles correspondiente.

    AWS CLI

    Eliminación de un conjunto de reglas

    Abra una ventana de línea de comandos y utilice el comando delete-matchmaking-rule-set para eliminar un conjunto de reglas de emparejamiento.

    Si una configuración de emparejamiento utiliza el conjunto de reglas, Amazon GameLift Servers devuelve un mensaje de error. Si esto ocurre, cambie la configuración de emparejamiento para utilizar un conjunto de reglas diferente e inténtelo de nuevo. Para obtener una lista de las configuraciones de emparejamiento que utilizan un conjunto de reglas, utilice el comando describe-matchmaking-configurations y especifique el nombre del conjunto de reglas.

    En este comando de ejemplo, primero se comprueba el uso del conjunto de reglas de emparejamiento y, a continuación, se elimina el conjunto de reglas.

    aws gamelift describe-matchmaking-rule-sets \
    --rule-set-name "SampleRuleSet123" \
    --limit 10

aws gamelift delete-matchmaking-rule-set \
    --name  "SampleRuleSet123"