Super Renders Farm에서 파일 업로드 및 다운로드

소개

렌더팜으로 프로젝트 파일을 이동하는 과정은 워크플로우에서 가장 자주 문제가 생기는 부분입니다. 렌더가 실패하는 것은 엔진이 잘못 작동해서가 아니라, 원격 노드에서 텍스처 경로가 해석되지 않거나, 프로젝트가 렌더팜이 절대 압축을 풀지 않는 ZIP 형태로 올라가거나, 느린 가정용 연결이 20분 후에 업로드 중간에 멈추기 때문입니다.

Super Renders Farm은 프로젝트 파일을 이동하는 세 가지 방법(웹 인터페이스, SuperRenders Client App, S3 액세스(Cyberduck 또는 AWS CLI))과 렌더링된 출력을 가져오는 세 가지 방법을 지원합니다. 어떤 방법이 추상적으로 "맞는 방법"인 것은 없습니다. 각 방법은 파일 크기, 네트워크 속도, 동일한 프로젝트를 얼마나 자주 다시 제출하는지에 따라 적합한 지점이 다릅니다.

이 가이드에서는 작업에 맞는 방법을 선택하는 결정 트리, 각 방법에 대한 단계별 지침, 지원에서 가장 자주 보는 업로드 오류 참조를 제공합니다.

결정 트리: 어느 업로드 방법을 사용해야 합니까?

세 가지 방법은 서로 대체 가능하지 않습니다. 프로젝트를 처음 제출할 때 이 짧은 결정 트리를 사용하고, 워크플로우가 안정되면 전환하시기 바랍니다.

웹 UI를 사용하십시오:

• 총 프로젝트 크기가 약 2 GB 미만인 경우
• 지속적으로가 아닌 가끔씩(한 달에 몇 번) 작업을 제출하는 경우
• 설치가 없이 브라우저만 사용하고 싶은 경우

Client App을 사용하십시오:

• 적어도 매주 작업을 제출하고 수동 단계를 줄이고 싶은 경우
• 프로젝트가 약 2 GB보다 큰 경우
• 연결이 끊겼을 때 업로드가 자동으로 재시작되기를 원하는 경우
• 완료된 프레임이 완료되는 대로 로컬 폴더로 자동 다운로드되기를 원하는 경우

S3 액세스(Cyberduck 또는 AWS CLI)를 사용하십시오:

• 이미 S3 클라이언트를 사용 중이며 브라우저나 Client App보다 이를 선호하는 경우
• SRF Space로의 업로드 또는 다운로드를 스크립트로 자동화하고 싶은 경우. AWS CLI는 터미널이나 예약된 스크립트에서 실행됩니다
• 액세스 키를 다루는 데 익숙한 경우(비밀번호처럼 취급하십시오)

모든 경로에 적용되는 작은 주의사항이 있습니다. 렌더팜은 아카이브를 압축 해제하지 않습니다 (.zip, .rar, .7z, .tar, .tar.gz). 렌더 관리자가 에셋 경로를 해석할 수 있도록, 팜은 압축되지 않은 프로젝트 폴더(씬 파일과 올바른 디렉터리 구조의 모든 참조된 에셋)가 필요합니다. 아래 일반 업로드 오류 섹션에서 자세히 설명합니다.

방법 1: 웹 UI 업로드

웹 업로드는 가장 간단한 경로이며 첫 번째 제출과 소규모 프로젝트에 저희가 권장하는 방법입니다.

단계별 안내:

1. superrendersfarm.com에서 계정에 로그인하고 렌더 대시보드를 엽니다.
2. New Job(또는 도착한 엔진 랜딩에 따라 Submit Project)을 클릭합니다.
3. 업로드 영역에 프로젝트 폴더를 드래그하거나, Choose Folder를 클릭하고 선택합니다.
4. 업로드 진행 표시줄이 완료될 때까지 기다립니다. 많은 에셋이 있는 프로젝트의 경우 브라우저가 개별 파일 진행 상황을 표시합니다.
5. 업로드가 완료되면 렌더 설정(프레임 범위, 출력 형식, 우선순위)을 구성하고 작업을 제출합니다.

실용적인 한계. 브라우저는 개별 업로드 세션을 제한하므로 웹 경로는 약 2 GB 이상에서 느려지고 가정용 연결에서 약 5 GB 이상에서 불안정해집니다. 브라우저 탭이 업로드 중에 닫히면 전송이 중단됩니다. 브라우저 측에서는 재개가 없습니다. 그 범위의 프로젝트의 경우 Client App으로 전환하시기 바랍니다.

업로드되는 것. 드래그 앤 드롭은 폴더 구조를 정확히 보존합니다. 씬이 \textures\와 \proxies\의 텍스처를 참조하는 경우, 해당 하위 폴더는 드래그된 최상위 프로젝트 폴더 안에 같은 이름으로 있어야 합니다. 팜에서 누락된 참조는 거의 항상 이러한 하위 폴더 중 하나가 업로드 루트 외부에 있는 것으로 추적됩니다.

방법 2: SuperRenders Client App

Client App은 대부분의 프로덕션 스튜디오가 결국 정착하는 경로입니다. 브라우저 경로가 지원하지 않는 연결 끊김 시 재개, 무결성 검사, 완료된 프레임의 자동 다운로드를 처리합니다.

단계별 안내:

1. Download page에서 Client App을 다운로드하고 워크스테이션에 설치합니다.
2. Super Renders Farm 계정 자격증명으로 로그인합니다.
3. New Project를 클릭하고 프로젝트 폴더를 선택합니다. 앱이 씬 파일과 참조된 에셋을 스캔합니다.
4. 파일 목록을 검토합니다. 앱이 업로드가 시작되기 전에 누락된 참조를 표시하므로 실패한 렌더 후가 아닌 로컬에서 수정할 수 있습니다.
5. Upload를 클릭합니다. 진행 상황이 파일별로 표시되며 연결이 끊기면 업로드가 자동으로 재개됩니다.
6. 업로드가 완료되면 앱 안에서 렌더 설정을 구성하고 제출합니다.

자동 다운로드. Client App은 돌아오는 여정도 처리합니다. 로컬 출력 폴더를 활성화하면 완료된 프레임이 각 프레임이 완료되는 대로 워크스테이션으로 스트리밍됩니다. 아무것도 가져오기 전에 전체 작업이 완료될 때까지 기다릴 필요가 없습니다.

플러그인 v1 vs v2 참고사항. 구버전 Client App을 사용하는 스튜디오는 현재 설치 경로, 플러그인 버전 호환성, Spaces(저희 차세대 전송 레이어)가 Client App을 대체할 때의 마이그레이션 계획에 대해 tools and Client App reference를 확인하시기 바랍니다. 해당 문서는 DCC별 플러그인 통합, 엔드투엔드 제출, 심층 문제 해결 단계를 다룹니다. 이 페이지는 업로드 및 다운로드 부분만 다룹니다.

방법 3: S3 액세스(Cyberduck 또는 AWS CLI)

S3 액세스를 사용하면 브라우저나 Client App 없이도 표준 S3 클라이언트로 워크스테이션과 SRF Space 간에 파일을 이동할 수 있습니다. 이 방법으로 업로드한 파일은 SRF Space에 표시되며 다른 업로드와 마찬가지로 작업에 사용할 수 있습니다. S3 액세스는 파일 이동만 수행합니다. 작업 제출은 여전히 웹 대시보드, Client App, 또는 DCC 플러그인에서 해야 합니다.

단계별 안내:

1. 계정에서 Cloud Direct Connect를 열고 액세스 키를 생성합니다(포털에서는 이를 FTP 계정이라고 부릅니다). Access Key ID, Secret Access Key, Remote Directory를 복사합니다.
2. Cyberduck: Open Connection을 선택하고, 프로토콜로 Amazon S3를 선택한 뒤 Access Key ID와 Secret Access Key를 입력합니다. More Options를 펼쳐 Path에 Remote Directory를 입력한 다음 연결합니다.
3. AWS CLI: aws configure를 실행하고 Access Key ID와 Secret Access Key를 입력한 뒤, 리전을 ap-southeast-1로 설정하고 출력 형식은 비워 둡니다. 그런 다음 압축을 해제한 프로젝트 폴더를 Remote Directory로 복사합니다. 예: aws s3 cp ./my-project s3://<Remote Directory>/my-project --recursive.
4. 업로드한 파일을 선택하여 웹 대시보드, Client App, 또는 DCC 플러그인에서 작업을 제출합니다.

S3로 결과물 받기. 완료된 프레임은 SRF Space 안의 SuperRendersOutput/<job ID>/ 폴더에 기록되므로, 동일한 클라이언트로 가져올 수 있습니다. 예: aws s3 sync s3://<Remote Directory>/SuperRendersOutput/<job ID>/ ./frames/.

알아두면 좋은 점. 계정에는 하나의 액세스 키가 있으며, 만료되지 않습니다. 비밀번호처럼 취급하여 공유 스크립트나 저장소에 포함하지 마십시오. 변경이 필요하시면 지원팀에 문의해 주십시오. 임시 및 시스템 파일(*.tmp, *.temp, *.partial, *.swap, *.lnk, *.ini, *.db)과 rendertemp/ 폴더는 렌더 노드로 전달되지 않으므로, 씬 데이터를 이런 이름의 파일에 두지 마십시오.

Amazon S3 프로토콜을 사용하는 Cyberduck 또는 AWS CLI를 이용하십시오. FileZilla 및 FTP/SFTP 클라이언트는 연결되지 않습니다.

비교: 한눈에 보는 방법

프로젝트 형태에 맞는 방법을 선택하시기 바랍니다. 200 MB 스틸은 브라우저로도 충분합니다. 캐시된 유체가 있는 60 GB 애니메이션은 Client App을 통해, 또는 파이프라인이 이미 전송을 스크립트로 처리한다면 S3 액세스를 통해 전송해야 합니다.

일반 업로드 오류

지원에서 가장 자주 보는 오류와 먼저 확인할 사항입니다.

".zip, .rar 또는 .7z를 업로드했는데 작업이 씬을 찾지 못합니다."

.zip, .rar, .7z 파일을 업로드하실 수는 있지만, 렌더팜은 이들을 압축 해제하지 않으므로 아카이브 안의 내용은 렌더링되지 않습니다(웹 업로더가 자동으로 압축이 해제되지 않는다는 경고를 표시합니다). .tar와 .tar.gz도 마찬가지입니다. 씬 폴더의 압축을 해제하고 파일을 그대로 업로드해 주십시오. 동료의 ZIP 납품물로 작업하는 경우 먼저 로컬에서 압축을 풀고 결과 폴더를 업로드해 주십시오.

"Missing texture: D:\projects\..."

씬이 팜의 워커 노드에 존재하지 않는 로컬 컴퓨터의 절대 경로를 참조합니다. 이것이 실패한 작업의 가장 일반적인 원인이며, 웹 UI 또는 Client App을 통해 업로드했는지 여부에 관계없이 나타납니다. 상대 경로를 사용하여 로컬에서 수정하시기 바랍니다(대부분의 DCC에는 "make paths relative" 또는 "consolidate assets" 명령이 있습니다: Maya의 File → Reference Editor → Make Relative, 3ds Max의 File → Archive, Blender의 File → Pack External Data). Client App은 업로드가 시작되기 전에 절대 경로를 사전 스캔하여 표시하므로 왕복 여행을 절약합니다.

"Upload timed out."

특히 1 GB 이상의 파일이 있는 Wi-Fi를 통한 가정용 연결에서 일반적입니다. 브라우저 경로는 재개되지 않습니다. 일시적인 연결 끊김에서 복구되는 Client App으로 전환하시기 바랍니다. 로컬 업로드 속도도 확인하시기 바랍니다(대부분의 ISP는 가정용 업로드를 10~50 Mbps로 제한합니다). 10 Mbps 라인에서 20 GB 프로젝트는 약 5시간의 지속적인 전송이 필요합니다.

"Invalid project structure."

업로드한 폴더에 팜이 인식하는 씬 파일(.max, .ma/.mb, .c4d, .blend, .hip/.hiplc, .aep)이 포함되어 있지 않습니다. 일반적인 원인: 전체 프로젝트 루트 대신 텍스처 폴더만 드래그하는 경우입니다. 씬 파일이 포함되도록 한 수준 위에서 다시 업로드하시기 바랍니다.

"Asset paths point outside the project folder."

씬이 프로젝트 루트보다 상위에 있는 에셋을 참조합니다(예: \Project_X\에서 한 수준 위의 공유 \Studio Library\ 폴더). 워커 노드는 업로드된 폴더 안에 있는 것만 볼 수 있습니다. 업로드 전에 해당 에셋을 로컬에서 프로젝트 폴더로 통합하거나(대부분의 DCC에는 "collect all assets" 명령이 있습니다), 모든 참조 경로가 해석되도록 상위 폴더를 업로드하시기 바랍니다.

렌더링된 출력 다운로드

완료된 프레임을 가져오는 세 가지 경로가 있습니다. 대시보드에서 수동 다운로드, Client App을 통한 자동 스트리밍, 또는 SRF Space의 SuperRendersOutput/<job ID>/ 폴더에서 S3로 가져오는 방식입니다.

대시보드를 통한 수동 다운로드. 작업이 완료되면 대시보드에 각 출력 프레임이 나열되고 프레임별 및 전체 작업 다운로드를 제공합니다. 애니메이션 작업의 경우 대시보드가 출력을 압축합니다(이것은 다운로드 편의 기능이며 제출 형식이 아닙니다). 전체 시퀀스를 하나의 전송으로 가져올 수 있습니다. 스틸 또는 짧은 시퀀스의 경우 프레임별 다운로드가 파일 수를 관리 가능하게 유지합니다.

Client App을 통한 자동 다운로드. Client App이 설치되고 로컬 출력 폴더가 구성된 상태에서 완료된 프레임이 각 프레임이 완료되는 대로 스트리밍됩니다. 전체 작업이 완료될 때까지 기다릴 필요가 없습니다. 프레임 240~480이 아직 렌더링 중인 동안 프레임 1을 검토할 수 있습니다. 이는 검토 주기가 렌더 자체와 겹치는 장시간 애니메이션 작업에 특히 유용합니다.

Cyberduck 또는 AWS CLI를 통한 S3 가져오기. S3 액세스(Cloud Direct Connect)를 사용하는 경우 완료된 프레임은 SRF Space 안의 SuperRendersOutput/<job ID>/ 폴더에 기록됩니다. 업로드할 때 사용하는 동일한 클라이언트로 가져올 수 있습니다. 예: aws s3 sync s3://<Remote Directory>/SuperRendersOutput/<job ID>/ ./frames/. 설정은 위의 방법 3에서 다룹니다.

보존. 출력 파일은 작업이 완료된 후 다운로드할 수 있는 상태로 유지되며, 고정된 자동 삭제 기간은 없습니다. 요청하시면 프로젝트를 삭제해 드립니다. 장기 보관의 경우 팜을 백업 티어로 의존하지 말고 스튜디오의 스토리지에 다운로드하시기 바랍니다.

FAQ

Q: Super Renders Farm은 왜 ZIP 파일을 압축 해제하지 않습니까? A: 렌더 관리자는 에셋 경로를 해석하기 위해 프로젝트 폴더를 탐색해야 합니다. 씬 파일은 상대 또는 절대 경로로 텍스처, 프록시, 캐시, 플러그인을 참조합니다. 렌더팜은 어떤 형식의 아카이브도 압축 해제하지 않으므로, 프로젝트를 압축되지 않은 폴더로 업로드해 주십시오. 이는 모든 DCC의 "collect all assets" 명령이 기본적으로 생성하는 형태입니다.

Q: 업로드할 수 있는 가장 큰 프로젝트는 얼마입니까? A: 상한이 없습니다. 저희는 캐시된 시뮬레이션이 있는 수백 기가바이트 애니메이션 프로젝트를 처리했습니다. 대용량 프로젝트에는 Client App을 사용해 주십시오. 브라우저 업로드는 장시간 전송에서 지연되지만, Client App은 중단된 지점부터 다시 시작합니다.

Q: 연결이 불안정한 경우 어떻게 업로드합니까? A: SuperRenders Client App을 사용하시기 바랍니다. 연결 끊김 시 재개되므로 Wi-Fi 연결이 끊겨도 전송이 처음부터 다시 시작되지 않습니다. 브라우저 업로드 경로는 재개되지 않습니다. 탭이 업로드 중에 닫히면 전송이 중단됩니다.

Q: 렌더링된 프레임은 팜에서 얼마나 오래 보관됩니까? A: 출력 파일은 작업이 완료된 후 다운로드할 수 있는 상태로 유지되며, 고정된 자동 삭제 기간은 없습니다. 요청하시면 프로젝트를 삭제해 드립니다. 보관을 위해서는 팜을 장기 백업으로 취급하지 말고 완료된 작업을 스튜디오의 스토리지에 다운로드하시기 바랍니다.

Q: 완료된 프레임을 워크스테이션으로 자동으로 가져오는 방법은 무엇입니까? A: 구성된 출력 폴더와 함께 SuperRenders Client App을 사용하시기 바랍니다. 프레임이 완료되는 대로 스트리밍됩니다. 이후 프레임이 아직 렌더링 중인 동안 초기 프레임을 검토할 수 있습니다. 대시보드의 수동 다운로드 경로는 일회성 작업에 적합하지만 애니메이션 작업의 경우 Client App의 자동 다운로드가 많은 대기를 줄여줍니다.

Q: 씬이 네트워크 드라이브의 텍스처를 참조합니다. 업로드됩니까? A: 네트워크 드라이브 경로가 업로드된 프로젝트 폴더 안에 있는 경우에만 됩니다. 워커 노드는 스튜디오의 네트워크 공유에 직접 도달할 수 없습니다. 먼저 로컬에서 DCC의 "collect all assets" 또는 "consolidate references" 명령을 실행하시기 바랍니다. 이렇게 하면 모든 참조된 파일이 프로젝트 폴더에 복사되고 경로가 상대적으로 다시 작성됩니다. 그 다음 통합된 폴더를 업로드하시기 바랍니다. 저희가 보는 대부분의 실패 작업 티켓은 이 단계를 건너뛴 것으로 추적됩니다.

형식 및 용량 제한 상세 안내: 렌더팜이 프로젝트를 압축 해제된 상태로 요구하는 이유와 프로젝트가 약 2 GB를 넘을 때 어떤 업로드 경로를 사용해야 하는지는 전용 가이드에서 다룹니다: 업로드 형식 및 용량 제한.