BlueRoseNote/03-UnrealEngine/流程管理与部署/UE5 Ubantu & Docker 部署.md

---
title: UE5 Ubantu & Docker 部署
date: 2023-09-12 18:20:39
excerpt: 
tags:
  - Ubantu
  - Docker
rating: ⭐⭐
---
# 前言
本文假设系统已经安装完Docker，并且读者已经将镜像拉取完毕。并且假设此电脑装有显卡，且显存在3G以上（切记：AI专业显卡无法启动UE）。
- 文档地址:https://docs.unrealengine.com/5.3/en-US/quick-start-guide-for-using-container-images-in-unreal-engine/
- 镜像地址:https://github.com/orgs/epicgames/packages/container/package/unreal-engine

# UE安装
不同于Windows与Mac系统，Linux没有提供Epic启动器，但可以直接下载官方编译好的版本。各版本下载地址:https://www.unrealengine.com/en-US/linux
# UE镜像选择
- [runtime](https://github.com/orgs/epicgames/packages/container/unreal-engine/111082761?tag=runtime) 
- [dev-5.3](https://github.com/orgs/epicgames/packages/container/unreal-engine/125977937?tag=dev-5.3)
- [dev-slim-5.3](https://github.com/orgs/epicgames/packages/container/unreal-engine/125977946?tag=dev-slim-5.3)

镜像主要分为runtime以及dev两种类型（slim为瘦身版）。主要的区别在于runtime是为了运行UE打包过的项目，带有图形显示环境。dev则带有一个对应版本的虚幻引擎，此引擎为源码编译版，官方也提供执行编译&构建镜像资料，有需求可以自行编译，一般这种镜像是为了编译、打包、测试项目或者执行CPU操作所用。

官方的runtime容器用的是第三方制作的镜像(也可以算是官方的，github的ReadME说是参与了官方容器的开发):
- https://github.com/adamrehn/ue4-runtime
- https://hub.docker.com/r/adamrehn/ue4-runtime/tags
更多信息可以参考这位大佬的网站:https://unrealcontainers.com/docs/obtaining-images/write-your-own

本人因为项目需求使用`ue4-runtime:22.04-vulkan-x11`镜像。该镜像会将镜像内的UE窗口直接映射到系统桌面上，可以方便得查看错误。

PS.dev镜像因为带有引擎，需要下载20~30G，只建议肉身翻墙或者高级科学上网工具者使用。但即使肉身翻墙，10GB的那个包下载速度依然特别慢。最终解压完的镜像大约有60多G，小空间的VPS也不好整。
## 问题解决
### Docker提示没有可选设备驱动
>docker: Error response from daemon: could not select device driver ““ with capabilities: [[gpu]]

解决方法，安装nvidia-container-toolkit。
```bash
curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | \
sudo apt-key add -
distribution=$(. /etc/os-release;echo $ID$VERSION_ID)
curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | \
sudo tee /etc/apt/sources.list.d/nvidia-docker.list
sudo apt-get update

sudo apt-get install -y nvidia-container-toolkit
sudo systemctl restart docker
```

### 构建带有UE的图形环境
简单的做法就是下载一份Linux版本的UE之后将目录映射进容器，比如：
```bash
sudo docker run --gpus=all --rm -e DISPLAY -ti \
-v /tmp/.X11-unix:/tmp/.X11-unix:rw \
-v /home/user/Linux_Unreal_Engine_5.1.1:/home/ue4/UnrealEngine \
-v /home/user/Project/:/project \
adamrehn/ue4-runtime:22.04-vulkan-x11
```

后台运行：
```bash
sudo docker run --gpus=all -d --restart=always --privileged=true  -e DISPLAY -ti \
-v /home/user/Linux_Unreal_Engine_5.1.1:/home/ue4/UnrealEngine \
-v /home/user/Project/:/project \
adamrehn/ue4-runtime:22.04-vulkan-x11
```
之后可以使用docker exec让项目启动。
# 进入容器
![[UEDocker_进入UE容器.png]]
使用第一个命令构建容器后，会进入容器，并且可以通过输入命令行进行操作，主要的命令有：
- 生成解决方案:/home/ue4/UnrealEngine/Engine/Build/BatchFiles/Linux/GenerateProjectFiles.sh /project/XXXX.uproject -game -engine -rocket -progress -VSCode
- 编译项目:/home/ue4/UnrealEngine/Engine/Build/BatchFiles/Linux/Build.sh Development Linux -Project="/project/XXXX.uproject" -TargetType=Editor -Progress -NoEngineChanges -NoHotReloadFromIDE
- 启动项目:/home/ue4/UnrealEngine/Engine/Binaries/Linux/UnrealEditor -logs "/project/XXXX.uproject"

**为了防止生成解决方案失败，可以把项目目录与UE目录设置权限。**
PS.实际是因为Ubantu系统版本可能与容器系统并不相同，所以需要重新编译一下，才能运行项目。