​

Cómo ejecutar un servidor de juegos con LocalMultiplayerAgent en modo de contenedor

• Crear una compilación de contenedor [Linux/Windows] con el ejemplo Wrapper
• Configurar MultiplayerSettings.json
• Configurar Docker
• Ejecutar LocalMultiplayerAgent
• Probar la conexión con su juego

​

Crear una compilación de contenedor [Linux/Windows]

​

Compilación de contenedor de Linux

​

Compilación de contenedor de Windows

​

Configurar MultiplayerSettings.json

{
    "RunContainer": true, // Set RunContainer to true if you are running LMA in Container mode.
    "OutputFolder": "C:\\output\\LMAContainer", // Path where config files and logs will be generated from LMA at each run
    "NumHeartBeatsForActivateResponse": 10,
    "NumHeartBeatsForTerminateResponse": 60,
    "TitleId": "", // default value
    "BuildId": "00000000-0000-0000-0000-000000000000", // default value
    "Region": "59F84", // default value
    "AgentListeningPort": 56001, // default value
    "ContainerStartParameters": {
        /// replace ImageDetails fields to your own images saved on ACR.
        "ImageDetails": {
            "Registry": "mydockerregistry.io",
            "ImageName": "wrapper",
            "ImageTag": "0.1",
            "Username": "",
            "Password": ""
        }
    },
    "PortMappingsList": [
        [
            {
                "NodePort": 56100,
                "GamePort": {
                    "Name": "game_port", 
                    // The same value of GamePort Name should be also defined in the Wrapper so Wrapper can get a port information while it's running.
                    "Number": 80,
                    "Protocol": "TCP"
                }
            }
        ]
    ],
}

"AssetDetails": [
    {
      "MountPath": "C:\\Assets",  
      // Mount Path should be "C:\\Assets" for Windows Container. 
      "LocalFilePath": "D:\\gameassets.zip" 
      // where your game server is located as an archive format.
    }
  ]

 "ContainerStartParameters": {
    "StartGameCommand": "C:\\Assets\\wrapper.exe -g C:\\Assets\\fakegame.exe arg1 arg2", 
    // Your game assets will be extracted under C:\\Assets (default mount path for Windows Container) and LMA will run your game server with StartGameCommand argument. 
     // Make sure the StartGameCommand provided above is an example of the Wrapper sample. 
    "ImageDetails": {
      "Registry": "mcr.microsoft.com",
      "ImageName": "playfab/multiplayer",
      "ImageTag": "wsc-10.0.17763.973.1",
      "Username": "", 
      "Password": ""
      // username and password are not required to use MCR image.
    }
    // LMA will package an existing game sample (path defined in LocalFilePath) as a Windows container.
 }

• LocalFilePath: ruta local completa (en su estación de trabajo) al archivo zip del recurso del servidor de juegos creado anteriormente, por ejemplo: D:\gameassets.zip (tenga en cuenta que las barras diagonales inversas deben escaparse para el formato JSON). Este campo es obligatorio para el contenedor de Windows, ya que LMA necesita localizar su recurso de juego y luego empaquetarlo en un contenedor.
• PortMappingsList: estos son los puertos que están disponibles para su juego mientras se ejecuta.
  • NodePort es el puerto que se abre en su estación de trabajo y se asignará al GamePort.
  • GamePort.Number es el puerto al que su servidor de juegos debe enlazarse cuando se ejecuta en un contenedor. Por ejemplo, aquí establecemos el número de puerto en 80, que es el que escuchará fakegame.exe.
  • Establezca GamePort.Name en el mismo valor definido en su servidor de juegos. Puede comprobar la configuración del GSDK en tiempo de ejecución para obtener el valor con la clave GamePort.Name.
  • GamePort.Protocol: especifique el tipo de protocolo: TCP o UDP
  Actualice la sección GamePort para que coincida con el protocolo y el puerto en los que su servidor de juegos escucha a los clientes. Puede agregar varios puertos.
• ForcePullFromAcrOnLinuxContainersOnWindows: establézcalo en true cuando quiera extraer la imagen de contenedor de Linux desde el registro de Docker y evitar la extracción desde el registro local. En la mayoría de los casos, querrá establecerlo en false.
• ContainerStartParameters.ImageDetails: la imagen de su servidor de juegos puede publicarse en un registro de contenedores o compilarse localmente. Si desea extraer la imagen de contenedor de Linux desde el registro de Docker (por ejemplo, Azure Registry), debe establecer el valor de nombre de usuario y contraseña, y establecer ForcePullFromAcrOnLinuxContainersOnWindows en true. Para el contenedor de Windows, el nombre de usuario y la contraseña no son necesarios.
• OutputFolder: ruta a una unidad o carpeta donde se generan las salidas y los archivos de configuración. Asegúrese de que haya suficiente espacio disponible, ya que el servidor de juegos se extraerá en esta ruta. Si no se especifica, se usa la carpeta del agente.
• AgentListeningPort: este es el puerto que usa LMA para comunicarse con el servidor de juegos. Cualquier puerto abierto funcionará; 56001 es el valor predeterminado. Si tiene otro proceso enlazado al puerto 56001, debe cambiar este valor o finalizar el otro proceso en el puerto 56001.
• ResourceLimits (opcional): si se especifica, Docker limita el uso de CPU/memoria. Advertencia: si su servidor supera la memoria permitida, se finaliza. ResourceLimits solo puede especificarse en modo de contenedor.
• SessionCookie (opcional): cualquier cookie de sesión que se pasa a su servidor de juegos como parte de la llamada a la API RequestMultiplayerServer. En el escenario real en MPS, después de establecer la conexión, el servidor notificará al cliente que cargue los recursos correspondientes desde SessionCookie.

​

Configuración de Docker

• Para el contenedor de Linux, ejecute SetupLinuxContainersOnWindows.ps1.
  Para el contenedor de Windows, ejecute Setup.ps1. Descargará la imagen de Docker de PlayFab desde Microsoft/PlayFab-Multiplayer.
  Tenga en cuenta que la primera vez que se ejecuta el script, la descarga de la imagen de contenedor puede tardar unos minutos.

  Para ejecutar esta configuración correctamente, es posible que tenga que configurar el firewall de cualquier programa antivirus de terceros que tenga instalado.

​

Ejecutar LocalMultiplayerAgent

• En una ventana de PowerShell:
  Vaya al directorio de LMA que contiene LocalMultiplayerAgent.exe.
• Ejecute LocalMultiplayerAgent.exe para el contenedor de Windows.
  Ejecute LocalMultiplayerAgent.exe -lcow para el contenedor de Linux.
  (lcow significa Linux Containers On Windows) En este punto, LMA configura el agente de escucha http y ejecuta un contenedor. Puede ejecutar el comando docker ps para ver los contenedores en ejecución en su máquina.

1. CurrentGameState - Initializing
   (Es posible que esto no aparezca si su servidor de juegos llama directamente a GSDK::ReadyForPlayers y no llama a GSDK::Start)
2. CurrentGameState - StandingBy
3. CurrentGameState - Active
4. CurrentGameState - Terminating

​

Probar la conexión con su juego

​

Solución de problemas

• En modo de contenedor, si su servidor de juegos se cierra inmediatamente con un error similar a “Container … exited with exit code 1”, pero funciona bien en modo de proceso, asegúrese de que ha incluido todas las DLL del sistema necesarias en su paquete de recursos.
• Todos los registros se encuentran en la carpeta OutputFolder especificada en el archivo MultiplayerSettings.json. LocalMultiplayerAgent crea una carpeta nueva cada vez que se inicia, con la marca de tiempo como nombre de carpeta. Todos los registros del servidor de juegos emitidos mediante el GSDK se encuentran dentro de la carpeta GameLogs.
  Si el servidor de juegos se ejecuta en un contenedor, es posible que haya un nivel adicional de jerarquía de directorios por recorrer.
• El GSDK escribe registros de depuración en la carpeta GameLogs dentro de OutputFolder. Estos registros se encuentran dentro de la carpeta GameLogs junto con los registros generados por el servidor de juegos.
• Asegúrese de que los firewalls (de Windows y otros antivirus) estén configurados para permitir el tráfico a través de los puertos.
• Si recibe un error similar a: Docker API responded with status code=InternalServerError, response={"message":"failed to create endpoint <container_name> on network playfab: hnsCall failed in Win32: The specified port already exists". It is likely there is already a container running on the specified port. Esto puede ocurrir si LocalMultiplayerAgent se cierra prematuramente. Use el comando docker ps para encontrar el contenedor que se está ejecutando y luego elimínelo mediante docker kill <container_name>.
• Si recibe un error que contiene Failed to find network 'playfab', intente volver a ejecutar Setup.ps1

​

Limitaciones conocidas

1. Es posible que los contenedores no terminen al final de la depuración. Si esto ocurre, ejecute los siguientes comandos de PowerShell como administrador. Estos comandos detienen y quitan todos los contenedores, incluidos los que no fueron iniciados por LocalMultiplayerAgent.

docker stop $(docker ps -aq)
docker rm $(docker ps -aq)