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

소개

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

Super Renders Farm은 프로젝트를 업로드하는 네 가지 방법(웹 인터페이스, SuperRenders Client App, SFTP, 클라우드 스토리지 가져오기 — Google Drive 또는 Dropbox)과 렌더링된 출력을 가져오는 두 가지 방법을 지원합니다. 어떤 방법이 추상적으로 "맞는 방법"인 것은 없습니다. 각 방법은 파일 크기, 네트워크 속도, 동일한 프로젝트를 얼마나 자주 다시 제출하는지, 스튜디오가 이미 SFTP 또는 공유 클라우드 스토리지를 일상적으로 운영하는지에 따라 정의된 최적의 사용 사례가 있습니다.

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

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

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

웹 UI를 사용하십시오:

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

Client App을 사용하십시오:

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

SFTP를 사용하십시오:

• 프로젝트가 크고(10 GB 이상 — 캐시된 유체, 큰 포인트 클라우드, 밀도 높은 Forest Pack 스캐터가 있는 애니메이션 프로젝트)
• 스튜디오에 이미 SFTP 클라이언트(FileZilla, Cyberduck, WinSCP, Transmit)와 그것을 중심으로 구축된 내부 워크플로우가 있는 경우
• 아티스트 워크스테이션이 아닌 Linux 박스 또는 서버에서 제출하는 경우
• 업로드를 스크립팅해야 하는 경우(CI, 렌더 준비 자동화)

Google Drive 또는 Dropbox 가져오기를 사용하십시오:

• 팀이 거기서 협업하기 때문에 프로젝트가 이미 공유 클라우드 스토리지에 있는 경우
• 느린 가정용 연결을 사용하고 있지만 파일이 이미 더 빠른 연결을 가진 동료에 의해 Drive 또는 Dropbox에 완전히 업로드된 경우
• 파일이 약 500 MB에서 약 20 GB 사이인 경우 (더 작은 파일은 간접 접근이 정당화되지 않고 매우 큰 파일은 직접 전송이 더 빠릅니다)

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

방법 1: 웹 UI 업로드

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

단계별 안내:

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

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

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

방법 3: SFTP 업로드

SFTP는 대용량 프로젝트, 스크립트 워크플로우, 이미 파이프라인의 일부로 SFTP를 운영하는 스튜디오에 저희가 권장하는 경로입니다. 포트 22의 SSH를 통해 실행되며 수 기가바이트 전송을 안정적으로 처리합니다.

단계별 안내:

1. 계정 대시보드에서 SFTP 자격증명을 생성합니다. 각 계정에는 자체 SFTP 호스트, 사용자 이름, 키가 있습니다. 기본적으로 팀원 간에 공유되지 않습니다(팀 계정은 아티스트별로 별도 자격증명을 발급할 수 있습니다).
2. SFTP 클라이언트를 엽니다(Windows의 FileZilla, Cyberduck, WinSCP, macOS의 Transmit 또는 내장 sftp, Linux의 OpenSSH sftp).
3. 대시보드의 호스트, 사용자 이름, 키를 사용하여 연결합니다.
4. 계정의 업로드 디렉터리로 이동합니다. 첫 번째 연결 시 기본 랜딩 경로로 표시되는 경우가 많습니다.
5. 원격 패널에 프로젝트 폴더를 드래그하고 전송이 실행되도록 기다립니다.
6. 업로드가 완료되면 웹 대시보드 또는 Client App으로 전환하여 렌더 설정을 구성하고 작업을 제출합니다. SFTP는 파일 전송을 처리하지만 렌더 자체를 제출하지는 않습니다.

대용량 프로젝트에 SFTP를 사용하는 이유. 브라우저 업로드와 Client App 모두 자체 오버헤드를 추가합니다. SFTP는 유선 연결에서 거의 라인 속도로 실행되고, 일시적인 연결 끊김에서 복구되며, 50 GB 이상의 전송에 잘 작동합니다. 캐시된 시뮬레이션, 큰 텍스처, 또는 프록시 지오메트리가 있는 애니메이션 프로젝트의 경우 SFTP가 거의 항상 올바른 선택입니다.

스크립팅. OpenSSH sftp와 SSH를 통한 rsync 모두 CI 파이프라인과 렌더 준비 자동화에 작동합니다. 내부 렌더 준비 스크립트가 있는 스튜디오는 일반적으로 프로젝트 폴더를 생성하고 체크섬을 실행하고 단일 단계로 팜에 푸시합니다. 대시보드에 작업이 제출 준비가 된 것으로 표시될 때까지 사람이 개입할 필요가 없습니다.

방법 4: 클라우드 스토리지 가져오기 (Google Drive / Dropbox)

팀이 이미 Google Drive 또는 Dropbox를 통해 프로젝트를 공유하는 경우, 로컬 워크스테이션에서 다시 업로드하지 않고 직접 가져올 수 있습니다. 파일이 이미 클라우드 스토리지에 있고 로컬 연결이 클라우드 간 전송보다 느린 경우에 유용합니다.

단계별 안내 (Google Drive):

1. 프로젝트의 Drive 폴더에서 프로젝트 폴더를 우클릭하고 Get link → Anyone with the link can view를 선택합니다. 폴더는 Google Workspace 로그인 없이 접근 가능해야 합니다.
2. 링크를 복사합니다.
3. Super Renders Farm 대시보드에서 New Job → Import from Cloud Storage → Google Drive를 엽니다.
4. 공유 링크를 붙여넣고 Import를 클릭합니다. 팜이 서버 측에서 폴더를 가져옵니다. 귀하의 컴퓨터에서 업로드가 없습니다.
5. 가져오기가 완료되면 렌더 설정을 구성하고 제출합니다.

단계별 안내 (Dropbox):

1. Dropbox에서 프로젝트 폴더를 우클릭하고 Share → Create link를 선택합니다. 링크가 "Anyone with the link can view"로 설정되어 있는지 확인합니다.
2. 링크를 복사합니다.
3. 대시보드에서 New Job → Import from Cloud Storage → Dropbox를 엽니다.
4. 링크를 붙여넣고 Import를 클릭합니다. Drive와 동일한 서버 측 가져오기 패턴입니다.

이 방법이 적합한 시기. 클라우드 가져오기는 파일이 이미 Drive 또는 Dropbox에 완전히 동기화되어 있고 로컬 네트워크가 클라우드 간 링크보다 느린 경우에 가장 빠른 경로입니다. 이미 클라우드 스토리지에 없는 파일의 경우 간접 접근(먼저 Drive에 업로드한 다음 가져오기)이 SFTP 또는 Client App을 통해 직접 가는 것보다 느립니다.

권한 함정. "Only people in your organization" 또는 "Restricted"로 설정된 폴더는 가져오기에 실패합니다. 팜의 가져오기 서버가 귀하의 워크스페이스 멤버가 아닙니다. 가져오기 전에 링크를 "Anyone with the link can view"로 전환하고, 보안 정책에서 요구하는 경우 이후에 취소하시기 바랍니다.

비교: 한눈에 보는 방법

| 방법 | 최적 사용 사례 | 실용적인 크기 범위 | 연결 끊김 시 재개? | 자동 출력 다운로드? | |---|---|---|---|---| | 웹 UI | 가끔, 소규모 프로젝트 | 약 2 GB 미만 | 아니오 | 아니오 (수동 다운로드) | | Client App | 정기적인 제출을 하는 스튜디오 | 2–50 GB | 예 | 예 | | SFTP | 대용량 프로젝트, 스크립트 워크플로우 | 10 GB 이상 (상한 없음) | 예 | 아니오 (가져오기에 Client App 또는 웹 사용) | | 클라우드 가져오기 (Drive / Dropbox) | 이미 공유 클라우드 스토리지에 있는 파일 | 약 500 MB – 20 GB | 해당 없음 (서버 측 가져오기) | 아니오 |

프로젝트 형태에 맞는 방법을 선택하시기 바랍니다. 200 MB 스틸은 SFTP가 필요하지 않습니다. 캐시된 유체가 있는 60 GB 애니메이션은 브라우저를 통해 전송해서는 안 됩니다.

일반 업로드 오류

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

"Upload failed: ZIP file detected."

저희는 ZIP, RAR, 또는 7Z 아카이브를 제출 형식으로 허용하지 않습니다. 렌더 관리자는 에셋 경로를 해석하기 위해 프로젝트 폴더 구조를 탐색해야 합니다. 모든 것이 아카이브 안에 봉인되어 있으면 워커 노드는 먼저 압축을 풀지 않고는 열 수 없습니다. 이는 시간을 추가하고 추가 오류 모드를 만듭니다. 해결 방법: 대신 프로젝트를 압축되지 않은 폴더로 업로드하시기 바랍니다. 동료의 ZIP 납품물로 작업하는 경우 먼저 로컬에서 압축을 풀고 결과 폴더를 업로드하시기 바랍니다.

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

씬이 팜의 워커 노드에 존재하지 않는 로컬 컴퓨터의 절대 경로를 참조합니다. 이것이 실패한 작업의 가장 일반적인 원인이며, 웹 UI, Client App, 또는 SFTP를 통해 업로드했는지 여부에 관계없이 나타납니다. 상대 경로를 사용하여 로컬에서 수정하시기 바랍니다(대부분의 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 또는 SFTP로 전환하시기 바랍니다. 로컬 업로드 속도도 확인하시기 바랍니다(대부분의 ISP는 가정용 업로드를 10~50 Mbps로 제한합니다). 10 Mbps 라인에서 20 GB 프로젝트는 약 5시간의 지속적인 전송이 필요합니다.

"Permission denied" on cloud import.

Drive 또는 Dropbox 폴더가 "Anyone with the link can view"로 설정되어 있지 않습니다. 공유 설정을 열고 공개 링크 접근으로 전환한 후 가져오기를 다시 시도하고 이후에 링크를 취소하시기 바랍니다.

"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을 통한 자동 스트리밍입니다.

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

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

SFTP 가져오기. SFTP는 양방향으로 작동합니다. 프레임이 팜의 출력 영역에 기록되면 업로드에 사용한 것과 같은 클라이언트로 다운로드할 수 있습니다. 스크립트된 렌더 후 파이프라인(자동 인코딩, CDN에 자동 업로드 등)에 유용합니다.

보존. 출력 파일은 정상적인 검토 및 가져오기 주기를 위해 팜에 충분히 오래 보존됩니다. 구체적인 보존 기간은 에 문서화되어 있습니다. 장기 보관의 경우 팜을 백업 티어로 의존하지 말고 스튜디오의 스토리지에 다운로드하시기 바랍니다.

FAQ

Q: Super Renders Farm이 ZIP 파일을 허용하지 않는 이유는 무엇입니까? A: 렌더 관리자는 에셋 경로를 해석하기 위해 프로젝트 폴더를 탐색해야 합니다. 씬 파일은 상대 또는 절대 경로로 텍스처, 프록시, 캐시, 플러그인을 참조합니다. 모든 것이 아카이브 안에 봉인되어 있으면 팜이 먼저 압축을 풀어야 합니다. 이는 시간을 추가하고 추가 오류 모드를 만듭니다. 프로젝트를 압축되지 않은 폴더로 업로드하시기 바랍니다. 모든 DCC의 "collect all assets" 또는 "archive" 명령이 기본적으로 이것을 생성합니다.

Q: 업로드할 수 있는 가장 큰 프로젝트는 얼마입니까? A: 상한이 없습니다. 저희는 캐시된 시뮬레이션이 있는 수백 기가바이트 애니메이션 프로젝트를 처리했습니다. 약 50 GB 이상의 경우 SFTP가 실용적인 선택입니다. 브라우저 업로드는 지연되고, Client App은 대부분의 프로덕션 프로젝트가 있는 2~50 GB 범위에 최적화되어 있습니다.

Q: 연결이 불안정한 경우 어떻게 업로드합니까? A: SuperRenders Client App 또는 SFTP를 사용하시기 바랍니다. 두 방법 모두 연결 끊김 시 재개되므로 Wi-Fi 연결이 끊겨도 전송이 처음부터 다시 시작되지 않습니다. 브라우저 업로드 경로는 재개되지 않습니다. 탭이 업로드 중에 닫히면 전송이 중단됩니다. 매우 불안정한 연결의 경우 rsync-over-SSH를 사용하는 SFTP가 가장 안정적인 동작을 제공합니다.

Q: Google Drive 또는 Dropbox에서 직접 업로드할 수 있습니까? A: 예. Google Drive와 Dropbox 가져오기 모두 지원됩니다. "Anyone with the link can view"로 프로젝트 폴더를 공유하고, 공유 URL을 대시보드의 클라우드 가져오기 옵션에 붙여넣으면 팜이 서버 측에서 폴더를 가져옵니다. 이것은 파일이 이미 클라우드 스토리지에 있는 경우 특히 팀원으로부터 이미 있을 때, 로컬 컴퓨터에 다시 다운로드하고 다시 업로드하는 것보다 빠릅니다.

Q: 렌더링된 프레임은 팜에서 얼마나 오래 보관됩니까? A: 출력 파일은 정상적인 검토 및 가져오기 주기 동안 사용할 수 있습니다. 구체적인 보존 기간은 계정 대시보드에 문서화되어 있습니다. 보관을 위해서 팜을 장기 백업으로 취급하지 말고 완료된 작업을 스튜디오의 스토리지에 다운로드하시기 바랍니다.

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

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