Container Service for Kubernetes:Best practices for Unity remote rendering

Containerizar a aplicação Unity e o servidor web

1. Crie a imagem da aplicação Unity. Siga as Melhores práticas para aplicações gráficas Linux para obter as etapas de containerização. Utilize uma imagem base unityci/editor compatível com sua versão do Unity Editor — as tags disponíveis encontram-se em unityci/editor no Docker Hub. Este guia usa a tag ubuntu-2021.3.2f1-mac-mono-1.0.1 com pacotes adicionais: vulkan-util, libc++1 e libc++abi1.

2. Crie a imagem do servidor web. Use o seguinte Dockerfile:

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

Implantar no ACK

1. Crie um arquivo chamado unity-demo.yaml com o seguinte conteúdo:

   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 os contêineres compartilham o namespace de rede do Pod. O Unity se conecta ao servidor web em 127.0.0.1:80 via WebSocket; o servidor web aceita conexões do navegador na porta 80.

   Explicação dos campos principais:

   • hostNetwork: true — O exemplo de servidor web vincula-se apenas a 127.0.0.1. O modo de rede do host torna o serviço acessível por meio do endereço IP elástico (EIP) do nó.

   • privileged: true — Necessário para que o contêiner do Unity acesse a GPU do host.

   • nodeName — Fixa o Pod em um nó GPU específico. Substitua <your-gpu-node-name> pelo nome do seu nó.

2. Aplique o manifesto:

   kubectl apply -f unity-demo.yaml

3. Verifique se o Pod está em execução:

   kubectl get pod unity-demo

   Saída esperada:

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

   Caso o Pod não esteja em execução, verifique os logs dos contêineres:

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

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