메인 콘텐츠로 건너뛰기

​
개요

이 가이드는 Twenty 자가 호스팅 인스턴스에서 Twenty Cloud로 데이터를 마이그레이션하는 과정을 안내합니다. 이 프로세스에는 클라우드 워크스페이스 설정, 데이터 내보내기, 그리고 다시 가져오기가 포함됩니다.
마이그레이션 후에는 뷰, 워크플로우, 역할을 수동으로 다시 만들어야 합니다. 이 구성 작업에 필요한 시간을 계획하세요.

​
1단계: 클라우드 워크스페이스 생성

  1. app.twenty.com으로 이동하여 새 워크스페이스를 생성하세요
  2. 초기 설정 마법사를 완료하세요
  3. 새 워크스페이스 URL을 기록해 두세요

​
2단계: 데이터 모델 다시 생성

데이터를 가져오기 전에 사용자 지정 객체와 필드를 다시 만드세요:
  1. 클라우드 인스턴스에서 설정 → 데이터 모델로 이동하세요
  2. 자가 호스팅 설정과 일치하는 사용자 지정 객체를 생성하세요
  3. 표준 객체와 사용자 지정 객체에 사용자 지정 필드를 추가하세요
  4. 필드 설정(고유, 필수 등)을 구성하세요
참고용으로 자가 호스팅 데이터 모델의 스크린샷을 찍거나, 두 인스턴스를 나란히 열어 두세요.

​
3단계: 모든 사용자 초대

중요: 데이터를 가져오기 전에 사용자를 초대하세요.사용자가 참조되는 레코드(예: Account Owner 필드)를 가져오기 전에 초대를 수락해야 합니다. 사용자가 아직 존재하지 않으면 해당 관계를 매핑할 수 없습니다.
  1. 클라우드 인스턴스에서 설정 → 멤버로 이동하세요
  2. 자가 호스팅에서 계정을 보유했던 모든 팀 멤버를 초대하세요
  3. 모두가 초대를 수락할 때까지 기다리세요
  4. 모든 사용자가 멤버 목록에 표시되는지 확인하세요

​
4단계: 자가 호스팅에서 데이터 내보내기

자가 호스팅 인스턴스에서 각 객체를 내보내세요:
  1. 각 객체(회사, 사람, 기회 등)로 이동하세요
  2. 마이그레이션하려는 모든 열이 보이도록 뷰를 구성하세요
  3. ⋮ → 뷰 내보내기를 클릭하세요
  4. 각 CSV 파일을 명확한 이름으로 저장하세요(예: companies-export.csv)
다음 순서로 내보내세요(가져올 때 참고용):
  1. 회사
  2. 사람들
  3. 기회
  4. 사용자 지정 객체(종속성을 따름)
  5. 작업, 노트

​
5단계: 워크스페이스 멤버 참조 업데이트

내보낸 CSV에는 자가 호스팅 인스턴스의 사용자 ID가 포함되어 있습니다. 이 ID는 클라우드 인스턴스와 일치하지 않으므로 이메일로 대체해야 합니다. 사용자 참조(Owner, Assignee 등)가 있는 각 CSV 파일의 경우:
  1. 스프레드시트 애플리케이션에서 CSV를 여세요
  2. 각 사용자 ID 열 옆에 새 열을 추가하세요(예: accountOwnerId 옆에 accountOwnerEmail)
  3. 각 사용자의 이메일 주소를 입력하세요
  4. 이전 ID 열은 삭제하거나 그대로 둘 수 있습니다(가져오기 중에 건너뜁니다)
예시: 이전: 
name,domain,accountOwnerId
Acme Corp,https://acme.com,old-uuid-123
이후: 
name,domain,accountOwnerEmail
Acme Corp,https://acme.com,john@yourcompany.com
사용자가 클라우드 워크스페이스 초대를 수락할 때 사용한 것과 동일한 이메일 주소를 사용하세요.

​
6단계: 가져오기 순서 계획

관계를 유지하려면 올바른 순서로 파일을 가져오세요:
  1. 먼저 회사(종속성 없음)
  2. 그다음 사람(회사에 연결)
  3. 세 번째로 기회(회사 및 사람에 연결)
  4. 사용자 지정 객체(종속성을 따름)
  5. 마지막으로 작업과 노트(다른 레코드에 연결)
관계 유지에 대한 자세한 내용은 관계 가져오기 방법을 참조하세요.

​
7단계: 클라우드로 가져오기

각 CSV 파일에 대해 다음 순서로 진행하세요:
  1. 클라우드 인스턴스에서 해당 객체로 이동하세요
  2. ⋮ → 레코드 가져오기를 클릭하세요
  3. CSV 파일을 업로드하세요
  4. 열을 필드에 매핑하세요:
    • 사용자 이메일 열을 해당 관계 필드에 매핑하세요
    • 다른 열도 일반적으로 매핑하세요
  5. 오류가 있으면 검토하고 수정하세요
  6. 가져오기를 확인하세요
  7. 다음 파일로 진행하기 전에 몇 개의 레코드를 확인하세요

​
8단계: 구성 다시 생성

데이터를 가져온 후 다음을 수동으로 다시 만드세요:

​
보기

  • 필터, 정렬, 열 구성과 함께 저장된 뷰를 다시 만드세요
  • 칸반 또는 캘린더 뷰를 설정하세요

​
워크플로우

  • 설정 → 워크플로우에서 자동화를 다시 만드세요
  • 사용하기 전에 각 워크플로우를 테스트하세요

​
역할 및 권한

  • 설정 → 역할에서 역할을 구성하세요
  • 적절한 역할에 사용자를 할당하세요

​
통합

  • 각 사용자의 이메일 및 캘린더 동기화를 다시 연결하세요
  • 새 API 키로 모든 API 통합을 다시 구성하세요

​
마이그레이션 후 체크리스트

모든 데이터가 성공적으로 가져와졌음
객체 간 관계가 올바르게 동작함
사용자 할당(Owner, Assignee)이 올바르게 매핑됨
뷰 재생성 완료
워크플로우 재생성 및 테스트 완료
역할 및 권한 구성 완료
이메일/캘린더 동기화 재연결 완료
API 통합이 새 키로 업데이트됨

​
FAQ

현재는 불가능합니다. 워크플로우는 클라우드 인스턴스에서 수동으로 다시 만들어야 합니다.
파일 첨부는 CSV 내보내기에 포함되지 않습니다. 첨부 파일은 수동으로 다시 업로드하거나 API를 통해 마이그레이션해야 하며, 대규모 마이그레이션의 경우 당사 팀에 연락하여 지원을 받으세요.
예. 클라우드 마이그레이션이 완료되었음을 확인할 때까지 자가 호스팅 인스턴스를 실행 상태로 유지하는 것을 권장합니다. 단, 두 곳 모두에서 새 데이터를 생성하지 않도록 주의하세요.
해당 사용자를 참조하는 레코드는 가져오기에 실패하거나 관계가 비어 있게 됩니다. 데이터를 가져오기 전에 모든 사용자가 초대를 수락했는지 확인하세요.

​
도움이 필요하신가요?

복잡한 마이그레이션이나 대규모 데이터 세트의 경우 contact@twenty.com으로 문의하시거나 구현 서비스를 확인하세요.