Container Service for Kubernetes:Best practices for Unity remote rendering

Contenerizar la aplicación Unity y el servidor web

1. Compile la imagen de la aplicación Unity. Siga Linux graphics application best practices para los pasos de containerization. Utilice una imagen base unityci/editor que coincida con su versión de Unity Editor; las etiquetas disponibles se encuentran en unityci/editor en Docker Hub. Esta guía utiliza ubuntu-2021.3.2f1-mac-mono-1.0.1 con paquetes adicionales: vulkan-util, libc++1 y libc++abi1.

2. Compile la imagen del servidor web. Utilice el siguiente Dockerfile:

   FROM ubuntu:20.04
   WORKDIR /run
   COPY webserver ./
   CMD webserver -w

Desplegar en ACK

1. Cree un archivo llamado unity-demo.yaml con el siguiente contenido:

   apiVersion: v1
   kind: Pod
   metadata:
     name: unity-demo
     namespace: default
   spec:
     # The Linux web server sample binds WebSocket to 127.0.0.1 only.
     # Use host network mode so browsers can reach it through the node's EIP.
     hostNetwork: true
     nodeName: <your-gpu-node-name>
     containers:
     - image: <your-unity-image>:<tag>
       name: unity
       command: ["/run/mac-linux/mac-linux.x86_64"]
       securityContext:
         # privileged: true is required for the Unity process to access
         # the GPU device on the host.
         privileged: true
     - image: <your-webserver-image>:<tag>
       name: webserver
       ports:
       - containerPort: 80
         protocol: TCP
     restartPolicy: Always

   Ambos contenedores comparten el namespace de red del Pod. Unity se conecta al servidor web en 127.0.0.1:80 mediante WebSocket; el servidor web acepta conexiones de navegadores en el puerto 80.

   Explicación de los campos clave:

   • hostNetwork: true — El ejemplo del servidor web se vincula únicamente a 127.0.0.1. El modo de red host permite acceder a él mediante la dirección IP elástica (EIP) del nodo.

   • privileged: true — Obligatorio para que el contenedor de Unity acceda a la GPU del host.

   • nodeName — Fija el Pod a un nodo GPU específico. Reemplace <your-gpu-node-name> con el nombre de su nodo.

2. Aplique el manifiesto:

   kubectl apply -f unity-demo.yaml

3. Compruebe que el Pod esté en ejecución:

   kubectl get pod unity-demo

   Salida esperada:

   NAME         READY   STATUS    RESTARTS   AGE
   unity-demo   2/2     Running   0          30s

   Si el Pod no se está ejecutando, revise los registros del contenedor:

   kubectl logs unity-demo -c unity
   kubectl logs unity-demo -c webserver

Browser -> EIP (port 80) -> web server (WebSocket signaling) -> Unity application (WebRTC stream)