언리얼 엔진에서 컨테이너 이미지를 사용하는 방법에 대한 퀵스타트 가이드 | 언리얼 엔진 5.1 문서

컨테이너 퀵스타트는 언리얼 엔진의 공식 컨테이너 이미지에 액세스하고 이를 사용하여 간단한 컨테이너를 실행하는 방법을 안내하기 위해 디자인되었습니다. 이 가이드에서는 다음과 같은 작업을 안내합니다.

컴퓨터에 Docker를 설치합니다.
Docker를 사용하여 사전 빌드된 언리얼 엔진 컨테이너 이미지를 다운로드할 수 있도록 GitHub Container Registry에 로그인합니다.
언리얼 엔진용으로 사전 빌드된 Linux 개발 컨테이너 이미지를 다운로드합니다.
개발 이미지를 사용하여 컨테이너를 시작합니다.
컨테이너 내에서 프로젝트를 빌드하고 패키징합니다.

1. 요구 사항

이 퀵스타트를 위한 언리얼 엔진 컨테이너 이미지를 실행하려면 컴퓨터가 하드웨어 및 소프트웨어 요구 사항 페이지의 Linux 컨테이너 섹션에 나열된 하드웨어 및 소프트웨어 요구 사항을 충족해야 합니다.

2. GitHub 액세스 검증하기

GitHub의 언리얼 엔진 소스 코드 저장소(https://github.com/EpicGames/UnrealEngine)에 액세스할 수 있는지 확인합니다. 저장소에 액세스할 수 없는 경우 GitHub 계정을 에픽게임즈 계정과 연결해야 합니다.

3. Docker 설치하기

Docker는 언리얼 엔진에 포함된 컨테이너 이미지를 빌드하고 실행하는 데 권장되는 툴입니다. Docker 설치 단계는 사용 중인 운영 체제에 따라 달라집니다. 각 플랫폼에서 Docker를 설치하는 방법은 다음 링크에서 확인할 수 있습니다.

Windows: Docker Desktop for Windows 설치
macOS: Docker Desktop for Mac 설치
Linux: 특정 Linux 배포판에 Docker 엔진을 설치하는 방법은 다음 링크를 참고하세요.

4. GitHub Container Registry로 인증하기

Docker를 사용하여 GitHub Container Registry의 컨테이너 이미지를 다운로드하려면 개인 액세스 토큰을 사용하여 인증해야 합니다. read:packages 범위의 개인 액세스 토큰이 아직 없는 경우 다음 단계에 따라 토큰을 생성해야 합니다.

필요한 범위의 개인 액세스 토큰을 생성했다면 GitHub 지침에 설명된 대로 docker login 명령을 사용하여 GitHub Container Registry로 인증합니다. 이 명령은 사용 중인 운영 체제에 따라 다르게 액세스되는 명령줄 인터페이스에서 실행해야 합니다.

Windows: 시작 메뉴를 열고 검색창에 'cmd'를 입력합니다. 첫 번째 검색 결과로 '명령 프롬프트' 애플리케이션이 표시됩니다. 클릭하거나 Enter 키를 눌러 명령 프롬프트를 실행합니다.
macOS: Command+스페이스 바를 눌러 Spotlight 검색을 열고 검색창에 'terminal'을 입력합니다. 첫 번째 검색 결과로 '터미널' 애플리케이션이 표시됩니다. 클릭하거나 Enter 키를 눌러 터미널을 실행합니다.
Linux: 데스크톱 환경의 검색 기능(일반적으로 Super 키를 눌러 액세스)을 열고 검색창에 'terminal'을 입력합니다. 첫 번째 검색 결과로 터미널 애플리케이션이 표시됩니다. 클릭하거나 Enter 키를 눌러 터미널을 실행합니다.

명령줄 프롬프트를 열고 아래에 표시된 명령을 실행합니다. ACCESS_TOKEN 은 개인 액세스 토큰으로, USERNAME 은 GitHub 사용자 이름으로 변경합니다.

	echo ACCESS_TOKEN | docker login ghcr.io -u USERNAME --password-stdin

인증 프로세스가 성공적으로 진행되었다면 'Login Succeeded' 라는 메시지가 표시됩니다.

5. 사전 빌드된 컨테이너 이미지 가져오기

언리얼 엔진용으로 사전 빌드된 공식 컨테이너 이미지는 ghcr.io/epicgames/unreal-engine 저장소에 이미지 태그로 저장됩니다. 언리얼 엔진 4.27용 Linux 개발 이미지를 다운로드하려면 아래와 같이 docker pull 명령을 사용하세요.

	docker pull ghcr.io/epicgames/unreal-engine:dev-4.27

이렇게 하면 상당히 큰 언리얼 에디터 및 빌드 툴을 위한 파일을 캡슐화하는 컨테이너 이미지가 다운로드됩니다. 인터넷 연결 속도에 따라 다운로드에 시간이 걸릴 수 있습니다. 다운로드가 완료되면 'Status: Downloaded newer image for ghcr.io/epicgames/unreal-engine:dev-4.27' 이라는 메시지가 표시됩니다.

6. 개발 컨테이너에서 프로젝트 빌드하기

테스트용으로 사용할 수 있는 언리얼 엔진 프로젝트가 없는 경우 이 단계를 따라 새 프로젝트를 생성해야 합니다. Linux와 호환되지 않는 코드 플러그인을 사용하는 프로젝트를 제외한 모든 프로젝트를 사용하여 개발 컨테이너 이미지를 테스트할 수 있습니다.

명령줄 프롬프트를 열고 아래의 명령을 실행하여 개발 이미지를 사용하는 새 컨테이너를 시작하고, PROJECT_PATH 를 프로젝트에서 .uproject 파일이 포함된 디렉터리 경로로 변경합니다.

	docker run --rm -ti -v "PROJECT_PATH:/project" ghcr.io/epicgames/unreal-engine:dev-4.27

이렇게 하면 프로젝트 파일에 액세스할 수 있는 컨테이너가 시작됩니다. 컨테이너가 Linux를 실행하고 있으므로 Linux 디바이스용 프로젝트를 빌드하고 패키징하는 데 사용할 수 있습니다. 프로젝트를 패키징하려면 아래의 명령을 실행하고 PROJECT_NAME 을 프로젝트 이름으로 바꿉니다.

	/home/ue4/UnrealEngine/Engine/Build/BatchFiles/RunUAT.sh \
	BuildCookRun \
	-utf8output \
	-platform=Linux \
	-clientconfig=Shipping \
	-serverconfig=Shipping \
	-project=/project/PROJECT_NAME.uproject \
	-noP4 -nodebuginfo -allmaps \
	-cook -build -stage -prereqs -pak -archive \
	-archivedirectory=/project/Packaged

프로젝트가 블루프린트 전용 프로젝트가 아닌 경우 프로젝트용 C++ 코드 모듈이 컴파일되고 프로젝트 에셋이 쿠킹된 후 패키징됩니다. 패키징된 파일은 .uproject 파일이 포함된 디렉터리 내의 Packaged 라는 하위 디렉터리에 배치됩니다.

컨테이너를 중지하려면 아래의 명령을 실행합니다.

	exit

다음 단계

이제 사전 빌드된 컨테이너 이미지 작업의 기본적인 단계를 익혔으므로 다음의 리소스로 언리얼 엔진 컨테이너 사용에 대해 계속해서 자세히 알아볼 수 있습니다.

사전 빌드된 컨테이너 이미지를 다운로드하는 것 외에, 언리얼 엔진에 포함된 모든 이미지는 소스에서 커스터마이징하고 빌드할 수도 있습니다.
- 하우투: 소스에서 Linux 컨테이너 이미지 빌드하기
- 하우투: 소스에서 Windows 컨테이너 이미지 빌드하기
개발 이미지가 필요한지 런타임 이미지가 필요한지 잘 모르는 경우에는 언리얼 컨테이너 커뮤니티 허브의 인터랙티브 퀵스타트 가이드를 살펴보세요.
언리얼 엔진 컨테이너를 활용할 수 있는 사용 사례 목록을 살펴보세요.

Prerequisite topics