디버깅 개요

다음 정보는 Workflows를 디버깅하고 신뢰할 수 있고 예측 가능하며 최적화된 워크플로를 배포하는 데 도움이 될 수 있습니다.

프로젝트 및 환경
  • 프로덕션 리소스를 보호하려면 각 환경에 별도의 프로젝트(개발 태스크용 프로젝트, 애플리케이션 테스트용 프로젝트, 빌드된 시스템에 개발 내용을 병합할 수 있는 스테이징 프로젝트, 최종 빌드를 제공하는 프로덕션 환경용 프로젝트)를 사용하는 방법이 가장 좋습니다.
  • 별도의 워크플로를 사용하는 방법도 있습니다.
워크플로 만들기
  • Google Cloud 콘솔 편집기나 선호하는 IDE 또는 소스 코드 편집기를 사용하여 워크플로를 작성할 수 있습니다.
  • YAML 파일을 수정하면 오류가 발생할 수 있습니다. 워크플로를 개발할 때 오타 및 기타 일반적인 오류가 줄어들도록 IDE 또는 편집기에서 자동 완성을 설정합니다. Workflows용 Google Cloud 콘솔 편집기는 일부 YAML 및 구문 유효성 검사와 자동 완성 기능을 제공합니다. 그러나 수정되어야 하며 배포 시에만 발생하는 구문 오류가 있을 수 있습니다. YAML 들여쓰기를 참고하세요.
워크플로 배포
  • 테스트를 위해 워크플로를 실행하려면 Google Cloud 프로젝트에서 워크플로를 배포해야 합니다.
워크플로 실행
  • 워크플로를 테스트할 때는 gcloud CLI를 사용하여 또는 Google Cloud 콘솔에서 실행할 수 있습니다.
    • gcloud workflows run을 사용하여 명령줄에서 워크플로를 실행하고 결과를 확인합니다.
    • Google Cloud 콘솔을 사용하여 워크플로를 실행하고 출력 창에서 결과를 확인합니다.
  • Google Cloud 콘솔 또는 gcloud CLI를 사용하여 워크플로 실행 결과에 액세스할 수 있습니다. 명령줄에서 테스트하는 경우 Google Cloud 콘솔의 워크플로 세부정보 페이지에서 로그를 보는 것이 좋습니다.
  • 단계 항목 목록으로 지정된 워크플로 실행 내역을 검색할 수 있습니다. 각 항목은 오류의 출처를 확인하거나 워크플로 성능을 최적화하는 데 도움이 되는 정보를 제공합니다.
  • 기본 제공 환경 변수를 사용하여 워크플로의 환경 정보(예: 위치 또는 프로젝트 식별자)에 액세스할 수 있습니다. 기본 제공 환경 변수는 선언이 필요하지 않으며 모든 워크플로 실행에서 사용할 수 있습니다.
  • 워크플로 실행 중 발생한 오류에는 오류 원인을 파악하는 데 도움이 되는 태그가 포함됩니다.
  • 장기 실행 상태를 확인할 수 있습니다.
  • 각 워크플로 실행마다 실행이 시작될 때와 끝날 때 각각 하나씩 최소 2개의 실행 로그가 자동으로 트리거됩니다. Workflows 또는 Cloud Logging에서 로그를 볼 수 있습니다. 단일 워크플로 로그를 보려면 Workflows에서 로그 탭을 사용합니다. 모든 워크플로의 로그를 집계하여 확인하려면 Cloud Logging의 로그 탐색기 페이지를 사용합니다.
  • Cloud Logging으로 로그를 전송할 수 있습니다.
    • 워크플로 실행 중 각 호출 단계나 예외가 로깅되도록 플래그를 설정할 수 있는 호출 로깅을 사용 설정합니다.
    • 소스에서 sys.log 함수를 사용하는 커스텀 로그를 만듭니다.

다음 단계