플레이북 시뮬레이터로 작업하기
플레이북 시뮬레이터는 시간과 노력을 줄여 플레이북을 개발하는 간소화된 방법을 제공합니다.
플레이북 시뮬레이터는 다음과 같은 여러 주요 기능을 제공합니다.
- 사전 프로덕션 환경에서 작업하여 라이브 프로덕션 데이터에 영향을 주지 않고 작업과 결과를 테스트하고 관찰할 수 있습니다 (특히 플레이북이 비활성화된 경우).
- 각 플레이북 단계 또는 블록의 테스트를 용이하게 하여 워크플로가 의도한 대로 작동하는지 확인합니다.
- 플레이북 내에서 가능한 모든 조건 분기를 테스트하여 포괄적인 적용 범위와 예측 가능한 동작을 확인합니다.
플레이북과 함께 플레이북 시뮬레이터 사용
기존 플레이북을 사용하든 새 플레이북을 만들든 항상 플레이북 시뮬레이터를 사용 설정하여 시작하세요. 상단에 활성 상태임을 나타내는 녹색 표시기가 표시됩니다.
활성 플레이북에서 플레이북 시뮬레이터를 사용하면 해당 플레이북을 트리거하는 모든 수신 알림에 영향을 미칩니다. 시뮬레이션 데이터가 포함된 플레이북을 저장하면 프로덕션의 실제 케이스에 해당 데이터가 적용되어 실제 결과에 영향을 미칠 수 있기 때문입니다.
- 케이스 알림 위로 포인터를 가져가 more_vert 알림 옵션을 클릭하고 테스트 사례로 알림 인그레스를 선택합니다. 이 작업은 시뮬레이션된 플레이북을 실행할 테스트 케이스를 만듭니다. 테스트 사례 내에서 수정된 항목은 일반 사례의 항목에 영향을 미치지 않습니다.
- 플레이북 페이지 하단으로 포인터를 가져가 테스트 사례를 선택합니다. 선택한 테스트 사례가 실행하려는 플레이북과 일치하는지 확인합니다. 확인하려면 엔티티를 클릭하고 플레이북이 해당 테스트 사례 내에 있는 엔티티를 처리할 수 있는지 확인합니다.
- 실행을 클릭합니다. 시뮬레이터는 단계를 처리하고 정의된 작업을 실행하며 결과를 제공합니다.
각 단계의 시뮬레이터 결과 해석
실행을 클릭하면 콘솔의 첫 번째 행이 라이브 플레이북인 것처럼 표시됩니다. 각 시뮬레이션 단계에는 일반적으로 케이스 데이터, 결과 보기, 결과 고정(또는 결과 삽입)을 포함한 옵션이 표시됩니다. 수동 단계에서는 매개변수를 입력하고, 응답을 제공하고, 단계를 실행하는 버튼을 표시합니다.
케이스 데이터
케이스 데이터 아이콘을 클릭하면 현재 작업이 완료된 후 해당 특정 단계의 케이스 정보를 표시하는 대화상자가 열립니다. 이 대화상자는 현재 단계의 결과로 동적으로 업데이트됩니다. 작업에서 케이스에 추가 정보를 추가한 경우 여기에 반영됩니다. 단계 실행 후 케이스의 상태를 표시하므로 시뮬레이션 콘솔의 각 단계마다 데이터가 다릅니다. 여러 단계에서 케이스 데이터를 검사하면 플레이북 실행 중에 케이스에 적용된 변경사항을 파악할 수 있습니다. 대화상자 내의 여러 탭에서 추가 세부정보를 확인할 수 있습니다.
결과 보기
결과 보기 옵션은 현재 단계의 구체적인 작업 결과를 표시합니다. 표시되는 정보는 케이스 개요 또는 케이스 월과 유사하며, 모든 보강에 관한 세부정보도 포함됩니다.
다음과 같은 정보에 액세스할 수 있습니다.
- 기본 탭에는 출력 메시지, 표, 링크, 첨부파일이 표시됩니다.
- 기술 세부정보 탭에는 작업 결과와 JSON 결과 (있는 경우)가 표시됩니다.
다른 옵션과 마찬가지로 데이터를 클릭하여 자세히 검사할 수 있습니다. 결과 보기 페이지에서 JSON 결과 설정을 클릭할 수도 있습니다. 이 기능을 사용하면 현재 작업의 JSON 샘플을 바꿀 수 있습니다. 통합 개발 환경 (IDE)에서 이 JSON 샘플을 직접 수정하고 표현식 빌더 내에서 이를 기반으로 JSON 결과에서 특정 데이터를 추출할 수 있습니다.
결과 고정
결과 고정 옵션은 단계가 성공적으로 실행될 때 사용할 수 있습니다. 작업의 결과를 고정된 것으로 취급할 수 있는 매우 유용한 기능입니다.
결과를 고정하면 다음과 같은 방법으로 시간을 절약할 수 있습니다.
- 서드 파티 서비스의 결과를 기다릴 필요가 없습니다.
- 이러한 서비스에 대한 쿼리 수를 줄여 사용자 인증 정보를 보존할 수 있습니다.
기본적으로 플레이북을 다시 실행하면 고정된 결과가 있는 단계는 '건너뛰기'됩니다. 코드가 다시 실행되지 않고 고정된 결과가 그대로 사용됩니다. 자체 모의 데이터를 삽입하여 이 결과를 수정할 수도 있습니다. 결과 고정을 사용 설정하면 작업이 시뮬레이션 모드로 전환되고 단계의 시각적 표현이 일반적으로 파란색에서 회색 배경으로 변경되어 해당 단계에 시뮬레이션 모드가 활성화되어 있음을 명확하게 나타냅니다.
결과 삽입
단계가 실패하면 결과 삽입 옵션을 사용할 수 있습니다. 이 기능을 사용하면 시뮬레이션 데이터를 수동으로 삽입할 수 있습니다. 다음에 이 특정 단계를 실행하면 수동으로 제공한 데이터가 결과로 반환됩니다.
이 옵션을 클릭하면 작업에 시뮬레이션 모드가 자동으로 사용 설정됩니다. 단계의 시각적 표현이 파란색에서 회색 배경으로 변경되어 시뮬레이션 모드가 활성화되었음을 명확하게 나타냅니다. 시뮬레이션 모드에서는 모든 단계에 스크립트 결과 필드가 필요합니다.
모의 데이터 삽입
모의 데이터를 삽입할 때는 몇 가지 사용 사례를 고려해야 합니다.
- 이동 중에 플레이북 빌드 및 테스트: 단계를 실행하고 결과를 확인한 후 플레이북에서 해당 데이터를 어떻게 더 사용할 수 있는지 즉시 파악할 수 있습니다.
- 성공적인 실행 후 시간 절약: 단계의 결과를 고정하는 것이 좋습니다. 이렇게 하면 후속 테스트 중에 서드 파티 API에 대해 이 단계가 반복적으로 실행되지 않아 시간을 절약할 수 있습니다.
- 다양한 시나리오 테스트: 단계 결과를 변경하여 다양한 조건에서 플레이북을 테스트할 수 있습니다. 다양한 시뮬레이션 데이터를 설정하면 이전 결과를 기반으로 하는 후속 조건과 작업에 영향을 줄 수 있습니다. 예를 들어 플레이북에 두 개 이상의 경로로 분기되는 조건이 있는 경우 시뮬레이션 데이터를 사용하여 플레이북이 특정 분기를 따르도록 '강제'할 수 있습니다.
시뮬레이션 데이터 삽입
플레이북 단계 구성 대화상자를 통해 또는 시뮬레이터 실행 후 결과 고정 (또는 결과 삽입)을 사용하여 두 가지 주요 방법으로 시뮬레이션 (모의) 데이터를 플레이북에 삽입할 수 있습니다.
플레이북 단계 구성 대화상자 사용
- 플레이북 내에서 단계 구성 대화상자를 클릭합니다.
- 시뮬레이션 모드를 전환하여 사용 설정합니다. 작업의 시각적 표현이 회색으로 변경되어 시뮬레이션 모드에 있음을 나타냅니다.
- 작업 결과 섹션에서 시뮬레이션 (모의) 데이터를 삽입할 수 있습니다. 여기에는 다음이 포함됩니다.
- 스크립트 결과: 스크립트 기반 작업의 모의 결과를 제공합니다.
- JSON 결과: JSON 코드에서 특정 데이터를 추출하여 JSON 데이터를 입력합니다. 샘플 로드를 클릭하여 샘플 출력을 로드할 수도 있습니다. 이렇게 하면 작업의 예상 JSON 결과가 로드되며, 이는 다음과 같은 경우에 특히 유용합니다.
- 시뮬레이션이 아직 실행되지 않았으며 출력이 비어 있습니다.
- 시뮬레이션에 실패하여 결과가 표시되지 않습니다.
- 샘플로 기존 결과 (이전 고정 또는 삽입에서)를 재정의하려고 합니다.
- 강화: 이전 시뮬레이션 실행의 강화를 사용하거나 맞춤 강화 키를 만들 수 있습니다.
시뮬레이터 실행 후 결과 사용
결과 고정
단계가 성공적으로 실행되면 작업 옆에 있는 결과 고정을 클릭합니다. 다음과 같은 작업이 완료된 후
- 이 단계는 시뮬레이션 모드로 자동 실행됩니다. .
- 최근에 성공한 시뮬레이션 실행의 결과가 단계에 고정됩니다. 이 결과를 사용하거나 수정할 수 있습니다.
- JSON 편집기를 사용하여 JSON 결과를 수정하거나 샘플 로드를 클릭하여 재정의할 수 있습니다.
- 이전 시뮬레이션 실행의 보강을 사용하거나 맞춤 보강 키를 만들 수 있습니다.
결과 삽입
단계가 실패한 경우 해당 작업 옆에 있는 결과 삽입을 클릭하면 됩니다. 다음과 같은 작업이 완료된 후
- 이제 이 데이터는 단계가 실행될 때마다 반환됩니다.
플레이북 시뮬레이터 사용 중지
플레이북 시뮬레이터를 사용 중지하면 하단 콘솔이 숨겨지고 시뮬레이션 모드의 모든 단계가 일반 '라이브' 모드로 되돌아갑니다. 플레이북 블록은 예외입니다. 블록 시뮬레이터를 사용 중지해야 시뮬레이션 모드를 닫을 수 있습니다. 삽입된 시뮬레이션 (모의) 데이터는 다음에 시뮬레이터를 켤 때 사용할 수 있도록 저장됩니다.
플레이북 블록 작업
플레이북 시뮬레이터를 사용하여 새 플레이북 블록을 빌드하고 테스트할 수도 있습니다. 블록이 시뮬레이션 모드에 있으면 이 블록을 사용하는 모든 상위 플레이북도 블록의 모의 데이터를 사용합니다.
도움이 더 필요하신가요? 커뮤니티 회원 및 Google SecOps 전문가로부터 답변을 받으세요.