시작하기
서버
호드 서버의 소스 코드는 Engine/Source/Programs/Horde/Horde.Server 에 있습니다. 이 소스 코드는 ASP.NET을 사용하여 C#로 작성되었습니다.
호드는 Microsoft에서 게시한 표준
C# 코딩 규칙을 사용하지만, 레거시상의 이유로 공백 대신 탭을 사용합니다. NET SDK와 함께 제공되는 대부분의 스태틱 분석 툴 경고를 활성화하지만, .editorconfig 파일을 통해 일부 비활성화할 수 있습니다.
호드는 기본적으로 로컬 개발을 지원하도록 환경설정되어 있습니다. Engine/Source/Programs/Horde/Horde.sln 을 열고 Horde.Server를 기본 프로젝트로 설정하여 실행할 수 있습니다. 기본적으로 http://localhost:5000/account 에서 서버에 액세스할 수 있습니다.
라이브 디플로이에 대해 로컬 호드 서버를 디버깅하는 경우 Server.json의 DatabaseReadOnlyMode 프로퍼티를 설정하면 서버가 서버 상태를 수정하는 작업을 시도하지 않도록 할 수 있습니다. 또한 안전상의 이유로 읽기 전용 DB 계정을 사용하는 것이 권장됩니다.
대시보드
호드 대시보드는 TypeScript에서 React를 사용하여 개발한 프론트엔드 클라이언트입니다. 대시보드 개발을 위해 머신을 구성하려면 다음 단계를 따릅니다.
- Node.js를 설치합니다.
- 명령줄에서
npm install --global yarn을 사용하여 Yarn을 설치합니다. Engine\Source\Programs\Horde\HordeDashboard에 있는 대시보드 폴더로 이동합니다.yarn install을 실행하여 패키지 종속성을 설치합니다.- package.json을 편집하여 프록시 프로퍼티가 서버 URL을 가리키도록 설정합니다. 예를 들면
http://localhost:13340과 같습니다. - 서버의 관리자 토큰 엔드포인트로 이동하여 만료되는 액세스 토큰을 얻습니다. 예를 들면
http://localhost:13340/api/v1/admin/token과 같습니다. - 루트 HordeDashboard 폴더에서
.env.development.local이라는 파일을 생성하고REACT_APP_HORDE_DEBUG_TOKEN=eyFhbGciziJIUz와 같이 액세스 토큰을 붙여넣습니다. yarn start를 실행하여 개발 웹 서버를 엽니다. 그러면http://localhost:3000에서 로컬 대시보드에 탭이 열립니다.
Docker
호드에는 Docker 이미지 생성을 위한 Dockerfile 이 포함되어 있습니다. 그러나 언리얼 엔진 소스 트리 내 해당 위치로 인해, 빌드 이미지로 복사되는 데이터의 크기를 줄이기 위해 파일이 미리 스테이징되어야 합니다.
이러한 작업을 수행하는 BuildGraph 스크립트는 Engine\Source\Programs\Horde\HordeBuild.xml 아래에 포함되며, 다음과 같이 실행될 수 있습니다.
RunUAT.bat Engine/Source/Programs/Horde/HordeBuild.xml -Target="Build HordeServer"