샌드박스를 생성하고 변경 사항을 프로덕션 환경에 배포합니다

참고: a2026년 4월 30일부터 기존 표준 샌드박스는 더 이상 지원되지 않습니다. 원활한 전환을 위해, 기존 샌드박스를 여전히 보유하고 있는 계정에 대해서는 샌드박스 제한이 일시적으로 확대되었습니다. 이를 통해 기존 샌드박스를 삭제할 준비가 될 때까지 계속 사용할 수 있는 동안 새 샌드박스를 생성할 수 있습니다.

시작하기 전에

요구 사항 파악

제한 사항 및 고려 사항

• 기본적으로 모든 슈퍼 관리자, 의 확장된 액세스 권한을 가진 파트너 관리자, 그리고 개발자 도구 액세스 권한을가진 사용자는샌드박스 생성 시 해당 샌드박스로 복사됩니다.
  • 생성 후 프로덕션 계정에 슈퍼 관리자를 추가할 경우, 샌드박스 계정에도 해당 사용자를 수동으로 추가해야 합니다.
  • 생성 후 프로덕션 계정에서 슈퍼 관리자가 제거되면, 해당 사용자는 샌드박스 계정에서도 자동으로 제거됩니다.
• 샌드박스 생성 시 프로덕션 자산 중 어떤 항목이 샌드박스 계정으로 복사되는지 알아보세요.
• 프로덕션 배포 기능에서 지원되는 개체 구성 및 자산에 대해 알아보세요.
• 연락처, 회사, 거래, 티켓 및 사용자 정의 개체의 ID는 샌드박스 계정과 프로덕션 계정 간에 서로 다릅니다. 새로운 사용자 정의 속성(예: 외부 레코드 ID)을 생성하고 자동화를 사용하여 프로덕션 레코드 ID를 이 필드로 복사한 다음, 테스트 목적으로 필요한 경우 샌드박스에서 사용할 수 있습니다.
• 전체 샌드박스 계정의 모든 워크플로우에 대해 하루에 100,000개의 레코드만 등록할 수 있습니다. 최대 한도를 초과하는 추가 워크플로우 등록은 취소됩니다. 한도에 도달하면 계정에서 알림이 표시되며, 다시 동기화할 수 있는 시간도 안내됩니다.
• 특정 자산 유형이 생성 시 표준 샌드박스 계정으로 복사되지 않는 경우, 해당 자산 유형에 의존하는 자산도 동기화되지 않습니다. 예를 들어, 설문조사는 표준 샌드박스 계정으로 복사할 수 없으므로, 설문조사를 트리거나 액션으로 사용하는 모든 워크플로는 복사되지 않습니다. 
• 프로덕션 계정의 연동 기능은 표준 샌드박스 계정에 자동으로 연결되지 않습니다. 샌드박스 계정에 연결하려는 기존 연동 기능이 있는 경우, CRM 데이터에 차질이 발생하지 않도록 해당 연동 기능의 샌드박스 버전에 연결할 것을 HubSpot에서 권장합니다.
• 표준 샌드박스 계정에서 기존 샌드박스 사용자와 동일한 이메일 주소를 가진 연락처 레코드로 일대일 테스트 이메일 및 마케팅 이메일을보낼 수 있습니다.
  
  • 샌드박스 사용자가 아닌 연락처에게 이메일을 보내면, 해당 연락처는 표준 샌드박스 계정의 사용자가 아니므로 이메일이 발송되지 않습니다.
  • 표준 샌드박스 계정에서 발송된 이메일은 프로덕션 계정이 사용하는 공유 IP 주소를 통해 라우팅됩니다.

표준 샌드박스 생성

샌드박스를 생성하려면:

1. HubSpot 계정의 상단 탐색 모음에서 설정 아이콘을 클릭합니다.
2. 왼쪽 사이드바 메뉴에서 ‘샌드박스’를 선택합니다.
3. '샌드박스 생성'을 클릭합니다.
   
   
   
4. 오른쪽 패널의 '샌드박스 이름' 아래에 샌드박스 이름을 입력합니다.
   • 샌드박스는 프로덕션 계정을 그대로 반영해야 하므로 '프로덕션 자산 복사' 확인란이 기본적으로 선택되어 있습니다. downIcon 아이콘을 클릭하여 샌드박스로 복사될 자산 목록을 확인하세요.
   • '이 샌드박스의 용도는 무엇입니까? ' 드롭다운 메뉴를 클릭하고옵션을 선택합니다. 옵션을 제거하려면 옵션 옆의 X를 클릭합니다.
   •   '5,000개의 연락처 및 관련 레코드 복사' 확인란을 선택하면 가장 최근에 업데이트된 5,000개의 연락처와, 해당 연락처당 최대 100개의 관련 거래, 회사 및 티켓이 복사됩니다.

참고: 표준 샌드박스를 생성할 때 5,000개의 연락처 및 관련 레코드를 복사할 수 있습니다. 샌드박스 생성 시 레코드를 복사하지 않은 경우, 나중에 테스트용 레코드를 내보내서 샌드박스로가져올 수 있습니다. 다음 개체(연락처, 회사, 거래, 티켓, 사용자 정의 개체, 장바구니, 청구서, 마케팅 이벤트, 주문)에 대해서는 레코드 유형별로 최대 200,000개의 레코드를 수동으로 가져올 수 있습니다. 나머지 레코드 유형의 경우, CRM 데이터 사용량을 추적하는 방법을 확인하십시오.

6. '표준 샌드박스 생성'을 클릭하십시오.
7. 샌드박스 생성 과정은 프로덕션 계정에서 복사해야 하는 자산, 프로덕션 플랜 기능, 슈퍼 관리자 ( ) ,향상된 액세스 권한을 가진 파트너 관리자, 개발자 도구 액세스 권한 을 가진 사용자의 수에 따라 몇 시간이 소요될 수 있습니다. 샌드박스 계정에서 권한이 어떻게 처리되는지 알아보세요.
8. 상태는 ‘생성일’ 열에서 확인할 수 있습니다. 생성이 완료되면 상태가 생성 날짜 및 시간으로 업데이트됩니다.
9. 실패한 자산을 확인하려면 ‘활동 로그’ 탭을 클릭하십시오. 그런 다음 샌드박스 옆의 상태를 클릭하여 생성 세부 정보를 확인하십시오. 
   • '실패한 자산' 탭을 클릭하면 실패한 자산과 오류 세부 정보를 확인할 수 있습니다.
   • '복사된 자산' 탭을 클릭하면 생성된 자산 목록을 확인할 수 있습니다.

표준 샌드박스 이용하기

샌드박스 생성 시 복사된 모든 슈퍼 관리자는 메인 계정 메뉴에서 샌드박스에 액세스할 수 있습니다.

1. HubSpot 계정에서 오른쪽 상단의 계정 이름을 클릭하세요. 
2. 계정 이름 위에 마우스를 올리면 최근 사용한 계정 목록이 표시됩니다. 
3. 드롭다운 메뉴에서 접속하려는 샌드박스 이름을 클릭하세요.
   
   
   
4. 창 상단에 배너가 표시되어 현재 표준 샌드박스 계정에 접속 중임을 알 수 있습니다.

 슈퍼 관리자는 계정 설정에서도 샌드박스에 액세스할 수 있습니다:

1. HubSpot 계정의 상단 탐색 모음에서 설정 아이콘을 클릭합니다.
2. 왼쪽 사이드바 메뉴에서 ‘샌드박스’를 선택하세요.
3. 접속하려는 샌드박스 이름을 클릭하세요. 
4. 샌드박스 계정에서 나가려면 오른쪽 상단에서 프로덕션 계정 이름을 클릭하세요.

프로덕션 배포 설정

샌드박스에서 변경 사항을 적용한 후, 지원되는 자산을 프로덕션 계정에 배포할 수 있습니다. 프로덕션 배포를설정하려면 프로덕션 계정으로 이동한 다음 다음 단계를 따르세요:

1. HubSpot 계정의 상단 탐색 모음에서 설정 아이콘을 클릭합니다.
2. 왼쪽 사이드바 메뉴에서 '샌드박스'를 선택합니다.
3. 오른쪽 상단에서 '배포 설정'을 클릭합니다.
   • '지원되는 자산 유형' 열에서 배포할 자산을 선택합니다. 오브젝트를 배포하는 경우, 자산 옆에 있는 '구성 선택'을 클릭합니다.
   • 각 자산별로 배포 가능한 항목을 확인하려면 상단 배너에서 [X] 배포 동작 보기를 클릭하세요. 오른쪽 패널에서 정보를 확인한 후 닫기를 클릭하세요.
     
     
     
4. 배포 가능한 각 변경 사항 옆의 확인란을 선택하십시오. 오브젝트를 배포하는 경우, 이 항목은 오른쪽 패널에 표시되며 ‘선택 사항 저장’을 클릭해야 합니다.

참고:한 번에 최대 300개의 변경 사항을 배포할 수있습니다. 

7. '다음'을 클릭하십시오. 
8. 모든 연결 정보는 ‘연결된 자산’ 단계에 표시됩니다. 연결된 자산이란 선택한 자산에서 사용되며 배포에 필요한 다른 자산을 말합니다.
   
   • '이름' 열에서 '개체 구성 보기'를클릭하면 연결을 기반으로 배포될 내용을 확인할 수 있습니다.
   • '사용처' 열의 'x개의 선택된 자산'을 클릭하여 연결을 확인하십시오.

   • 구성을 배포에 포함하려면 [ 내 배포에 x개 연결 추가 ] 확인란을 선택한 다음 [ 다음]을 클릭하십시오.

9.  충돌 사항이 있으면 자동으로 감지됩니다. 오류를 검토하고 충돌을 해결한 후 배포를 진행하십시오. 충돌이 감지되지 않으면 ‘다음’을 클릭하십시오.
10. '배포 이름' 필드에 배포 이름을 입력합니다. '설명' 필드에 설명을 입력합니다. '다음'을 클릭합니다.
11. 프로덕션 배포 내용을 검토하십시오. 준비가 되면 [ 프로덕션에 배포]를 클릭하십시오.
12. 표시되는 대화 상자에서 ‘프로덕션에 배포’를 클릭하여 확인하십시오.

13. 배포가 시작되면 프로덕션 활동 로그 탭의 '상태 ' 열에 '진행 중'이 표시됩니다. 배포가 시작되면 취소할 수 없습니다.
14. 배포가 완료되면 상태가 [#]개 자산 배포됨으로 업데이트됩니다.

• 참고: 배포에 실패한 경우, 배포 오류 로그를 검토하여 실패 원인을 확인하십시오. 추가 지원이 필요하면지원팀에 문의하십시오.

15. 배포 이름 또는 [#] 배포된 자산 를 클릭하여 배포 세부 정보를 확인하십시오.

샌드박스 활동 확인

계정에서 사용자가 수행한 샌드박스 작업 내역을 확인하려면:

1. HubSpot 계정의 상단 탐색 모음에서 설정 아이콘을 클릭합니다.
2. 왼쪽 사이드바 메뉴에서'샌드박스'로 이동합니다.
3. '활동 로그 ' 탭을 클릭합니다.
4. 다음과 같은 샌드박스 관련 활동의 전체 목록이 표시됩니다.
   • 샌드박스 생성 세부 정보(예: 복사된 자산 및 오류 사유)
   • 과거 프로덕션 배포 내역
   • 샌드박스 삭제 내역
5. '로그 유형' 드롭다운 메뉴를 클릭하여 다양한 활동 유형별로 필터링할 수 있습니다.

샌드박스 모범 사례

샌드박스를 사용하면 사용자가 프로덕션 계정 외부에서 안전하게 혁신을 시도할 수 있습니다. 샌드박스에서 신뢰할 수 있는 테스트를 보장하기 위해 개발 전략을 수립하고 다음 사항을 고려하는 것이 좋습니다:

• 샌드박스의 목적은 무엇입니까? (예: 활발한 개발, 통합 테스트, 교육).
• 누가 액세스 권한이 필요한가요? (예: 테스트 신뢰성에 영향을 미칠 수 있는 충돌을 제한하는 것을 고려하세요).
• 다양한 사용 사례를 지원하기 위해 더 많은 샌드박스가 필요한가?
• 개발 요구 사항을 지원하기 위해 샌드박스를 생성하고 관리하는 최선의 방법은 무엇인가요?

이러한 측면을 명확히 정의하면 다른 사용 사례를 수용하면서도 신뢰할 수 있는 테스트와 지원 자산의 프로덕션 배포에 도움이 됩니다.

다음은 신뢰할 수 있는 테스트 및 개발을 보장하기 위한 샌드박스의 다양한 목적, 접근 권한을 부여해야 할 사용자, 생성 전략의 예시입니다: