커넥터 이해

Workflows에서 게시되는 커넥터를 사용하면 워크플로 내에서 다른 Google Cloud 제품에 더 쉽게 액세스할 수 있습니다. 사용 가능한 커넥터에 대한 자세한 내용은 커넥터 참조를 확인하세요.

커넥터를 사용하면 워크플로 내에서 다른 Google Cloud API에 연결할 수 있고 워크플로를 이러한 Google Cloud 제품과 쉽게 통합할 수 있습니다. 예를 들어 커넥터를 사용하여 Pub/Sub 메시지를 게시하거나, Firestore 데이터베이스에 대해 데이터 읽기 또는 쓰기를 수행하거나, Secret Manager에서 인증 키를 검색할 수 있습니다.

커넥터는 Google Cloud API의 세부정보를 알 필요가 없도록 요청의 형식 지정을 처리하여 메서드와 인수를 제공하므로 호출 서비스를 단순화합니다.

커넥터에는 재시도장기 실행 작업 처리를 위한 기본 제공 동작이 설정되어 있습니다.

인증

커넥터는 기본 제공되는 Identity and Access Management 인증을 사용하여 다른 Google Cloud 제품과 상호작용합니다. 커넥터를 사용하는 워크플로가 특정 API에 올바르게 인증되기 위해서는 해당 서비스 계정에 적절한 권한이 할당되어 있어야 합니다. 예를 들어 Pub/Sub에 메시지를 게시하려면 워크플로와 연결된 서비스 계정에 roles/pubsub.publisher 역할을 부여해야 합니다. 다른 Google Cloud 제품 인증에 대해 자세히 알아보려면 워크플로 내에서 인증된 요청 수행을 참조하세요.

재시도

모든 커넥터는 다음과 같은 재시도 정책 및 오류 처리 구성을 적용합니다.

  • Workflows는 GET 요청에 idempotent 재시도 정책을 사용합니다.

  • Workflows는 다른 모든 HTTP 메서드에 비idempotent 재시도 정책을 사용합니다.

  • 기본적으로 요청 제한 시간은 30분입니다. 이는 장기 실행 작업의 경우 장기 실행 작업 내의 개별 요청(예: 작업 시작 또는 상태 확인)에 적용됩니다. 전체 작업의 제한 시간은 connector_params 필드를 사용하여 구성할 수 있습니다. 커넥터 참조를 확인하세요.

장기 실행 작업

장기 실행 작업을 수행하는 호출에는 다음 동작이 적용됩니다.

  • Workflows는 작업이 완료되거나 실패할 때까지 워크플로 실행을 차단합니다.

  • 기본적으로 호출 제한 시간은 30분입니다. connector_params 필드를 사용하여 호출 제한 시간을 변경할 수 있습니다(최대 1년). 커넥터 참조를 확인하세요.

  • 커넥터는 장기 실행 작업을 주기적으로 폴링합니다. 기본적으로 Workflows는 폴링할 때 1.25의 지수 백오프를 사용합니다. 1초부터 시작하여 폴링 간격 사이에 60초까지 느려집니다. 각 폴링 시도는 청구 가능한 단계로 계산됩니다. 폴링 매개변수는 connector_params 필드를 사용하여 변경할 수 있습니다. 커넥터 참조를 확인하세요.

  • 앞의 재시도 메커니즘이 실패한 폴링 시도에 적용됩니다.

  • 장기 실행 작업 중에 오류가 발생하면 Workflows가 OperationError 오류를 일으킵니다. 이 오류에는 작업별 세부정보가 있는 추가 속성 error가 포함됩니다.

장기 실행 작업이 실패하면 커넥터 호출이 다음 속성과 함께 예외를 발생시킵니다.

  • message: 사람이 읽을 수 있는 오류 메시지.
  • tags: 태그 목록입니다. 장기 실행 작업 커넥터 호출의 경우 목록에 OperationError가 포함됩니다.
  • operation: 실패한 장기 실행 작업 객체입니다.

지원되는 장기 실행 작업 유형의 자세한 목록은 커넥터 참조를 확인하세요.