샌드박스 만들기 및 프로덕션에 변경 사항 배포

참고: 2026년 4월 30일부로 레거시 표준 샌드박스가 단종됩니다. 해당 날짜 이후에는 더 이상 레거시 표준 샌드박스을 더 이상 사용할 수 없습니다. 앞으로 샌드박스를 생성하려면 샌드박스 생성 및 프로덕션 환경으로 변경 사항 배포. 이러한 전환을 원활하게 진행하기 위해, 기존 레거시 샌드박스를 보유한 사용자를 대상으로 샌드박스 생성 한도가 일시적으로 확대되었습니다. 이 임시 확대 조치로 인해, 연결된 앱을 수동으로 마이그레이션하고 업데이트된 환경에 익숙해지는 동안 기존 레거시 샌드박스를 계속 사용하면서 새로운 표준 샌드박스를 생성할 수 있습니다. 이 변경 사항에 대한 자세한 내용은 HubSpot 커뮤니티에서 자세히 알아보세요.

시작하기 전에

요구 사항 확인

제한 사항 및 고려 사항

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

표준 샌드박스 생성

샌드박스를 생성하려면:

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

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

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

배포를 시작한 슈퍼 관리자는 배포가 완료되면 이메일 알림을 받게 됩니다. 이 이메일에는 배포 상태 상세 정보 페이지로 연결되는 링크가 포함되어 있으며, 해당 페이지에서 성공적으로 배포된 자산과 실패한 자산을 모두 확인할 수 있습니다. 그런 다음 샌드박스 계정과 프로덕션 계정의 자산을 비교하고 필요에 따라 변경할 수 있습니다.

표준 샌드박스 액세스

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

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

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

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

프로덕션 배포 설정

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

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

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

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

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

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

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

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

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

샌드박스 활동 확인

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

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

샌드박스 모범 사례

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

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

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

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