언리얼 엔진에 포함된 모든 컨테이너 이미지는 GitHub Container Registry에서 사전 빌드된 버전으로 다운로드할 수 있습니다. 커스텀 버전의 언리얼 엔진을 위한 개발 이미지를 생성하거나 이미지 소스 코드를 수정하려는 경우에만 소스에서 이미지를 빌드하면 됩니다.
요구 사항
언리얼 엔진에 포함된 Linux 컨테이너 이미지를 빌드하려면 컴퓨터가 하드웨어 및 소프트웨어 요구 사항 페이지의 Linux 컨테이너 섹션에 나열된 하드웨어 및 소프트웨어 요구 사항을 충족해야 합니다.
Windows에서는 소스에서 Linux 컨테이너 이미지를 빌드하는 것이 지원되지 않습니다. Windows 10 및 Windows 11에서 Docker Desktop 또는 WSL2를 사용하여 이미지를 빌드할 수 있지만, 이러한 프로세스가 올바르게 작동하려면 추가적인 환경설정과 문제 해결이 필요하며 에픽게임즈에서는 이와 관련된 지원을 제공하지 않습니다. 대신 가상 머신에 설치하거나 호스트 머신에 직접 설치한 Linux에서 Linux 컨테이너 이미지를 빌드해야 합니다.
Docker 설치하기
Docker는 언리얼 엔진에 포함된 컨테이너 이미지를 빌드하고 실행하는 데 권장되는 툴입니다. Docker 설치 단계는 사용 중인 운영 체제에 따라 달라집니다. 각 플랫폼에서 Docker를 설치하는 방법은 다음 링크에서 확인할 수 있습니다.
-
Windows: Docker Desktop for Windows 설치
-
macOS: Docker Desktop for Mac 설치
-
Linux: 특정 Linux 배포판에 Docker 엔진을 설치하는 방법은 다음 링크를 참고하세요.
공식 출시 버전 엔진용 이미지 빌드하기
GitHub에서 언리얼 엔진 소스 코드를 다운로드했다면 소스에서 엔진을 빌드할 때와 마찬가지로 소스 트리의 루트에서 Setup.sh 를 실행하여 엔진의 바이너리 종속성을 다운로드해야 합니다. 이 단계를 수행하지 않으면 컨테이너 이미지 빌드에 필요한 파일이 누락됩니다.
언리얼 엔진 소스 코드의 다음 하위 디렉터리로 이동합니다.
Engine/Extras/Containers/Dockerfiles/linux
Linux 컨테이너 이미지용 빌드 스크립트는 username.txt 와 password.txt 라는 파일에서 Git 크리덴셜을 검색합니다.
-
username.txt파일을 생성하고 GitHub 사용자 이름을 채워 넣습니다. -
password.txt파일을 생성하고 GitHub 개인 액세스 토큰을 채워 넣습니다.
지정된 언리얼 엔진 출시 버전용으로 Linux 컨테이너 이미지를 빌드하려면 Bash 셸에서 아래에 표시된 명령을 실행하고, ENGINE_RELEASE 부분을 해당되는 출시 버전 번호(예: '4.27.0')로 바꿉니다.
./build.sh ENGINE_RELEASE
이렇게 하면 Linux용 런타임 이미지와 Linux용 개발 이미지를 모두 빌드한 다음 픽셀 스트리밍과 같은 특정 사용 사례의 이미지를 빌드하게 됩니다. 개발 이미지는 GitHub에서 언리얼 엔진 소스 코드를 다운로드하고 엔진의 설치된 빌드를 생성하기 때문에 빌드하는 데 시간이 가장 오래 걸립니다.
커스텀 버전 엔진용 이미지 빌드하기
빌드 스크립트는 Git에서 언리얼 엔진 소스 코드를 얻는 것만 지원합니다. Perforce와 같은 다른 버전 관리 시스템은 지원되지 않습니다. 개발 이미지의 Dockerfile을 직접 수정하여 다른 버전 관리 시스템을 사용할 수는 있지만, 에픽게임즈에서는 이와 관련된 지원을 제공하지 않습니다.
Linux 컨테이너 이미지용 빌드 스크립트는 공식 GitHub Repository를 사용하는 대신 언리얼 엔진 소스 코드를 얻을 커스텀 Git Repository 및 분기 지정을 지원합니다. 커스텀 Repository에는 공식 언리얼 엔진 저장소 또는 내부 사용을 위해 조직에서 관리하는 온프레미스 Git 서버에 저장된 비공개 저장소의 GitHub 포크가 포함될 수 있습니다.
username.txt 와 password.txt 파일에 Git 크리덴셜을 채워 넣는 방법은 다음과 같이 사용하는 Git Repository의 타입에 따라 다릅니다.
-
GitHub 포크:
- GitHub 사용자 이름과 개인 액세스 토큰을 사용합니다.
-
커스텀 Git 서버:
-
username.txt파일에 Git 사용자 이름을 채워 넣습니다. -
password.txt파일에 Git 비밀번호를 채워 넣습니다.
-
Git Repository의 특정 분기에 대한 Linux 컨테이너 이미지를 빌드하려면 Bash 셸에서 아래에 표시된 명령을 실행하여 BRANCH 를 분기 이름으로, REPOSITORY 를 Git Repository의 HTTPS URL로 바꿉니다(예: 'https://github.com/EpicGames/UnrealEngine.git').
./build.sh BRANCH REPOSITORY
고급 빌드 파라미터 수정하기
빌드 스크립트 build.sh 에는 파일을 수동으로 편집하여 수정할 수 있는 다음과 같은 고급 빌드 파라미터가 포함됩니다.
BASEIMAGE: 개발 이미지를 빌드할 때 사용할 Linux 베이스 이미지를 지정하는 스트링입니다. 이 값은 기본적으로 NVIDIA에서 제공하는 Ubuntu 베이스 이미지로 설정되며, OpenGL 개발 헤더를 포함합니다.