github-actions[bot]
e0d4492013
Created by Github action Co-authored-by: github-actions <github-actions@twenty.com>
172 lines
7.5 KiB
Plaintext
172 lines
7.5 KiB
Plaintext
---
|
|
title: 자가 호스팅에서 클라우드로 마이그레이션
|
|
description: Twenty 자가 호스팅 인스턴스를 Twenty Cloud로 마이그레이션하는 단계별 가이드.
|
|
---
|
|
|
|
## 개요
|
|
|
|
이 가이드는 Twenty 자가 호스팅 인스턴스에서 Twenty Cloud로 데이터를 마이그레이션하는 과정을 안내합니다. 이 프로세스에는 클라우드 워크스페이스 설정, 데이터 내보내기, 그리고 다시 가져오기가 포함됩니다.
|
|
|
|
<Note>마이그레이션 후에는 뷰, 워크플로우, 역할을 수동으로 다시 만들어야 합니다. 이 구성 작업에 필요한 시간을 계획하세요.</Note>
|
|
|
|
## 1단계: 클라우드 워크스페이스 생성
|
|
|
|
1. [app.twenty.com](https://app.twenty.com)으로 이동하여 새 워크스페이스를 생성하세요
|
|
2. 초기 설정 마법사를 완료하세요
|
|
3. 새 워크스페이스 URL을 기록해 두세요
|
|
|
|
## 2단계: 데이터 모델 다시 생성
|
|
|
|
데이터를 가져오기 전에 사용자 지정 객체와 필드를 다시 만드세요:
|
|
|
|
1. 클라우드 인스턴스에서 **설정 → 데이터 모델**로 이동하세요
|
|
2. 자가 호스팅 설정과 일치하는 사용자 지정 객체를 생성하세요
|
|
3. 표준 객체와 사용자 지정 객체에 사용자 지정 필드를 추가하세요
|
|
4. 필드 설정(고유, 필수 등)을 구성하세요
|
|
|
|
<Note>참고용으로 자가 호스팅 데이터 모델의 스크린샷을 찍거나, 두 인스턴스를 나란히 열어 두세요.</Note>
|
|
|
|
## 3단계: 모든 사용자 초대
|
|
|
|
<Warning>
|
|
**중요: 데이터를 가져오기 전에 사용자를 초대하세요.**
|
|
|
|
사용자가 참조되는 레코드(예: Account Owner 필드)를 가져오기 전에 초대를 수락해야 합니다. 사용자가 아직 존재하지 않으면 해당 관계를 매핑할 수 없습니다.
|
|
</Warning>
|
|
|
|
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 열은 삭제하거나 그대로 둘 수 있습니다(가져오기 중에 건너뜁니다)
|
|
|
|
**예시:**
|
|
|
|
이전:
|
|
|
|
```csv
|
|
name,domain,accountOwnerId
|
|
Acme Corp,https://acme.com,old-uuid-123
|
|
```
|
|
|
|
이후:
|
|
|
|
```csv
|
|
name,domain,accountOwnerEmail
|
|
Acme Corp,https://acme.com,john@yourcompany.com
|
|
```
|
|
|
|
<Note>사용자가 클라우드 워크스페이스 초대를 수락할 때 사용한 것과 동일한 이메일 주소를 사용하세요.</Note>
|
|
|
|
## 6단계: 가져오기 순서 계획
|
|
|
|
관계를 유지하려면 올바른 순서로 파일을 가져오세요:
|
|
|
|
1. 먼저 **회사**(종속성 없음)
|
|
2. 그다음 **사람**(회사에 연결)
|
|
3. 세 번째로 **기회**(회사 및 사람에 연결)
|
|
4. **사용자 지정 객체**(종속성을 따름)
|
|
5. 마지막으로 **작업과 노트**(다른 레코드에 연결)
|
|
|
|
관계 유지에 대한 자세한 내용은 [관계 가져오기 방법](/l/ko/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)을 참조하세요.
|
|
|
|
## 7단계: 클라우드로 가져오기
|
|
|
|
각 CSV 파일에 대해 다음 순서로 진행하세요:
|
|
|
|
1. 클라우드 인스턴스에서 해당 객체로 이동하세요
|
|
2. **⋮ → 레코드 가져오기**를 클릭하세요
|
|
3. CSV 파일을 업로드하세요
|
|
4. 열을 필드에 매핑하세요:
|
|
* 사용자 이메일 열을 해당 관계 필드에 매핑하세요
|
|
* 다른 열도 일반적으로 매핑하세요
|
|
5. 오류가 있으면 검토하고 수정하세요
|
|
6. 가져오기를 확인하세요
|
|
7. 다음 파일로 진행하기 전에 몇 개의 레코드를 확인하세요
|
|
|
|
## 8단계: 구성 다시 생성
|
|
|
|
데이터를 가져온 후 다음을 수동으로 다시 만드세요:
|
|
|
|
### 보기
|
|
|
|
* 필터, 정렬, 열 구성과 함께 저장된 뷰를 다시 만드세요
|
|
* 칸반 또는 캘린더 뷰를 설정하세요
|
|
|
|
### 워크플로우
|
|
|
|
* **설정 → 워크플로우**에서 자동화를 다시 만드세요
|
|
* 사용하기 전에 각 워크플로우를 테스트하세요
|
|
|
|
### 역할 및 권한
|
|
|
|
* **설정 → 역할**에서 역할을 구성하세요
|
|
* 적절한 역할에 사용자를 할당하세요
|
|
|
|
### 통합
|
|
|
|
* 각 사용자의 이메일 및 캘린더 동기화를 다시 연결하세요
|
|
* 새 API 키로 모든 API 통합을 다시 구성하세요
|
|
|
|
## 마이그레이션 후 체크리스트
|
|
|
|
<Check>모든 데이터가 성공적으로 가져와졌음</Check>
|
|
<Check>객체 간 관계가 올바르게 동작함</Check>
|
|
<Check>사용자 할당(Owner, Assignee)이 올바르게 매핑됨</Check>
|
|
<Check>뷰 재생성 완료</Check>
|
|
<Check>워크플로우 재생성 및 테스트 완료</Check>
|
|
<Check>역할 및 권한 구성 완료</Check>
|
|
<Check>이메일/캘린더 동기화 재연결 완료</Check>
|
|
<Check>API 통합이 새 키로 업데이트됨</Check>
|
|
|
|
## FAQ
|
|
|
|
<AccordionGroup>
|
|
<Accordion title="워크플로우를 자동으로 마이그레이션할 수 있나요?">
|
|
현재는 불가능합니다. 워크플로우는 클라우드 인스턴스에서 수동으로 다시 만들어야 합니다.
|
|
</Accordion>
|
|
|
|
<Accordion title="파일 첨부 및 이미지는 어떻게 하나요?">
|
|
파일 첨부는 CSV 내보내기에 포함되지 않습니다. 첨부 파일은 수동으로 다시 업로드하거나 API를 통해 마이그레이션해야 하며, 대규모 마이그레이션의 경우 당사 팀에 연락하여 지원을 받으세요.
|
|
</Accordion>
|
|
|
|
<Accordion title="마이그레이션 중에 두 인스턴스를 모두 실행 상태로 유지할 수 있나요?">
|
|
예. 클라우드 마이그레이션이 완료되었음을 확인할 때까지 자가 호스팅 인스턴스를 실행 상태로 유지하는 것을 권장합니다. 단, 두 곳 모두에서 새 데이터를 생성하지 않도록 주의하세요.
|
|
</Accordion>
|
|
|
|
<Accordion title="사용자가 아직 초대를 수락하지 않았다면 어떻게 하나요?">
|
|
해당 사용자를 참조하는 레코드는 가져오기에 실패하거나 관계가 비어 있게 됩니다. 데이터를 가져오기 전에 모든 사용자가 초대를 수락했는지 확인하세요.
|
|
</Accordion>
|
|
</AccordionGroup>
|
|
|
|
## 도움이 필요하신가요?
|
|
|
|
복잡한 마이그레이션이나 대규모 데이터 세트의 경우 [contact@twenty.com](mailto:contact@twenty.com)으로 문의하시거나 [구현 서비스](/l/ko/user-guide/getting-started/capabilities/implementation-services)를 확인하세요.
|