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

시작하기 전에

요구 사항 이해하기

제한 사항 및 고려 사항

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

표준 샌드박스 생성

샌드박스를 생성하려면:

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

참고: 표준 샌드박스 생성 시 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. 샌드박스에 마우스를 올린 후 '작업(Actions)' > ' ' > '배포 설정(Set up a deploy)'을 선택합니다.
   • 지원되는 자산 유형 열에서 배포할 자산을 선택하세요. 객체를 배포하는 경우 자산 옆에 있는 구성 선택을 클릭하세요.
   • 각 자산별로 배포 가능한 항목을 확인하려면 상단 배너에서 [X]개 배포 동작 보기 를 클릭하세요. 오른쪽 패널에서 정보를 검토한 후 닫기 를 클릭하세요.
     
     
4. 배포 가능한 각 변경 사항 옆의 확인란을 선택합니다. 개체를 배포하는 경우 이 작업은 오른쪽 패널에서 수행되며, 선택 사항 저장을 클릭해야 합니다.

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

7. [ 다음]을 클릭하세요. 
8. 모든 연결은 '연결된 자산' 단계에 표시됩니다. 연결된 자산은 선택한 자산이 사용하는 다른 자산으로, 배포에 필요한 자산입니다.
   
   • 연결을 기반으로 배포될 내용을 보려면 이름 열에서 개체 구성 보기를클릭하십시오.
   • 사용됨 열에서 x개의 선택된 자산을 클릭하면 연결을 볼 수 있습니다.

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

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

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

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

15. 배포 이름 또는 [#]변경 사항 배포됨을 클릭하면 배포 세부 정보를 확인할 수 있습니다.

샌드박스 모범 사례

샌드박스를 사용하면 프로덕션 계정 외부에서 안전하게 혁신을 시도할 수 있습니다. 개발 전략을 수립하고 다음 사항을 고려하여 샌드박스에서 안정적인 테스트를 수행할 것을 권장합니다:

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

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

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